Doxygen janitor
[samba.git] / source3 / lib / util_unistr.c
1 /* 
2    Unix SMB/CIFS implementation.
3    Samba utility functions
4    Copyright (C) Andrew Tridgell 1992-2001
5    Copyright (C) Simo Sorce 2001
6    
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 2 of the License, or
10    (at your option) any later version.
11    
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16    
17    You should have received a copy of the GNU General Public License
18    along with this program; if not, write to the Free Software
19    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21
22 #include "includes.h"
23
24 #ifndef MAXUNI
25 #define MAXUNI 1024
26 #endif
27
28 /* these 3 tables define the unicode case handling.  They are loaded
29    at startup either via mmap() or read() from the lib directory */
30 static smb_ucs2_t *upcase_table;
31 static smb_ucs2_t *lowcase_table;
32 static uint8 *valid_table;
33
34
35 /*******************************************************************
36 load the case handling tables
37 ********************************************************************/
38 void load_case_tables(void)
39 {
40         static int initialised;
41         int i;
42
43         if (initialised) return;
44         initialised = 1;
45
46         upcase_table = map_file(lib_path("upcase.dat"), 0x20000);
47         lowcase_table = map_file(lib_path("lowcase.dat"), 0x20000);
48
49         /* we would like Samba to limp along even if these tables are
50            not available */
51         if (!upcase_table) {
52                 DEBUG(1,("creating lame upcase table\n"));
53                 upcase_table = malloc(0x20000);
54                 for (i=0;i<0x10000;i++) {
55                         smb_ucs2_t v;
56                         SSVAL(&v, 0, i);
57                         upcase_table[v] = i;
58                 }
59                 for (i=0;i<256;i++) {
60                         smb_ucs2_t v;
61                         SSVAL(&v, 0, UCS2_CHAR(i));
62                         upcase_table[v] = UCS2_CHAR(islower(i)?toupper(i):i);
63                 }
64         }
65
66         if (!lowcase_table) {
67                 DEBUG(1,("creating lame lowcase table\n"));
68                 lowcase_table = malloc(0x20000);
69                 for (i=0;i<0x10000;i++) {
70                         smb_ucs2_t v;
71                         SSVAL(&v, 0, i);
72                         lowcase_table[v] = i;
73                 }
74                 for (i=0;i<256;i++) {
75                         smb_ucs2_t v;
76                         SSVAL(&v, 0, UCS2_CHAR(i));
77                         lowcase_table[v] = UCS2_CHAR(isupper(i)?tolower(i):i);
78                 }
79         }
80 }
81
82 /*
83   see if a ucs2 character can be mapped correctly to a dos character
84   and mapped back to the same character in ucs2
85 */
86 static int check_dos_char(smb_ucs2_t c)
87 {
88         char buf[10];
89         smb_ucs2_t c2 = 0;
90         int len1, len2;
91         len1 = convert_string(CH_UCS2, CH_DOS, &c, 2, buf, sizeof(buf));
92         if (len1 == 0) return 0;
93         len2 = convert_string(CH_DOS, CH_UCS2, buf, len1, &c2, 2);
94         if (len2 != 2) return 0;
95         return (c == c2);
96 }
97
98 /**
99  * Load the valid character map table from <tt>valid.dat</tt> or
100  * create from the configured codepage.
101  *
102  * This function is called whenever the configuration is reloaded.
103  * However, the valid character table is not changed if it's loaded
104  * from a file, because we can't unmap files.
105  **/
106 void init_valid_table(void)
107 {
108         static int initialised;
109         static int mapped_file;
110         int i;
111         const char *allowed = ".!#$%&'()_-@^`~";
112
113         if (initialised && mapped_file) return;
114         initialised = 1;
115
116         valid_table = map_file(lib_path("valid.dat"), 0x10000);
117         if (valid_table) {
118                 mapped_file = 1;
119                 return;
120         }
121
122         /* Otherwise, using a dynamically loaded one. */
123         if (valid_table) free(valid_table);
124
125         DEBUG(2,("creating default valid table\n"));
126         valid_table = malloc(0x10000);
127         for (i=0;i<128;i++) valid_table[i] = isalnum(i) || 
128                                     strchr(allowed,i);
129         for (;i<0x10000;i++) {
130                 smb_ucs2_t c;
131                 SSVAL(&c, 0, i);
132                 valid_table[i] = check_dos_char(c);
133         }
134 }
135
136
137
138 /*******************************************************************
139  Write a string in (little-endian) unicode format. src is in
140  the current DOS codepage. len is the length in bytes of the
141  string pointed to by dst.
142
143  if null_terminate is True then null terminate the packet (adds 2 bytes)
144
145  the return value is the length in bytes consumed by the string, including the
146  null termination if applied
147 ********************************************************************/
148
149 size_t dos_PutUniCode(char *dst,const char *src, ssize_t len, BOOL null_terminate)
150 {
151         return push_ucs2(NULL, dst, src, len, 
152                          STR_UNICODE|STR_NOALIGN | (null_terminate?STR_TERMINATE:0));
153 }
154
155
156 /*******************************************************************
157  Skip past a unicode string, but not more than len. Always move
158  past a terminating zero if found.
159 ********************************************************************/
160
161 char *skip_unibuf(char *src, size_t len)
162 {
163     char *srcend = src + len;
164
165     while (src < srcend && SVAL(src,0))
166         src += 2;
167
168     if(!SVAL(src,0))
169         src += 2;
170
171     return src;
172 }
173
174 /* Copy a string from little-endian or big-endian unicode source (depending
175  * on flags) to internal samba format destination
176  */ 
177 int rpcstr_pull(char* dest, void *src, int dest_len, int src_len, int flags)
178 {
179         if (!src) return 0;
180         if(dest_len==-1) dest_len=MAXUNI-3;
181         return pull_ucs2(NULL, dest, src, dest_len, src_len, flags|STR_UNICODE|STR_NOALIGN);
182 }
183
184 /* Copy a string from a unistr2 source to internal samba format
185    destination.  Use this instead of direct calls to rpcstr_pull() to avoid
186    having to determine whether the source string is null terminated. */
187
188 int rpcstr_pull_unistr2_fstring(char *dest, UNISTR2 *src)
189 {
190         return pull_ucs2(NULL, dest, src->buffer, sizeof(fstring),
191                          src->uni_str_len * 2, 0);
192 }
193
194 /* Converts a string from internal samba format to unicode
195  */ 
196 int rpcstr_push(void* dest, const char *src, int dest_len, int flags)
197 {
198         return push_ucs2(NULL, dest, src, dest_len, flags|STR_UNICODE|STR_NOALIGN);
199 }
200
201 /*******************************************************************
202  Return a DOS codepage version of a little-endian unicode string.
203  len is the filename length (ignoring any terminating zero) in uin16
204  units. Always null terminates.
205  Hack alert: uses fixed buffer(s).
206 ********************************************************************/
207 char *dos_unistrn2(const uint16 *src, int len)
208 {
209         static char lbufs[8][MAXUNI];
210         static int nexti;
211         char *lbuf = lbufs[nexti];
212         nexti = (nexti+1)%8;
213         pull_ucs2(NULL, lbuf, src, MAXUNI-3, len*2, STR_NOALIGN);
214         return lbuf;
215 }
216
217 /*******************************************************************
218  Convert a (little-endian) UNISTR2 structure to an ASCII string
219 ********************************************************************/
220 void unistr2_to_ascii(char *dest, const UNISTR2 *str, size_t maxlen)
221 {
222         if (str == NULL) {
223                 *dest='\0';
224                 return;
225         }
226         pull_ucs2(NULL, dest, str->buffer, maxlen, str->uni_str_len*2, STR_NOALIGN);
227 }
228
229 /*******************************************************************
230 give a static string for displaying a UNISTR2
231 ********************************************************************/
232 const char *unistr2_static(const UNISTR2 *str)
233 {
234         static pstring ret;
235         unistr2_to_ascii(ret, str, sizeof(ret));
236         return ret;
237 }
238
239
240 /*******************************************************************
241  duplicate a UNISTR2 string into a null terminated char*
242  using a talloc context
243 ********************************************************************/
244 char *unistr2_tdup(TALLOC_CTX *ctx, const UNISTR2 *str)
245 {
246         char *s;
247         int maxlen = (str->uni_str_len+1)*4;
248         if (!str->buffer) return NULL;
249         s = (char *)talloc(ctx, maxlen); /* convervative */
250         if (!s) return NULL;
251         pull_ucs2(NULL, s, str->buffer, maxlen, str->uni_str_len*2, 
252                   STR_NOALIGN);
253         return s;
254 }
255
256
257 /*******************************************************************
258 Return a number stored in a buffer
259 ********************************************************************/
260
261 uint32 buffer2_to_uint32(BUFFER2 *str)
262 {
263         if (str->buf_len == 4)
264                 return IVAL(str->buffer, 0);
265         else
266                 return 0;
267 }
268
269 /*******************************************************************
270  Convert a wchar to upper case.
271 ********************************************************************/
272
273 smb_ucs2_t toupper_w(smb_ucs2_t val)
274 {
275         return upcase_table[SVAL(&val,0)];
276 }
277
278 /*******************************************************************
279  Convert a wchar to lower case.
280 ********************************************************************/
281
282 smb_ucs2_t tolower_w( smb_ucs2_t val )
283 {
284         return lowcase_table[SVAL(&val,0)];
285
286 }
287
288 /*******************************************************************
289 determine if a character is lowercase
290 ********************************************************************/
291 BOOL islower_w(smb_ucs2_t c)
292 {
293         return upcase_table[SVAL(&c,0)] != c;
294 }
295
296 /*******************************************************************
297 determine if a character is uppercase
298 ********************************************************************/
299 BOOL isupper_w(smb_ucs2_t c)
300 {
301         return lowcase_table[SVAL(&c,0)] != c;
302 }
303
304
305 /*******************************************************************
306 determine if a character is valid in a 8.3 name
307 ********************************************************************/
308 BOOL isvalid83_w(smb_ucs2_t c)
309 {
310         return valid_table[SVAL(&c,0)] != 0;
311 }
312
313 /*******************************************************************
314  Count the number of characters in a smb_ucs2_t string.
315 ********************************************************************/
316 size_t strlen_w(const smb_ucs2_t *src)
317 {
318         size_t len;
319
320         for(len = 0; *src++; len++) ;
321
322         return len;
323 }
324
325 /*******************************************************************
326  Count up to max number of characters in a smb_ucs2_t string.
327 ********************************************************************/
328 size_t strnlen_w(const smb_ucs2_t *src, size_t max)
329 {
330         size_t len;
331
332         for(len = 0; *src++ && (len < max); len++) ;
333
334         return len;
335 }
336
337 /*******************************************************************
338 wide strchr()
339 ********************************************************************/
340 smb_ucs2_t *strchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
341 {
342         while (*s != 0) {
343                 if (c == *s) return (smb_ucs2_t *)s;
344                 s++;
345         }
346         if (c == *s) return (smb_ucs2_t *)s;
347
348         return NULL;
349 }
350
351 smb_ucs2_t *strchr_wa(const smb_ucs2_t *s, char c)
352 {
353         return strchr_w(s, UCS2_CHAR(c));
354 }
355
356 smb_ucs2_t *strrchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
357 {
358         const smb_ucs2_t *p = s;
359         int len = strlen_w(s);
360         if (len == 0) return NULL;
361         p += (len - 1);
362         do {
363                 if (c == *p) return (smb_ucs2_t *)p;
364         } while (p-- != s);
365         return NULL;
366 }
367
368 /*******************************************************************
369 wide strstr()
370 ********************************************************************/
371 smb_ucs2_t *strstr_w(const smb_ucs2_t *s, const smb_ucs2_t *ins)
372 {
373         smb_ucs2_t *r;
374         size_t slen, inslen;
375
376         if (!s || !*s || !ins || !*ins) return NULL;
377         slen = strlen_w(s);
378         inslen = strlen_w(ins);
379         r = (smb_ucs2_t *)s;
380         while ((r = strchr_w(r, *ins))) {
381                 if (strncmp_w(r, ins, inslen) == 0) return r;
382                 r++;
383         }
384         return NULL;
385 }
386
387 /*******************************************************************
388  Convert a string to lower case.
389  return True if any char is converted
390 ********************************************************************/
391 BOOL strlower_w(smb_ucs2_t *s)
392 {
393         BOOL ret = False;
394         while (*s) {
395                 smb_ucs2_t v = tolower_w(*s);
396                 if (v != *s) {
397                         *s = v;
398                         ret = True;
399                 }
400                 s++;
401         }
402         return ret;
403 }
404
405 /*******************************************************************
406  Convert a string to upper case.
407  return True if any char is converted
408 ********************************************************************/
409 BOOL strupper_w(smb_ucs2_t *s)
410 {
411         BOOL ret = False;
412         while (*s) {
413                 smb_ucs2_t v = toupper_w(*s);
414                 if (v != *s) {
415                         *s = v;
416                         ret = True;
417                 }
418                 s++;
419         }
420         return ret;
421 }
422
423 /*******************************************************************
424   convert a string to "normal" form
425 ********************************************************************/
426 void strnorm_w(smb_ucs2_t *s)
427 {
428   extern int case_default;
429   if (case_default == CASE_UPPER)
430     strupper_w(s);
431   else
432     strlower_w(s);
433 }
434
435 int strcmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
436 {
437         while (*b && *a == *b) { a++; b++; }
438         return (*a - *b);
439         /* warning: if *a != *b and both are not 0 we retrun a random
440                 greater or lesser than 0 number not realted to which
441                 string is longer */
442 }
443
444 int strncmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b, size_t len)
445 {
446         size_t n = 0;
447         while ((n < len) && *b && *a == *b) { a++; b++; n++;}
448         return (len - n)?(*a - *b):0;   
449 }
450
451 /*******************************************************************
452 case insensitive string comparison
453 ********************************************************************/
454 int strcasecmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
455 {
456         while (*b && toupper_w(*a) == toupper_w(*b)) { a++; b++; }
457         return (tolower_w(*a) - tolower_w(*b));
458 }
459
460 /*******************************************************************
461 case insensitive string comparison, lenght limited
462 ********************************************************************/
463 int strncasecmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b, size_t len)
464 {
465         size_t n = 0;
466         while ((n < len) && *b && (toupper_w(*a) == toupper_w(*b))) { a++; b++; n++; }
467         return (len - n)?(tolower_w(*a) - tolower_w(*b)):0;
468 }
469
470 /*******************************************************************
471   compare 2 strings 
472 ********************************************************************/
473 BOOL strequal_w(const smb_ucs2_t *s1, const smb_ucs2_t *s2)
474 {
475         if (s1 == s2) return(True);
476         if (!s1 || !s2) return(False);
477   
478         return(strcasecmp_w(s1,s2)==0);
479 }
480
481 /*******************************************************************
482   compare 2 strings up to and including the nth char.
483   ******************************************************************/
484 BOOL strnequal_w(const smb_ucs2_t *s1,const smb_ucs2_t *s2,size_t n)
485 {
486   if (s1 == s2) return(True);
487   if (!s1 || !s2 || !n) return(False);
488   
489   return(strncasecmp_w(s1,s2,n)==0);
490 }
491
492 /*******************************************************************
493 duplicate string
494 ********************************************************************/
495 smb_ucs2_t *strdup_w(const smb_ucs2_t *src)
496 {
497         return strndup_w(src, 0);
498 }
499
500 /* if len == 0 then duplicate the whole string */
501 smb_ucs2_t *strndup_w(const smb_ucs2_t *src, size_t len)
502 {
503         smb_ucs2_t *dest;
504         
505         if (!len) len = strlen_w(src);
506         dest = (smb_ucs2_t *)malloc((len + 1) * sizeof(smb_ucs2_t));
507         if (!dest) {
508                 DEBUG(0,("strdup_w: out of memory!\n"));
509                 return NULL;
510         }
511
512         memcpy(dest, src, len * sizeof(smb_ucs2_t));
513         dest[len] = 0;
514         
515         return dest;
516 }
517
518 /*******************************************************************
519 copy a string with max len
520 ********************************************************************/
521
522 smb_ucs2_t *strncpy_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
523 {
524         size_t len;
525         
526         if (!dest || !src) return NULL;
527         
528         for (len = 0; (src[len] != 0) && (len < max); len++)
529                 dest[len] = src[len];
530         while (len < max)
531                 dest[len++] = 0;
532         
533         return dest;
534 }
535
536
537 /*******************************************************************
538 append a string of len bytes and add a terminator
539 ********************************************************************/
540
541 smb_ucs2_t *strncat_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
542 {       
543         size_t start;
544         size_t len;     
545         
546         if (!dest || !src) return NULL;
547         
548         start = strlen_w(dest);
549         len = strnlen_w(src, max);
550
551         memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));                      
552         dest[start+len] = 0;
553         
554         return dest;
555 }
556
557 smb_ucs2_t *strcat_w(smb_ucs2_t *dest, const smb_ucs2_t *src)
558 {       
559         size_t start;
560         size_t len;     
561         
562         if (!dest || !src) return NULL;
563         
564         start = strlen_w(dest);
565         len = strlen_w(src);
566
567         memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));                      
568         dest[start+len] = 0;
569         
570         return dest;
571 }
572
573
574 /*******************************************************************
575 replace any occurence of oldc with newc in unicode string
576 ********************************************************************/
577
578 void string_replace_w(smb_ucs2_t *s, smb_ucs2_t oldc, smb_ucs2_t newc)
579 {
580         for(;*s;s++) {
581                 if(*s==oldc) *s=newc;
582         }
583 }
584
585 /*******************************************************************
586 trim unicode string
587 ********************************************************************/
588
589 BOOL trim_string_w(smb_ucs2_t *s, const smb_ucs2_t *front,
590                                   const smb_ucs2_t *back)
591 {
592         BOOL ret = False;
593         size_t len, front_len, back_len;
594
595         if (!s || !*s) return False;
596
597         len = strlen_w(s);
598
599         if (front && *front) {
600                 front_len = strlen_w(front);
601                 while (len && strncmp_w(s, front, front_len) == 0) {
602                         memmove(s, (s + front_len), (len - front_len + 1) * sizeof(smb_ucs2_t));
603                         len -= front_len;
604                         ret = True;
605                 }
606         }
607         
608         if (back && *back) {
609                 back_len = strlen_w(back);
610                 while (len && strncmp_w((s + (len - back_len)), back, back_len) == 0) {
611                         s[len - back_len] = 0;
612                         len -= back_len;
613                         ret = True;
614                 }
615         }
616
617         return ret;
618 }
619
620 /*
621   The *_wa() functions take a combination of 7 bit ascii
622   and wide characters They are used so that you can use string
623   functions combining C string constants with ucs2 strings
624
625   The char* arguments must NOT be multibyte - to be completely sure
626   of this only pass string constants */
627
628
629 void pstrcpy_wa(smb_ucs2_t *dest, const char *src)
630 {
631         int i;
632         for (i=0;i<PSTRING_LEN;i++) {
633                 dest[i] = UCS2_CHAR(src[i]);
634                 if (src[i] == 0) return;
635         }
636 }
637
638 int strcmp_wa(const smb_ucs2_t *a, const char *b)
639 {
640         while (*b && *a == UCS2_CHAR(*b)) { a++; b++; }
641         return (*a - UCS2_CHAR(*b));
642 }
643
644 int strncmp_wa(const smb_ucs2_t *a, const char *b, size_t len)
645 {
646         size_t n = 0;
647         while ((n < len) && *b && *a == UCS2_CHAR(*b)) { a++; b++; n++;}
648         return (len - n)?(*a - UCS2_CHAR(*b)):0;
649 }
650
651 smb_ucs2_t *strpbrk_wa(const smb_ucs2_t *s, const char *p)
652 {
653         while (*s != 0) {
654                 int i;
655                 for (i=0; p[i] && *s != UCS2_CHAR(p[i]); i++) 
656                         ;
657                 if (p[i]) return (smb_ucs2_t *)s;
658                 s++;
659         }
660         return NULL;
661 }
662
663 smb_ucs2_t *strstr_wa(const smb_ucs2_t *s, const char *ins)
664 {
665         smb_ucs2_t *r;
666         size_t slen, inslen;
667
668         if (!s || !*s || !ins || !*ins) return NULL;
669         slen = strlen_w(s);
670         inslen = strlen(ins);
671         r = (smb_ucs2_t *)s;
672         while ((r = strchr_w(r, UCS2_CHAR(*ins)))) {
673                 if (strncmp_wa(r, ins, inslen) == 0) return r;
674                 r++;
675         }
676         return NULL;
677 }
678
679 /*******************************************************************
680 copy a string with max len
681 ********************************************************************/
682
683 smb_ucs2_t *strncpy_wa(smb_ucs2_t *dest, const char *src, const size_t max)
684 {
685         smb_ucs2_t *ucs2_src;
686
687         if (!dest || !src) return NULL;
688         if (!(ucs2_src = acnv_uxu2(src)))
689                 return NULL;
690         
691         strncpy_w(dest, ucs2_src, max);
692         SAFE_FREE(ucs2_src);
693         return dest;
694 }
695
696 /*******************************************************************
697 convert and duplicate an ascii string
698 ********************************************************************/
699 smb_ucs2_t *strdup_wa(const char *src)
700 {
701         return strndup_wa(src, 0);
702 }
703
704 /* if len == 0 then duplicate the whole string */
705 smb_ucs2_t *strndup_wa(const char *src, size_t len)
706 {
707         smb_ucs2_t *dest, *s;
708
709         s = acnv_dosu2(src);    
710         if (!len) len = strlen_w(s);
711         dest = (smb_ucs2_t *)malloc((len + 1) * sizeof(smb_ucs2_t));
712         if (!dest) {
713                 DEBUG(0,("strdup_w: out of memory!\n"));
714                 SAFE_FREE(s);
715                 return NULL;
716         }
717
718         memcpy(dest, src, len * sizeof(smb_ucs2_t));
719         dest[len] = 0;
720
721         SAFE_FREE(s);
722         return dest;
723 }
724
725 /*******************************************************************
726 append a string of len bytes and add a terminator
727 ********************************************************************/
728
729 smb_ucs2_t *strncat_wa(smb_ucs2_t *dest, const char *src, const size_t max)
730 {
731         smb_ucs2_t *ucs2_src;
732
733         if (!dest || !src) return NULL;
734         if (!(ucs2_src = acnv_uxu2(src)))
735                 return NULL;
736         
737         strncat_w(dest, ucs2_src, max);
738         SAFE_FREE(ucs2_src);
739         return dest;
740 }
741
742 smb_ucs2_t *strcat_wa(smb_ucs2_t *dest, const char *src)
743 {       
744         smb_ucs2_t *ucs2_src;
745         
746         if (!dest || !src) return NULL;
747         if (!(ucs2_src = acnv_uxu2(src)))
748                 return NULL;
749         
750         strcat_w(dest, ucs2_src);
751         SAFE_FREE(ucs2_src);
752         return dest;
753 }
754
755 BOOL trim_string_wa(smb_ucs2_t *s, const char *front,
756                                   const char *back)
757 {
758         wpstring f, b;
759
760         if (front) push_ucs2(NULL, f, front, sizeof(wpstring) - 1, STR_TERMINATE);
761         else *f = 0;
762         if (back) push_ucs2(NULL, b, back, sizeof(wpstring) - 1, STR_TERMINATE);
763         else *b = 0;
764         return trim_string_w(s, f, b);
765 }
766
767 /*******************************************************************
768  returns the length in number of wide characters
769  ******************************************************************/
770 int unistrlen(uint16 *s)
771 {
772         int len;
773
774         if (!s)
775                 return -1;
776
777         for (len=0; *s; s++,len++);
778
779         return len;
780 }
781
782 /*******************************************************************
783  Strcpy for unicode strings.  returns length (in num of wide chars)
784 ********************************************************************/
785
786 int unistrcpy(uint16 *dst, uint16 *src)
787 {
788         int num_wchars = 0;
789
790         while (*src) {
791                 *dst++ = *src++;
792                 num_wchars++;
793         }
794         *dst = 0;
795
796         return num_wchars;
797 }
798
799 /**
800  * Samba ucs2 type to UNISTR2 conversion
801  *
802  * @param ctx Talloc context to create the dst strcture (if null) and the 
803  *            contents of the unicode string.
804  * @param dst UNISTR2 destination. If equals null, then it's allocated.
805  * @param src smb_ucs2_t source.
806  * @param max_len maximum number of unicode characters to copy. If equals
807  *        null, then null-termination of src is taken
808  *
809  * @return copied UNISTR2 destination
810  **/
811 UNISTR2* ucs2_to_unistr2(TALLOC_CTX *ctx, UNISTR2* dst, smb_ucs2_t* src)
812 {
813         size_t len;
814
815         if (!src) return NULL;
816         len = strlen_w(src);
817         
818         /* allocate UNISTR2 destination if not given */
819         if (!dst) {
820                 dst = (UNISTR2*) talloc(ctx, sizeof(UNISTR2));
821                 if (!dst) return NULL;
822         }
823         if (!dst->buffer) {
824                 dst->buffer = (uint16*) talloc(ctx, sizeof(uint16) * (len + 1));
825                 if (!dst->buffer) return NULL;
826         }
827         
828         /* set UNISTR2 parameters */
829         dst->uni_max_len = len + 1;
830         dst->undoc = 0;
831         dst->uni_str_len = len;
832         
833         /* copy the actual unicode string */
834         strncpy_w(dst->buffer, src, dst->uni_max_len);
835         
836         return dst;
837 };
838