docs: Improve description of the share commands in man smb.conf.
[Samba/gebeck_regimport.git] / source3 / lib / util_unistr.c
blob4e78d1b0642e55134d4f79eba57021b59f04ba6a
1 /*
2 Unix SMB/CIFS implementation.
3 Samba utility functions
4 Copyright (C) Andrew Tridgell 1992-2001
5 Copyright (C) Simo Sorce 2001
6 Copyright (C) Jeremy Allison 2005
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
22 #include "includes.h"
24 #ifndef MAXUNI
25 #define MAXUNI 1024
26 #endif
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 static bool upcase_table_use_unmap;
34 static bool lowcase_table_use_unmap;
35 static bool valid_table_use_unmap;
36 static bool initialized;
38 /**
39 * Destroy global objects allocated by load_case_tables()
40 **/
41 void gfree_case_tables(void)
43 if ( upcase_table ) {
44 if ( upcase_table_use_unmap )
45 unmap_file(upcase_table, 0x20000);
46 else
47 SAFE_FREE(upcase_table);
50 if ( lowcase_table ) {
51 if ( lowcase_table_use_unmap )
52 unmap_file(lowcase_table, 0x20000);
53 else
54 SAFE_FREE(lowcase_table);
57 if ( valid_table ) {
58 if ( valid_table_use_unmap )
59 unmap_file(valid_table, 0x10000);
60 else
61 SAFE_FREE(valid_table);
63 initialized = false;
66 /**
67 * Load or generate the case handling tables.
69 * The case tables are defined in UCS2 and don't depend on any
70 * configured parameters, so they never need to be reloaded.
71 **/
73 void load_case_tables(void)
75 char *old_locale = NULL, *saved_locale = NULL;
76 int i;
77 TALLOC_CTX *frame = NULL;
79 if (initialized) {
80 return;
82 initialized = true;
84 frame = talloc_stackframe();
86 upcase_table = (smb_ucs2_t *)map_file(data_path("upcase.dat"),
87 0x20000);
88 upcase_table_use_unmap = ( upcase_table != NULL );
90 lowcase_table = (smb_ucs2_t *)map_file(data_path("lowcase.dat"),
91 0x20000);
92 lowcase_table_use_unmap = ( lowcase_table != NULL );
94 #ifdef HAVE_SETLOCALE
95 /* Get the name of the current locale. */
96 old_locale = setlocale(LC_ALL, NULL);
98 if (old_locale) {
99 /* Save it as it is in static storage. */
100 saved_locale = SMB_STRDUP(old_locale);
103 /* We set back the locale to C to get ASCII-compatible toupper/lower functions. */
104 setlocale(LC_ALL, "C");
105 #endif
107 /* we would like Samba to limp along even if these tables are
108 not available */
109 if (!upcase_table) {
110 DEBUG(1,("creating lame upcase table\n"));
111 upcase_table = (smb_ucs2_t *)SMB_MALLOC(0x20000);
112 for (i=0;i<0x10000;i++) {
113 smb_ucs2_t v;
114 SSVAL(&v, 0, i);
115 upcase_table[v] = i;
117 for (i=0;i<256;i++) {
118 smb_ucs2_t v;
119 SSVAL(&v, 0, UCS2_CHAR(i));
120 upcase_table[v] = UCS2_CHAR(islower(i)?toupper(i):i);
124 if (!lowcase_table) {
125 DEBUG(1,("creating lame lowcase table\n"));
126 lowcase_table = (smb_ucs2_t *)SMB_MALLOC(0x20000);
127 for (i=0;i<0x10000;i++) {
128 smb_ucs2_t v;
129 SSVAL(&v, 0, i);
130 lowcase_table[v] = i;
132 for (i=0;i<256;i++) {
133 smb_ucs2_t v;
134 SSVAL(&v, 0, UCS2_CHAR(i));
135 lowcase_table[v] = UCS2_CHAR(isupper(i)?tolower(i):i);
139 #ifdef HAVE_SETLOCALE
140 /* Restore the old locale. */
141 if (saved_locale) {
142 setlocale (LC_ALL, saved_locale);
143 SAFE_FREE(saved_locale);
145 #endif
146 TALLOC_FREE(frame);
149 static int check_dos_char_slowly(smb_ucs2_t c)
151 char buf[10];
152 smb_ucs2_t c2 = 0;
153 int len1, len2;
155 len1 = convert_string(CH_UTF16LE, CH_DOS, &c, 2, buf, sizeof(buf),False);
156 if (len1 == 0) {
157 return 0;
159 len2 = convert_string(CH_DOS, CH_UTF16LE, buf, len1, &c2, 2,False);
160 if (len2 != 2) {
161 return 0;
163 return (c == c2);
167 * Load the valid character map table from <tt>valid.dat</tt> or
168 * create from the configured codepage.
170 * This function is called whenever the configuration is reloaded.
171 * However, the valid character table is not changed if it's loaded
172 * from a file, because we can't unmap files.
175 void init_valid_table(void)
177 static int mapped_file;
178 int i;
179 const char *allowed = ".!#$%&'()_-@^`~";
180 uint8 *valid_file;
182 if (mapped_file) {
183 /* Can't unmap files, so stick with what we have */
184 return;
187 valid_file = (uint8 *)map_file(data_path("valid.dat"), 0x10000);
188 if (valid_file) {
189 valid_table = valid_file;
190 mapped_file = 1;
191 valid_table_use_unmap = True;
192 return;
195 /* Otherwise, we're using a dynamically created valid_table.
196 * It might need to be regenerated if the code page changed.
197 * We know that we're not using a mapped file, so we can
198 * free() the old one. */
199 SAFE_FREE(valid_table);
201 /* use free rather than unmap */
202 valid_table_use_unmap = False;
204 DEBUG(2,("creating default valid table\n"));
205 valid_table = (uint8 *)SMB_MALLOC(0x10000);
206 SMB_ASSERT(valid_table != NULL);
207 for (i=0;i<128;i++) {
208 valid_table[i] = isalnum(i) || strchr(allowed,i);
211 lazy_initialize_conv();
213 for (;i<0x10000;i++) {
214 smb_ucs2_t c;
215 SSVAL(&c, 0, i);
216 valid_table[i] = check_dos_char_slowly(c);
220 /*******************************************************************
221 Write a string in (little-endian) unicode format. src is in
222 the current DOS codepage. len is the length in bytes of the
223 string pointed to by dst.
225 if null_terminate is True then null terminate the packet (adds 2 bytes)
227 the return value is the length in bytes consumed by the string, including the
228 null termination if applied
229 ********************************************************************/
231 size_t dos_PutUniCode(char *dst,const char *src, size_t len, bool null_terminate)
233 int flags = null_terminate ? STR_UNICODE|STR_NOALIGN|STR_TERMINATE
234 : STR_UNICODE|STR_NOALIGN;
235 return push_ucs2(NULL, dst, src, len, flags);
239 /*******************************************************************
240 Skip past a unicode string, but not more than len. Always move
241 past a terminating zero if found.
242 ********************************************************************/
244 char *skip_unibuf(char *src, size_t len)
246 char *srcend = src + len;
248 while (src < srcend && SVAL(src,0)) {
249 src += 2;
252 if(!SVAL(src,0)) {
253 src += 2;
256 return src;
259 /* Copy a string from little-endian or big-endian unicode source (depending
260 * on flags) to internal samba format destination
263 int rpcstr_pull(char* dest, void *src, int dest_len, int src_len, int flags)
265 if (!src) {
266 dest[0] = 0;
267 return 0;
269 if(dest_len==-1) {
270 dest_len=MAXUNI-3;
272 return pull_ucs2(NULL, dest, src, dest_len, src_len, flags|STR_UNICODE|STR_NOALIGN);
275 /* Copy a string from little-endian or big-endian unicode source (depending
276 * on flags) to internal samba format destination. Allocates on talloc ctx.
279 int rpcstr_pull_talloc(TALLOC_CTX *ctx,
280 char **dest,
281 void *src,
282 int src_len,
283 int flags)
285 return pull_ucs2_base_talloc(ctx,
286 NULL,
287 dest,
288 src,
289 src_len,
290 flags|STR_UNICODE|STR_NOALIGN);
294 /* Copy a string from a unistr2 source to internal samba format
295 destination. Use this instead of direct calls to rpcstr_pull() to avoid
296 having to determine whether the source string is null terminated. */
298 int rpcstr_pull_unistr2_fstring(char *dest, UNISTR2 *src)
300 return pull_ucs2(NULL, dest, src->buffer, sizeof(fstring),
301 src->uni_str_len * 2, 0);
304 /* Helper function to return a talloc'ed string. I have implemented it with a
305 * copy because I don't really know how pull_ucs2 and friends calculate the
306 * target size. If this turns out to be a major bottleneck someone with deeper
307 * multi-byte knowledge needs to revisit this.
308 * I just did (JRA :-). No longer uses copy.
309 * My (VL) use is dsr_getdcname, which returns 6 strings, the alternative would
310 * have been to manually talloc_strdup them in rpc_client/cli_netlogon.c.
313 char *rpcstr_pull_unistr2_talloc(TALLOC_CTX *ctx, const UNISTR2 *src)
315 char *dest = NULL;
316 size_t dest_len;
318 if (!convert_string_talloc(ctx, CH_UTF16LE, CH_UNIX, src->buffer,
319 src->uni_str_len * 2, (void *)&dest,
320 &dest_len, true))
322 return NULL;
325 /* Ensure we're returning a null terminated string. */
326 if (dest_len) {
327 /* Did we already process the terminating zero ? */
328 if (dest[dest_len-1] != 0) {
329 size_t size = talloc_get_size(dest);
330 /* Have we got space to append the '\0' ? */
331 if (size <= dest_len) {
332 /* No, realloc. */
333 dest = TALLOC_REALLOC_ARRAY(ctx, dest, char,
334 dest_len+1);
335 if (!dest) {
336 /* talloc fail. */
337 dest_len = (size_t)-1;
338 return NULL;
341 /* Yay - space ! */
342 dest[dest_len] = '\0';
343 dest_len++;
345 } else if (dest) {
346 dest[0] = 0;
349 return dest;
352 /* Converts a string from internal samba format to unicode
355 int rpcstr_push(void *dest, const char *src, size_t dest_len, int flags)
357 return push_ucs2(NULL, dest, src, dest_len, flags|STR_UNICODE|STR_NOALIGN);
360 /* Converts a string from internal samba format to unicode. Always terminates.
361 * Actually just a wrapper round push_ucs2_talloc().
364 int rpcstr_push_talloc(TALLOC_CTX *ctx, smb_ucs2_t **dest, const char *src)
366 size_t size;
367 if (push_ucs2_talloc(ctx, dest, src, &size))
368 return size;
369 else
370 return -1;
373 /*******************************************************************
374 Convert a (little-endian) UNISTR2 structure to an ASCII string.
375 ********************************************************************/
377 void unistr2_to_ascii(char *dest, const UNISTR2 *str, size_t maxlen)
379 if ((str == NULL) || (str->uni_str_len == 0)) {
380 *dest='\0';
381 return;
383 pull_ucs2(NULL, dest, str->buffer, maxlen, str->uni_str_len*2, STR_NOALIGN);
386 #if 0
387 /*******************************************************************
388 Convert a (little-endian) UNISTR3 structure to an ASCII string.
389 ********************************************************************/
391 void unistr3_to_ascii(char *dest, const UNISTR3 *str, size_t maxlen)
393 if ((str == NULL) || (str->uni_str_len == 0)) {
394 *dest='\0';
395 return;
397 pull_ucs2(NULL, dest, str->str.buffer, maxlen, str->uni_str_len*2,
398 STR_NOALIGN);
400 #endif
402 /*******************************************************************
403 Duplicate a UNISTR2 string into a null terminated char*
404 using a talloc context.
405 ********************************************************************/
407 char *unistr2_to_ascii_talloc(TALLOC_CTX *ctx, const UNISTR2 *str)
409 char *s = NULL;
411 if (!str || !str->buffer) {
412 return NULL;
414 if (pull_ucs2_base_talloc(ctx,
415 NULL,
417 str->buffer,
418 str->uni_str_len*2,
419 STR_NOALIGN) == (size_t)-1) {
420 return NULL;
422 return s;
425 /*******************************************************************
426 Return a string for displaying a UNISTR2. Guarentees to return a
427 valid string - "" if nothing else.
428 Changed to use talloc_tos() under the covers.... JRA.
429 ********************************************************************/
431 const char *unistr2_static(const UNISTR2 *str)
433 char *dest = NULL;
435 if ((str == NULL) || (str->uni_str_len == 0)) {
436 return "";
439 dest = unistr2_to_ascii_talloc(talloc_tos(), str);
440 if (!dest) {
441 return "";
444 return dest;
447 /*******************************************************************
448 Convert a wchar to upper case.
449 ********************************************************************/
451 smb_ucs2_t toupper_w(smb_ucs2_t val)
453 return upcase_table[SVAL(&val,0)];
456 /*******************************************************************
457 Convert a wchar to lower case.
458 ********************************************************************/
460 smb_ucs2_t tolower_w( smb_ucs2_t val )
462 return lowcase_table[SVAL(&val,0)];
465 /*******************************************************************
466 Determine if a character is lowercase.
467 ********************************************************************/
469 bool islower_w(smb_ucs2_t c)
471 return upcase_table[SVAL(&c,0)] != c;
474 /*******************************************************************
475 Determine if a character is uppercase.
476 ********************************************************************/
478 bool isupper_w(smb_ucs2_t c)
480 return lowcase_table[SVAL(&c,0)] != c;
483 /*******************************************************************
484 Determine if a character is valid in a 8.3 name.
485 ********************************************************************/
487 bool isvalid83_w(smb_ucs2_t c)
489 return valid_table[SVAL(&c,0)] != 0;
492 /*******************************************************************
493 Count the number of characters in a smb_ucs2_t string.
494 ********************************************************************/
496 size_t strlen_w(const smb_ucs2_t *src)
498 size_t len;
499 smb_ucs2_t c;
501 for(len = 0; *(COPY_UCS2_CHAR(&c,src)); src++, len++) {
505 return len;
508 /*******************************************************************
509 Count up to max number of characters in a smb_ucs2_t string.
510 ********************************************************************/
512 size_t strnlen_w(const smb_ucs2_t *src, size_t max)
514 size_t len;
515 smb_ucs2_t c;
517 for(len = 0; (len < max) && *(COPY_UCS2_CHAR(&c,src)); src++, len++) {
521 return len;
524 /*******************************************************************
525 Wide strchr().
526 ********************************************************************/
528 smb_ucs2_t *strchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
530 smb_ucs2_t cp;
531 while (*(COPY_UCS2_CHAR(&cp,s))) {
532 if (c == cp) {
533 return (smb_ucs2_t *)s;
535 s++;
537 if (c == cp) {
538 return (smb_ucs2_t *)s;
541 return NULL;
544 smb_ucs2_t *strchr_wa(const smb_ucs2_t *s, char c)
546 return strchr_w(s, UCS2_CHAR(c));
549 /*******************************************************************
550 Wide strrchr().
551 ********************************************************************/
553 smb_ucs2_t *strrchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
555 smb_ucs2_t cp;
556 const smb_ucs2_t *p = s;
557 int len = strlen_w(s);
559 if (len == 0) {
560 return NULL;
562 p += (len - 1);
563 do {
564 if (c == *(COPY_UCS2_CHAR(&cp,p))) {
565 return (smb_ucs2_t *)p;
567 } while (p-- != s);
568 return NULL;
571 /*******************************************************************
572 Wide version of strrchr that returns after doing strrchr 'n' times.
573 ********************************************************************/
575 smb_ucs2_t *strnrchr_w(const smb_ucs2_t *s, smb_ucs2_t c, unsigned int n)
577 smb_ucs2_t cp;
578 const smb_ucs2_t *p = s;
579 int len = strlen_w(s);
581 if (len == 0 || !n) {
582 return NULL;
584 p += (len - 1);
585 do {
586 if (c == *(COPY_UCS2_CHAR(&cp,p))) {
587 n--;
590 if (!n) {
591 return (smb_ucs2_t *)p;
593 } while (p-- != s);
594 return NULL;
597 /*******************************************************************
598 Wide strstr().
599 ********************************************************************/
601 smb_ucs2_t *strstr_w(const smb_ucs2_t *s, const smb_ucs2_t *ins)
603 smb_ucs2_t *r;
604 size_t inslen;
606 if (!s || !*s || !ins || !*ins) {
607 return NULL;
610 inslen = strlen_w(ins);
611 r = (smb_ucs2_t *)s;
613 while ((r = strchr_w(r, *ins))) {
614 if (strncmp_w(r, ins, inslen) == 0) {
615 return r;
617 r++;
620 return NULL;
623 /*******************************************************************
624 Convert a string to lower case.
625 return True if any char is converted
626 ********************************************************************/
628 bool strlower_w(smb_ucs2_t *s)
630 smb_ucs2_t cp;
631 bool ret = False;
633 while (*(COPY_UCS2_CHAR(&cp,s))) {
634 smb_ucs2_t v = tolower_w(cp);
635 if (v != cp) {
636 COPY_UCS2_CHAR(s,&v);
637 ret = True;
639 s++;
641 return ret;
644 /*******************************************************************
645 Convert a string to upper case.
646 return True if any char is converted
647 ********************************************************************/
649 bool strupper_w(smb_ucs2_t *s)
651 smb_ucs2_t cp;
652 bool ret = False;
653 while (*(COPY_UCS2_CHAR(&cp,s))) {
654 smb_ucs2_t v = toupper_w(cp);
655 if (v != cp) {
656 COPY_UCS2_CHAR(s,&v);
657 ret = True;
659 s++;
661 return ret;
664 /*******************************************************************
665 Convert a string to "normal" form.
666 ********************************************************************/
668 void strnorm_w(smb_ucs2_t *s, int case_default)
670 if (case_default == CASE_UPPER) {
671 strupper_w(s);
672 } else {
673 strlower_w(s);
677 int strcmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
679 smb_ucs2_t cpa, cpb;
681 while ((*(COPY_UCS2_CHAR(&cpb,b))) && (*(COPY_UCS2_CHAR(&cpa,a)) == cpb)) {
682 a++;
683 b++;
685 return (*(COPY_UCS2_CHAR(&cpa,a)) - *(COPY_UCS2_CHAR(&cpb,b)));
686 /* warning: if *a != *b and both are not 0 we return a random
687 greater or lesser than 0 number not realted to which
688 string is longer */
691 int strncmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b, size_t len)
693 smb_ucs2_t cpa, cpb;
694 size_t n = 0;
696 while ((n < len) && (*(COPY_UCS2_CHAR(&cpb,b))) && (*(COPY_UCS2_CHAR(&cpa,a)) == cpb)) {
697 a++;
698 b++;
699 n++;
701 return (len - n)?(*(COPY_UCS2_CHAR(&cpa,a)) - *(COPY_UCS2_CHAR(&cpb,b))):0;
704 /*******************************************************************
705 Case insensitive string comparison.
706 ********************************************************************/
708 int strcasecmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
710 smb_ucs2_t cpa, cpb;
712 while ((*COPY_UCS2_CHAR(&cpb,b)) && toupper_w(*(COPY_UCS2_CHAR(&cpa,a))) == toupper_w(cpb)) {
713 a++;
714 b++;
716 return (tolower_w(*(COPY_UCS2_CHAR(&cpa,a))) - tolower_w(*(COPY_UCS2_CHAR(&cpb,b))));
719 /*******************************************************************
720 Case insensitive string comparison, length limited.
721 ********************************************************************/
723 int strncasecmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b, size_t len)
725 smb_ucs2_t cpa, cpb;
726 size_t n = 0;
728 while ((n < len) && *COPY_UCS2_CHAR(&cpb,b) && (toupper_w(*(COPY_UCS2_CHAR(&cpa,a))) == toupper_w(cpb))) {
729 a++;
730 b++;
731 n++;
733 return (len - n)?(tolower_w(*(COPY_UCS2_CHAR(&cpa,a))) - tolower_w(*(COPY_UCS2_CHAR(&cpb,b)))):0;
736 /*******************************************************************
737 Compare 2 strings.
738 ********************************************************************/
740 bool strequal_w(const smb_ucs2_t *s1, const smb_ucs2_t *s2)
742 if (s1 == s2) {
743 return(True);
745 if (!s1 || !s2) {
746 return(False);
749 return(strcasecmp_w(s1,s2)==0);
752 /*******************************************************************
753 Compare 2 strings up to and including the nth char.
754 ******************************************************************/
756 bool strnequal_w(const smb_ucs2_t *s1,const smb_ucs2_t *s2,size_t n)
758 if (s1 == s2) {
759 return(True);
761 if (!s1 || !s2 || !n) {
762 return(False);
765 return(strncasecmp_w(s1,s2,n)==0);
768 /*******************************************************************
769 Duplicate string.
770 ********************************************************************/
772 smb_ucs2_t *strdup_w(const smb_ucs2_t *src)
774 return strndup_w(src, 0);
777 /* if len == 0 then duplicate the whole string */
779 smb_ucs2_t *strndup_w(const smb_ucs2_t *src, size_t len)
781 smb_ucs2_t *dest;
783 if (!len) {
784 len = strlen_w(src);
786 dest = SMB_MALLOC_ARRAY(smb_ucs2_t, len + 1);
787 if (!dest) {
788 DEBUG(0,("strdup_w: out of memory!\n"));
789 return NULL;
792 memcpy(dest, src, len * sizeof(smb_ucs2_t));
793 dest[len] = 0;
794 return dest;
797 /*******************************************************************
798 Copy a string with max len.
799 ********************************************************************/
801 smb_ucs2_t *strncpy_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
803 smb_ucs2_t cp;
804 size_t len;
806 if (!dest || !src) {
807 return NULL;
810 for (len = 0; (*COPY_UCS2_CHAR(&cp,(src+len))) && (len < max); len++) {
811 cp = *COPY_UCS2_CHAR(dest+len,src+len);
813 cp = 0;
814 for ( /*nothing*/ ; len < max; len++ ) {
815 cp = *COPY_UCS2_CHAR(dest+len,&cp);
818 return dest;
821 /*******************************************************************
822 Append a string of len bytes and add a terminator.
823 ********************************************************************/
825 smb_ucs2_t *strncat_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
827 size_t start;
828 size_t len;
829 smb_ucs2_t z = 0;
831 if (!dest || !src) {
832 return NULL;
835 start = strlen_w(dest);
836 len = strnlen_w(src, max);
838 memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));
839 z = *COPY_UCS2_CHAR(dest+start+len,&z);
841 return dest;
844 smb_ucs2_t *strcat_w(smb_ucs2_t *dest, const smb_ucs2_t *src)
846 size_t start;
847 size_t len;
848 smb_ucs2_t z = 0;
850 if (!dest || !src) {
851 return NULL;
854 start = strlen_w(dest);
855 len = strlen_w(src);
857 memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));
858 z = *COPY_UCS2_CHAR(dest+start+len,&z);
860 return dest;
864 /*******************************************************************
865 Replace any occurence of oldc with newc in unicode string.
866 ********************************************************************/
868 void string_replace_w(smb_ucs2_t *s, smb_ucs2_t oldc, smb_ucs2_t newc)
870 smb_ucs2_t cp;
872 for(;*(COPY_UCS2_CHAR(&cp,s));s++) {
873 if(cp==oldc) {
874 COPY_UCS2_CHAR(s,&newc);
879 /*******************************************************************
880 Trim unicode string.
881 ********************************************************************/
883 bool trim_string_w(smb_ucs2_t *s, const smb_ucs2_t *front,
884 const smb_ucs2_t *back)
886 bool ret = False;
887 size_t len, front_len, back_len;
889 if (!s) {
890 return False;
893 len = strlen_w(s);
895 if (front && *front) {
896 front_len = strlen_w(front);
897 while (len && strncmp_w(s, front, front_len) == 0) {
898 memmove(s, (s + front_len), (len - front_len + 1) * sizeof(smb_ucs2_t));
899 len -= front_len;
900 ret = True;
904 if (back && *back) {
905 back_len = strlen_w(back);
906 while (len && strncmp_w((s + (len - back_len)), back, back_len) == 0) {
907 s[len - back_len] = 0;
908 len -= back_len;
909 ret = True;
913 return ret;
917 The *_wa() functions take a combination of 7 bit ascii
918 and wide characters They are used so that you can use string
919 functions combining C string constants with ucs2 strings
921 The char* arguments must NOT be multibyte - to be completely sure
922 of this only pass string constants */
924 int strcmp_wa(const smb_ucs2_t *a, const char *b)
926 smb_ucs2_t cp = 0;
928 while (*b && *(COPY_UCS2_CHAR(&cp,a)) == UCS2_CHAR(*b)) {
929 a++;
930 b++;
932 return (*(COPY_UCS2_CHAR(&cp,a)) - UCS2_CHAR(*b));
935 int strncmp_wa(const smb_ucs2_t *a, const char *b, size_t len)
937 smb_ucs2_t cp = 0;
938 size_t n = 0;
940 while ((n < len) && *b && *(COPY_UCS2_CHAR(&cp,a)) == UCS2_CHAR(*b)) {
941 a++;
942 b++;
943 n++;
945 return (len - n)?(*(COPY_UCS2_CHAR(&cp,a)) - UCS2_CHAR(*b)):0;
948 smb_ucs2_t *strpbrk_wa(const smb_ucs2_t *s, const char *p)
950 smb_ucs2_t cp;
952 while (*(COPY_UCS2_CHAR(&cp,s))) {
953 int i;
954 for (i=0; p[i] && cp != UCS2_CHAR(p[i]); i++)
956 if (p[i]) {
957 return (smb_ucs2_t *)s;
959 s++;
961 return NULL;
964 smb_ucs2_t *strstr_wa(const smb_ucs2_t *s, const char *ins)
966 smb_ucs2_t *r;
967 size_t inslen;
969 if (!s || !ins) {
970 return NULL;
973 inslen = strlen(ins);
974 r = (smb_ucs2_t *)s;
976 while ((r = strchr_w(r, UCS2_CHAR(*ins)))) {
977 if (strncmp_wa(r, ins, inslen) == 0)
978 return r;
979 r++;
982 return NULL;
985 /*******************************************************************
986 Returns the length in number of wide characters.
987 ******************************************************************/
989 int unistrlen(uint16 *s)
991 int len;
993 if (!s) {
994 return -1;
997 for (len=0; SVAL(s,0); s++,len++) {
1001 return len;
1004 /*******************************************************************
1005 Strcpy for unicode strings. Returns length (in num of wide chars).
1006 Not odd align safe.
1007 ********************************************************************/
1009 int unistrcpy(uint16 *dst, uint16 *src)
1011 int num_wchars = 0;
1013 while (SVAL(src,0)) {
1014 *dst++ = *src++;
1015 num_wchars++;
1017 *dst = 0;
1019 return num_wchars;
1023 * Samba ucs2 type to UNISTR2 conversion
1025 * @param ctx Talloc context to create the dst strcture (if null) and the
1026 * contents of the unicode string.
1027 * @param dst UNISTR2 destination. If equals null, then it's allocated.
1028 * @param src smb_ucs2_t source.
1029 * @param max_len maximum number of unicode characters to copy. If equals
1030 * null, then null-termination of src is taken
1032 * @return copied UNISTR2 destination
1035 UNISTR2* ucs2_to_unistr2(TALLOC_CTX *ctx, UNISTR2* dst, smb_ucs2_t* src)
1037 size_t len;
1039 if (!src) {
1040 return NULL;
1043 len = strlen_w(src);
1045 /* allocate UNISTR2 destination if not given */
1046 if (!dst) {
1047 dst = TALLOC_P(ctx, UNISTR2);
1048 if (!dst)
1049 return NULL;
1051 if (!dst->buffer) {
1052 dst->buffer = TALLOC_ARRAY(ctx, uint16, len + 1);
1053 if (!dst->buffer)
1054 return NULL;
1057 /* set UNISTR2 parameters */
1058 dst->uni_max_len = len + 1;
1059 dst->offset = 0;
1060 dst->uni_str_len = len;
1062 /* copy the actual unicode string */
1063 strncpy_w(dst->buffer, src, dst->uni_max_len);
1065 return dst;
1068 /*************************************************************
1069 ascii only toupper - saves the need for smbd to be in C locale.
1070 *************************************************************/
1072 int toupper_ascii(int c)
1074 smb_ucs2_t uc = toupper_w(UCS2_CHAR(c));
1075 return UCS2_TO_CHAR(uc);
1078 /*************************************************************
1079 ascii only tolower - saves the need for smbd to be in C locale.
1080 *************************************************************/
1082 int tolower_ascii(int c)
1084 smb_ucs2_t uc = tolower_w(UCS2_CHAR(c));
1085 return UCS2_TO_CHAR(uc);
1088 /*************************************************************
1089 ascii only isupper - saves the need for smbd to be in C locale.
1090 *************************************************************/
1092 int isupper_ascii(int c)
1094 return isupper_w(UCS2_CHAR(c));
1097 /*************************************************************
1098 ascii only islower - saves the need for smbd to be in C locale.
1099 *************************************************************/
1101 int islower_ascii(int c)
1103 return islower_w(UCS2_CHAR(c));