2 Unix SMB/CIFS implementation.
3 Samba utility functions
4 Copyright (C) Andrew Tridgell 1992-2001
5 Copyright (C) Simo Sorce 2001
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.
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.
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.
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;
35 /*******************************************************************
36 load the case handling tables
37 ********************************************************************/
38 void load_case_tables(void)
40 static int initialised;
44 if (initialised) return;
47 mem_ctx = talloc_init("load_case_tables");
49 smb_panic("No memory for case_tables");
51 upcase_table = map_file(lib_path(mem_ctx, "upcase.dat"), 0x20000);
52 lowcase_table = map_file(lib_path(mem_ctx, "lowcase.dat"), 0x20000);
53 talloc_destroy(mem_ctx);
55 /* we would like Samba to limp along even if these tables are
58 DEBUG(1,("creating lame upcase table\n"));
59 upcase_table = malloc(0x20000);
61 smb_panic("No memory for upcase tables");
63 for (i=0;i<0x10000;i++) {
70 SSVAL(&v, 0, UCS2_CHAR(i));
71 upcase_table[v] = UCS2_CHAR(islower(i)?toupper(i):i);
76 DEBUG(1,("creating lame lowcase table\n"));
77 lowcase_table = malloc(0x20000);
79 smb_panic("No memory for lowcase tables");
81 for (i=0;i<0x10000;i++) {
88 SSVAL(&v, 0, UCS2_CHAR(i));
89 lowcase_table[v] = UCS2_CHAR(isupper(i)?tolower(i):i);
95 see if a ucs2 character can be mapped correctly to a dos character
96 and mapped back to the same character in ucs2
98 static int check_dos_char(smb_ucs2_t c)
103 len1 = convert_string(CH_UCS2, CH_DOS, &c, 2, buf, sizeof(buf));
104 if (len1 == 0) return 0;
105 len2 = convert_string(CH_DOS, CH_UCS2, buf, len1, &c2, 2);
106 if (len2 != 2) return 0;
111 * Load the valid character map table from <tt>valid.dat</tt> or
112 * create from the configured codepage.
114 * This function is called whenever the configuration is reloaded.
115 * However, the valid character table is not changed if it's loaded
116 * from a file, because we can't unmap files.
118 void init_valid_table(void)
120 static int mapped_file;
122 const char *allowed = ".!#$%&'()_-@^`~";
127 /* Can't unmap files, so stick with what we have */
131 mem_ctx = talloc_init("init_valid_table");
133 smb_panic("No memory for valid_table");
135 valid_file = map_file(lib_path(mem_ctx, "valid.dat"), 0x10000);
136 talloc_destroy(mem_ctx);
138 valid_table = valid_file;
143 /* Otherwise, we're using a dynamically created valid_table.
144 * It might need to be regenerated if the code page changed.
145 * We know that we're not using a mapped file, so we can
146 * free() the old one. */
147 if (valid_table) free(valid_table);
149 DEBUG(2,("creating default valid table\n"));
150 valid_table = malloc(0x10000);
152 smb_panic("No memory for valid_table");
155 valid_table[i] = isalnum(i) || strchr(allowed,i);
157 for (;i<0x10000;i++) {
160 valid_table[i] = check_dos_char(c);
166 /*******************************************************************
167 Write a string in (little-endian) unicode format. src is in
168 the current DOS codepage. len is the length in bytes of the
169 string pointed to by dst.
171 if null_terminate is True then null terminate the packet (adds 2 bytes)
173 the return value is the length in bytes consumed by the string, including the
174 null termination if applied
175 ********************************************************************/
177 size_t dos_PutUniCode(char *dst,const char *src, ssize_t len, BOOL null_terminate)
179 return push_ucs2(NULL, dst, src, len,
180 STR_UNICODE|STR_NOALIGN | (null_terminate?STR_TERMINATE:0));
184 /*******************************************************************
185 Skip past a unicode string, but not more than len. Always move
186 past a terminating zero if found.
187 ********************************************************************/
189 char *skip_unibuf(char *src, size_t len)
191 char *srcend = src + len;
193 while (src < srcend && SVAL(src,0))
202 /* Copy a string from little-endian or big-endian unicode source (depending
203 * on flags) to internal samba format destination
205 int rpcstr_pull(char* dest, void *src, int dest_len, int src_len, int flags)
208 if(dest_len==-1) dest_len=MAXUNI-3;
209 return pull_ucs2(NULL, dest, src, dest_len, src_len, flags|STR_UNICODE|STR_NOALIGN);
212 /* Copy a string from a unistr2 source to internal samba format
213 destination. Use this instead of direct calls to rpcstr_pull() to avoid
214 having to determine whether the source string is null terminated. */
216 int rpcstr_pull_unistr2_fstring(char *dest, UNISTR2 *src)
218 return pull_ucs2(NULL, dest, src->buffer, sizeof(fstring),
219 src->uni_str_len * 2, 0);
222 /* Converts a string from internal samba format to unicode
224 int rpcstr_push(void* dest, const char *src, int dest_len, int flags)
226 return push_ucs2(NULL, dest, src, dest_len, flags|STR_UNICODE|STR_NOALIGN);
229 /*******************************************************************
230 Convert a (little-endian) UNISTR2 structure to an ASCII string
231 ********************************************************************/
232 void unistr2_to_ascii(char *dest, const UNISTR2 *str, size_t maxlen)
238 pull_ucs2(NULL, dest, str->buffer, maxlen, str->uni_str_len*2, STR_NOALIGN);
241 /*******************************************************************
242 give a static string for displaying a UNISTR2
243 ********************************************************************/
244 const char *unistr2_static(TALLOC_CTX *mem_ctx, const UNISTR2 *str)
247 unistr2_to_ascii(ret, str, sizeof(ret));
248 return talloc_strdup(mem_ctx, ret);
252 /*******************************************************************
253 duplicate a UNISTR2 string into a null terminated char*
254 using a talloc context
255 ********************************************************************/
256 char *unistr2_tdup(TALLOC_CTX *ctx, const UNISTR2 *str)
259 int maxlen = (str->uni_str_len+1)*4;
260 if (!str->buffer) return NULL;
261 s = (char *)talloc(ctx, maxlen); /* convervative */
263 pull_ucs2(NULL, s, str->buffer, maxlen, str->uni_str_len*2,
269 /*******************************************************************
270 Return a number stored in a buffer
271 ********************************************************************/
273 uint32 buffer2_to_uint32(BUFFER2 *str)
275 if (str->buf_len == 4)
276 return IVAL(str->buffer, 0);
281 /*******************************************************************
282 Convert a wchar to upper case.
283 ********************************************************************/
285 smb_ucs2_t toupper_w(smb_ucs2_t val)
287 return upcase_table[SVAL(&val,0)];
290 /*******************************************************************
291 Convert a wchar to lower case.
292 ********************************************************************/
294 smb_ucs2_t tolower_w( smb_ucs2_t val )
296 return lowcase_table[SVAL(&val,0)];
300 /*******************************************************************
301 determine if a character is lowercase
302 ********************************************************************/
303 BOOL islower_w(smb_ucs2_t c)
305 return upcase_table[SVAL(&c,0)] != c;
308 /*******************************************************************
309 determine if a character is uppercase
310 ********************************************************************/
311 BOOL isupper_w(smb_ucs2_t c)
313 return lowcase_table[SVAL(&c,0)] != c;
317 /*******************************************************************
318 determine if a character is valid in a 8.3 name
319 ********************************************************************/
320 BOOL isvalid83_w(smb_ucs2_t c)
322 return valid_table[SVAL(&c,0)] != 0;
325 /*******************************************************************
326 Count the number of characters in a smb_ucs2_t string.
327 ********************************************************************/
328 size_t strlen_w(const smb_ucs2_t *src)
332 for (len = 0; SVAL(src,0); len++, src++) ;
337 /*******************************************************************
338 Count up to max number of characters in a smb_ucs2_t string.
339 ********************************************************************/
340 size_t strnlen_w(const smb_ucs2_t *src, size_t max)
344 for (len = 0; (len < max) && SVAL(src, 0); len++, src++) ;
349 /*******************************************************************
351 ********************************************************************/
352 const smb_ucs2_t *strchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
355 if (c == *s) return s;
358 if (c == *s) return s;
363 const smb_ucs2_t *strchr_wa(const smb_ucs2_t *s, char c)
365 return strchr_w(s, UCS2_CHAR(c));
368 const smb_ucs2_t *strrchr_w(const smb_ucs2_t *s, smb_ucs2_t c)
370 const smb_ucs2_t *p = s;
371 int len = strlen_w(s);
372 if (len == 0) return NULL;
375 if (c == *p) return p;
380 /*******************************************************************
382 ********************************************************************/
383 const smb_ucs2_t *strstr_w(const smb_ucs2_t *s, const smb_ucs2_t *ins)
388 if (!s || !*s || !ins || !*ins) return NULL;
390 inslen = strlen_w(ins);
392 while ((r = strchr_w(r, *ins))) {
393 if (strncmp_w(r, ins, inslen) == 0) return r;
399 /*******************************************************************
400 Convert a string to lower case.
401 return True if any char is converted
402 ********************************************************************/
403 BOOL strlower_w(smb_ucs2_t *s)
407 smb_ucs2_t v = tolower_w(*s);
417 /*******************************************************************
418 Convert a string to upper case.
419 return True if any char is converted
420 ********************************************************************/
421 BOOL strupper_w(smb_ucs2_t *s)
425 smb_ucs2_t v = toupper_w(*s);
435 int strcmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
437 while (*b && *a == *b) { 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
444 int strncmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b, size_t len)
447 while ((n < len) && *b && *a == *b) { a++; b++; n++;}
448 return (len - n)?(*a - *b):0;
451 /*******************************************************************
452 case insensitive string comparison
453 ********************************************************************/
454 int strcasecmp_w(const smb_ucs2_t *a, const smb_ucs2_t *b)
456 while (*b && toupper_w(*a) == toupper_w(*b)) { a++; b++; }
457 return (tolower_w(*a) - tolower_w(*b));
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)
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;
470 /*******************************************************************
472 ********************************************************************/
473 BOOL strequal_w(const smb_ucs2_t *s1, const smb_ucs2_t *s2)
475 if (s1 == s2) return(True);
476 if (!s1 || !s2) return(False);
478 return(strcasecmp_w(s1,s2)==0);
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)
486 if (s1 == s2) return(True);
487 if (!s1 || !s2 || !n) return(False);
489 return(strncasecmp_w(s1,s2,n)==0);
492 /*******************************************************************
494 ********************************************************************/
495 smb_ucs2_t *strdup_w(const smb_ucs2_t *src)
497 return strndup_w(src, 0);
500 /* if len == 0 then duplicate the whole string */
501 smb_ucs2_t *strndup_w(const smb_ucs2_t *src, size_t len)
505 if (!len) len = strlen_w(src);
506 dest = (smb_ucs2_t *)malloc((len + 1) * sizeof(smb_ucs2_t));
508 DEBUG(0,("strdup_w: out of memory!\n"));
512 memcpy(dest, src, len * sizeof(smb_ucs2_t));
518 /*******************************************************************
519 copy a string with max len
520 ********************************************************************/
522 smb_ucs2_t *strncpy_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
526 if (!dest || !src) return NULL;
528 for (len = 0; (src[len] != 0) && (len < max); len++)
529 dest[len] = src[len];
537 /*******************************************************************
538 append a string of len bytes and add a terminator
539 ********************************************************************/
541 smb_ucs2_t *strncat_w(smb_ucs2_t *dest, const smb_ucs2_t *src, const size_t max)
546 if (!dest || !src) return NULL;
548 start = strlen_w(dest);
549 len = strnlen_w(src, max);
551 memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));
557 smb_ucs2_t *strcat_w(smb_ucs2_t *dest, const smb_ucs2_t *src)
562 if (!dest || !src) return NULL;
564 start = strlen_w(dest);
567 memcpy(&dest[start], src, len*sizeof(smb_ucs2_t));
574 /*******************************************************************
575 replace any occurence of oldc with newc in unicode string
576 ********************************************************************/
578 void string_replace_w(smb_ucs2_t *s, smb_ucs2_t oldc, smb_ucs2_t newc)
581 if(*s==oldc) *s=newc;
585 /*******************************************************************
587 ********************************************************************/
589 BOOL trim_string_w(smb_ucs2_t *s, const smb_ucs2_t *front,
590 const smb_ucs2_t *back)
593 size_t len, front_len, back_len;
595 if (!s || !*s) return False;
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));
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;
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
625 The char* arguments must NOT be multibyte - to be completely sure
626 of this only pass string constants */
629 void pstrcpy_wa(smb_ucs2_t *dest, const char *src)
632 for (i=0;i<PSTRING_LEN;i++) {
633 dest[i] = UCS2_CHAR(src[i]);
634 if (src[i] == 0) return;
638 int strcmp_wa(const smb_ucs2_t *a, const char *b)
640 while (*b && *a == UCS2_CHAR(*b)) { a++; b++; }
641 return (*a - UCS2_CHAR(*b));
644 int strncmp_wa(const smb_ucs2_t *a, const char *b, size_t len)
647 while ((n < len) && *b && *a == UCS2_CHAR(*b)) { a++; b++; n++;}
648 return (len - n)?(*a - UCS2_CHAR(*b)):0;
651 const smb_ucs2_t *strpbrk_wa(const smb_ucs2_t *s, const char *p)
655 for (i=0; p[i] && *s != UCS2_CHAR(p[i]); i++)
663 const smb_ucs2_t *strstr_wa(const smb_ucs2_t *s, const char *ins)
668 if (!s || !*s || !ins || !*ins) return NULL;
670 inslen = strlen(ins);
672 while ((r = strchr_w(r, UCS2_CHAR(*ins)))) {
673 if (strncmp_wa(r, ins, inslen) == 0) return r;
679 /*******************************************************************
680 copy a string with max len
681 ********************************************************************/
683 smb_ucs2_t *strncpy_wa(smb_ucs2_t *dest, const char *src, const size_t max)
685 smb_ucs2_t *ucs2_src;
687 if (!dest || !src) return NULL;
688 if (!(ucs2_src = acnv_uxu2(src)))
691 strncpy_w(dest, ucs2_src, max);
696 /*******************************************************************
697 convert and duplicate an ascii string
698 ********************************************************************/
699 smb_ucs2_t *strdup_wa(const char *src)
701 return strndup_wa(src, 0);
704 /* if len == 0 then duplicate the whole string */
705 smb_ucs2_t *strndup_wa(const char *src, size_t len)
707 smb_ucs2_t *dest, *s;
710 if (!len) len = strlen_w(s);
711 dest = (smb_ucs2_t *)malloc((len + 1) * sizeof(smb_ucs2_t));
713 DEBUG(0,("strdup_w: out of memory!\n"));
718 memcpy(dest, src, len * sizeof(smb_ucs2_t));
725 /*******************************************************************
726 append a string of len bytes and add a terminator
727 ********************************************************************/
729 smb_ucs2_t *strncat_wa(smb_ucs2_t *dest, const char *src, const size_t max)
731 smb_ucs2_t *ucs2_src;
733 if (!dest || !src) return NULL;
734 if (!(ucs2_src = acnv_uxu2(src)))
737 strncat_w(dest, ucs2_src, max);
742 smb_ucs2_t *strcat_wa(smb_ucs2_t *dest, const char *src)
744 smb_ucs2_t *ucs2_src;
746 if (!dest || !src) return NULL;
747 if (!(ucs2_src = acnv_uxu2(src)))
750 strcat_w(dest, ucs2_src);
755 BOOL trim_string_wa(smb_ucs2_t *s, const char *front,
760 if (front) push_ucs2(NULL, f, front, sizeof(wpstring) - 1, STR_TERMINATE);
762 if (back) push_ucs2(NULL, b, back, sizeof(wpstring) - 1, STR_TERMINATE);
764 return trim_string_w(s, f, b);
767 /*******************************************************************
768 returns the length in number of wide characters
769 ******************************************************************/
770 int unistrlen(uint16 *s)
777 for (len=0; *s; s++,len++);
782 /*******************************************************************
783 Strcpy for unicode strings. returns length (in num of wide chars)
784 ********************************************************************/
786 int unistrcpy(uint16 *dst, uint16 *src)
800 * Samba ucs2 type to UNISTR2 conversion
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
809 * @return copied UNISTR2 destination
811 UNISTR2* ucs2_to_unistr2(TALLOC_CTX *ctx, UNISTR2* dst, smb_ucs2_t* src)
815 if (!src) return NULL;
818 /* allocate UNISTR2 destination if not given */
820 dst = (UNISTR2*) talloc(ctx, sizeof(UNISTR2));
821 if (!dst) return NULL;
824 dst->buffer = (uint16*) talloc(ctx, sizeof(uint16) * (len + 1));
825 if (!dst->buffer) return NULL;
828 /* set UNISTR2 parameters */
829 dst->uni_max_len = len + 1;
831 dst->uni_str_len = len;
833 /* copy the actual unicode string */
834 strncpy_w(dst->buffer, src, dst->uni_max_len);