dnscrypto-proxy: Support files updated.
[tomato.git] / release / src / router / samba3 / source / lib / charcnv.c
blob7d42e50c5219ff48b5585aa045c8008de3a87dae
1 /*
2 Unix SMB/CIFS implementation.
3 Character set conversion Extensions
4 Copyright (C) Igor Vergeichik <iverg@mail.ru> 2001
5 Copyright (C) Andrew Tridgell 2001
6 Copyright (C) Simo Sorce 2001
7 Copyright (C) Martin Pool 2003
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #include "includes.h"
26 /* We can parameterize this if someone complains.... JRA. */
28 char lp_failed_convert_char(void)
30 return '_';
33 /**
34 * @file
36 * @brief Character-set conversion routines built on our iconv.
38 * @note Samba's internal character set (at least in the 3.0 series)
39 * is always the same as the one for the Unix filesystem. It is
40 * <b>not</b> necessarily UTF-8 and may be different on machines that
41 * need i18n filenames to be compatible with Unix software. It does
42 * have to be a superset of ASCII. All multibyte sequences must start
43 * with a byte with the high bit set.
45 * @sa lib/iconv.c
49 static smb_iconv_t conv_handles[NUM_CHARSETS][NUM_CHARSETS];
50 static BOOL conv_silent; /* Should we do a debug if the conversion fails ? */
52 /**
53 * Return the name of a charset to give to iconv().
54 **/
55 static const char *charset_name(charset_t ch)
57 const char *ret = NULL;
59 if (ch == CH_UTF16LE) ret = "UTF-16LE";
60 else if (ch == CH_UTF16BE) ret = "UTF-16BE";
61 else if (ch == CH_UNIX) ret = lp_unix_charset();
62 else if (ch == CH_DOS) ret = lp_dos_charset();
63 else if (ch == CH_DISPLAY) ret = lp_display_charset();
64 else if (ch == CH_UTF8) ret = "UTF8";
66 #if defined(HAVE_NL_LANGINFO) && defined(CODESET)
67 if (ret && !strcmp(ret, "LOCALE")) {
68 const char *ln = NULL;
70 #ifdef HAVE_SETLOCALE
71 setlocale(LC_ALL, "");
72 #endif
73 ln = nl_langinfo(CODESET);
74 if (ln) {
75 /* Check whether the charset name is supported
76 by iconv */
77 smb_iconv_t handle = smb_iconv_open(ln,"UCS-2LE");
78 if (handle == (smb_iconv_t) -1) {
79 DEBUG(5,("Locale charset '%s' unsupported, using ASCII instead\n", ln));
80 ln = NULL;
81 } else {
82 DEBUG(5,("Substituting charset '%s' for LOCALE\n", ln));
83 smb_iconv_close(handle);
86 ret = ln;
88 #endif
90 if (!ret || !*ret) ret = "ASCII";
91 return ret;
94 void lazy_initialize_conv(void)
96 static int initialized = False;
98 if (!initialized) {
99 initialized = True;
100 load_case_tables();
101 init_iconv();
106 * Destroy global objects allocated by init_iconv()
108 void gfree_charcnv(void)
110 int c1, c2;
112 for (c1=0;c1<NUM_CHARSETS;c1++) {
113 for (c2=0;c2<NUM_CHARSETS;c2++) {
114 if ( conv_handles[c1][c2] ) {
115 smb_iconv_close( conv_handles[c1][c2] );
116 conv_handles[c1][c2] = 0;
123 * Initialize iconv conversion descriptors.
125 * This is called the first time it is needed, and also called again
126 * every time the configuration is reloaded, because the charset or
127 * codepage might have changed.
129 void init_iconv(void)
131 int c1, c2;
132 BOOL did_reload = False;
134 /* so that charset_name() works we need to get the UNIX<->UCS2 going
135 first */
136 if (!conv_handles[CH_UNIX][CH_UTF16LE])
137 conv_handles[CH_UNIX][CH_UTF16LE] = smb_iconv_open(charset_name(CH_UTF16LE), "ASCII");
139 if (!conv_handles[CH_UTF16LE][CH_UNIX])
140 conv_handles[CH_UTF16LE][CH_UNIX] = smb_iconv_open("ASCII", charset_name(CH_UTF16LE));
142 for (c1=0;c1<NUM_CHARSETS;c1++) {
143 for (c2=0;c2<NUM_CHARSETS;c2++) {
144 const char *n1 = charset_name((charset_t)c1);
145 const char *n2 = charset_name((charset_t)c2);
146 if (conv_handles[c1][c2] &&
147 strcmp(n1, conv_handles[c1][c2]->from_name) == 0 &&
148 strcmp(n2, conv_handles[c1][c2]->to_name) == 0)
149 continue;
151 did_reload = True;
153 if (conv_handles[c1][c2])
154 smb_iconv_close(conv_handles[c1][c2]);
156 conv_handles[c1][c2] = smb_iconv_open(n2,n1);
157 if (conv_handles[c1][c2] == (smb_iconv_t)-1) {
158 DEBUG(0,("init_iconv: Conversion from %s to %s not supported\n",
159 charset_name((charset_t)c1), charset_name((charset_t)c2)));
160 if (c1 != CH_UTF16LE && c1 != CH_UTF16BE) {
161 n1 = "ASCII";
163 if (c2 != CH_UTF16LE && c2 != CH_UTF16BE) {
164 n2 = "ASCII";
166 DEBUG(0,("init_iconv: Attempting to replace with conversion from %s to %s\n",
167 n1, n2 ));
168 conv_handles[c1][c2] = smb_iconv_open(n2,n1);
169 if (!conv_handles[c1][c2]) {
170 DEBUG(0,("init_iconv: Conversion from %s to %s failed", n1, n2));
171 smb_panic("init_iconv: conv_handle initialization failed.");
177 if (did_reload) {
178 /* XXX: Does this really get called every time the dos
179 * codepage changes? */
180 /* XXX: Is the did_reload test too strict? */
181 conv_silent = True;
182 init_doschar_table();
183 init_valid_table();
184 conv_silent = False;
189 * Convert string from one encoding to another, making error checking etc
190 * Slow path version - uses (slow) iconv.
192 * @param src pointer to source string (multibyte or singlebyte)
193 * @param srclen length of the source string in bytes
194 * @param dest pointer to destination string (multibyte or singlebyte)
195 * @param destlen maximal length allowed for string
196 * @param allow_bad_conv determines if a "best effort" conversion is acceptable (never returns errors)
197 * @returns the number of bytes occupied in the destination
199 * Ensure the srclen contains the terminating zero.
203 static size_t convert_string_internal(charset_t from, charset_t to,
204 void const *src, size_t srclen,
205 void *dest, size_t destlen, BOOL allow_bad_conv)
207 size_t i_len, o_len;
208 size_t retval;
209 const char* inbuf = (const char*)src;
210 char* outbuf = (char*)dest;
211 smb_iconv_t descriptor;
213 lazy_initialize_conv();
215 descriptor = conv_handles[from][to];
217 if (srclen == (size_t)-1) {
218 if (from == CH_UTF16LE || from == CH_UTF16BE) {
219 srclen = (strlen_w((const smb_ucs2_t *)src)+1) * 2;
220 } else {
221 srclen = strlen((const char *)src)+1;
226 if (descriptor == (smb_iconv_t)-1 || descriptor == (smb_iconv_t)0) {
227 if (!conv_silent)
228 DEBUG(0,("convert_string_internal: Conversion not supported.\n"));
229 return (size_t)-1;
232 i_len=srclen;
233 o_len=destlen;
235 again:
237 retval = smb_iconv(descriptor, &inbuf, &i_len, &outbuf, &o_len);
238 if(retval==(size_t)-1) {
239 const char *reason="unknown error";
240 switch(errno) {
241 case EINVAL:
242 reason="Incomplete multibyte sequence";
243 if (!conv_silent)
244 DEBUG(3,("convert_string_internal: Conversion error: %s(%s)\n",reason,inbuf));
245 if (allow_bad_conv)
246 goto use_as_is;
247 break;
248 case E2BIG:
249 reason="No more room";
250 if (!conv_silent) {
251 if (from == CH_UNIX) {
252 DEBUG(3,("E2BIG: convert_string(%s,%s): srclen=%u destlen=%u - '%s'\n",
253 charset_name(from), charset_name(to),
254 (unsigned int)srclen, (unsigned int)destlen, (const char *)src));
255 } else {
256 DEBUG(3,("E2BIG: convert_string(%s,%s): srclen=%u destlen=%u\n",
257 charset_name(from), charset_name(to),
258 (unsigned int)srclen, (unsigned int)destlen));
261 break;
262 case EILSEQ:
263 reason="Illegal multibyte sequence";
264 if (!conv_silent)
265 DEBUG(3,("convert_string_internal: Conversion error: %s(%s)\n",reason,inbuf));
266 if (allow_bad_conv)
267 goto use_as_is;
268 break;
269 default:
270 if (!conv_silent)
271 DEBUG(0,("convert_string_internal: Conversion error: %s(%s)\n",reason,inbuf));
272 break;
274 /* smb_panic(reason); */
276 return destlen-o_len;
278 use_as_is:
281 * Conversion not supported. This is actually an error, but there are so
282 * many misconfigured iconv systems and smb.conf's out there we can't just
283 * fail. Do a very bad conversion instead.... JRA.
287 if (o_len == 0 || i_len == 0)
288 return destlen - o_len;
290 if (((from == CH_UTF16LE)||(from == CH_UTF16BE)) &&
291 ((to != CH_UTF16LE)||(to != CH_UTF16BE))) {
292 /* Can't convert from utf16 any endian to multibyte.
293 Replace with the default fail char.
295 if (i_len < 2)
296 return destlen - o_len;
297 if (i_len >= 2) {
298 *outbuf = lp_failed_convert_char();
300 outbuf++;
301 o_len--;
303 inbuf += 2;
304 i_len -= 2;
307 if (o_len == 0 || i_len == 0)
308 return destlen - o_len;
310 /* Keep trying with the next char... */
311 goto again;
313 } else if (from != CH_UTF16LE && from != CH_UTF16BE && to == CH_UTF16LE) {
314 /* Can't convert to UTF16LE - just widen by adding the
315 default fail char then zero.
317 if (o_len < 2)
318 return destlen - o_len;
320 outbuf[0] = lp_failed_convert_char();
321 outbuf[1] = '\0';
323 inbuf++;
324 i_len--;
326 outbuf += 2;
327 o_len -= 2;
329 if (o_len == 0 || i_len == 0)
330 return destlen - o_len;
332 /* Keep trying with the next char... */
333 goto again;
335 } else if (from != CH_UTF16LE && from != CH_UTF16BE &&
336 to != CH_UTF16LE && to != CH_UTF16BE) {
337 /* Failed multibyte to multibyte. Just copy the default fail char and
338 try again. */
339 outbuf[0] = lp_failed_convert_char();
341 inbuf++;
342 i_len--;
344 outbuf++;
345 o_len--;
347 if (o_len == 0 || i_len == 0)
348 return destlen - o_len;
350 /* Keep trying with the next char... */
351 goto again;
353 } else {
354 /* Keep compiler happy.... */
355 return destlen - o_len;
361 * Convert string from one encoding to another, making error checking etc
362 * Fast path version - handles ASCII first.
364 * @param src pointer to source string (multibyte or singlebyte)
365 * @param srclen length of the source string in bytes, or -1 for nul terminated.
366 * @param dest pointer to destination string (multibyte or singlebyte)
367 * @param destlen maximal length allowed for string - *NEVER* -1.
368 * @param allow_bad_conv determines if a "best effort" conversion is acceptable (never returns errors)
369 * @returns the number of bytes occupied in the destination
371 * Ensure the srclen contains the terminating zero.
373 * This function has been hand-tuned to provide a fast path.
374 * Don't change unless you really know what you are doing. JRA.
377 size_t convert_string(charset_t from, charset_t to,
378 void const *src, size_t srclen,
379 void *dest, size_t destlen, BOOL allow_bad_conv)
382 * NB. We deliberately don't do a strlen here if srclen == -1.
383 * This is very expensive over millions of calls and is taken
384 * care of in the slow path in convert_string_internal. JRA.
387 #ifdef DEVELOPER
388 SMB_ASSERT(destlen != (size_t)-1);
389 #endif
391 if (srclen == 0)
392 return 0;
394 if (from != CH_UTF16LE && from != CH_UTF16BE && to != CH_UTF16LE && to != CH_UTF16BE) {
395 const unsigned char *p = (const unsigned char *)src;
396 unsigned char *q = (unsigned char *)dest;
397 size_t slen = srclen;
398 size_t dlen = destlen;
399 unsigned char lastp = '\0';
400 size_t retval = 0;
402 /* If all characters are ascii, fast path here. */
403 while (slen && dlen) {
404 if ((lastp = *p) <= 0x7f) {
405 *q++ = *p++;
406 if (slen != (size_t)-1) {
407 slen--;
409 dlen--;
410 retval++;
411 if (!lastp)
412 break;
413 } else {
414 #ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
415 goto general_case;
416 #else
417 return retval + convert_string_internal(from, to, p, slen, q, dlen, allow_bad_conv);
418 #endif
421 if (!dlen) {
422 /* Even if we fast path we should note if we ran out of room. */
423 if (((slen != (size_t)-1) && slen) ||
424 ((slen == (size_t)-1) && lastp)) {
425 errno = E2BIG;
428 return retval;
429 } else if (from == CH_UTF16LE && to != CH_UTF16LE) {
430 const unsigned char *p = (const unsigned char *)src;
431 unsigned char *q = (unsigned char *)dest;
432 size_t retval = 0;
433 size_t slen = srclen;
434 size_t dlen = destlen;
435 unsigned char lastp = '\0';
437 /* If all characters are ascii, fast path here. */
438 while (((slen == (size_t)-1) || (slen >= 2)) && dlen) {
439 if (((lastp = *p) <= 0x7f) && (p[1] == 0)) {
440 *q++ = *p;
441 if (slen != (size_t)-1) {
442 slen -= 2;
444 p += 2;
445 dlen--;
446 retval++;
447 if (!lastp)
448 break;
449 } else {
450 #ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
451 goto general_case;
452 #else
453 return retval + convert_string_internal(from, to, p, slen, q, dlen, allow_bad_conv);
454 #endif
457 if (!dlen) {
458 /* Even if we fast path we should note if we ran out of room. */
459 if (((slen != (size_t)-1) && slen) ||
460 ((slen == (size_t)-1) && lastp)) {
461 errno = E2BIG;
464 return retval;
465 } else if (from != CH_UTF16LE && from != CH_UTF16BE && to == CH_UTF16LE) {
466 const unsigned char *p = (const unsigned char *)src;
467 unsigned char *q = (unsigned char *)dest;
468 size_t retval = 0;
469 size_t slen = srclen;
470 size_t dlen = destlen;
471 unsigned char lastp = '\0';
473 /* If all characters are ascii, fast path here. */
474 while (slen && (dlen >= 2)) {
475 if ((lastp = *p) <= 0x7F) {
476 *q++ = *p++;
477 *q++ = '\0';
478 if (slen != (size_t)-1) {
479 slen--;
481 dlen -= 2;
482 retval += 2;
483 if (!lastp)
484 break;
485 } else {
486 #ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
487 goto general_case;
488 #else
489 return retval + convert_string_internal(from, to, p, slen, q, dlen, allow_bad_conv);
490 #endif
493 if (!dlen) {
494 /* Even if we fast path we should note if we ran out of room. */
495 if (((slen != (size_t)-1) && slen) ||
496 ((slen == (size_t)-1) && lastp)) {
497 errno = E2BIG;
500 return retval;
503 #ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
504 general_case:
505 #endif
506 return convert_string_internal(from, to, src, srclen, dest, destlen, allow_bad_conv);
510 * Convert between character sets, allocating a new buffer for the result.
512 * @param ctx TALLOC_CTX to use to allocate with. If NULL use malloc.
513 * @param srclen length of source buffer.
514 * @param dest always set at least to NULL
515 * @note -1 is not accepted for srclen.
517 * @returns Size in bytes of the converted string; or -1 in case of error.
519 * Ensure the srclen contains the terminating zero.
521 * I hate the goto's in this function. It's embarressing.....
522 * There has to be a cleaner way to do this. JRA.
525 size_t convert_string_allocate(TALLOC_CTX *ctx, charset_t from, charset_t to,
526 void const *src, size_t srclen, void *dst, BOOL allow_bad_conv)
528 size_t i_len, o_len, destlen = (srclen * 3) / 2;
529 size_t retval;
530 const char *inbuf = (const char *)src;
531 char *outbuf = NULL, *ob = NULL;
532 smb_iconv_t descriptor;
533 void **dest = (void **)dst;
535 *dest = NULL;
537 if (src == NULL || srclen == (size_t)-1)
538 return (size_t)-1;
539 if (srclen == 0)
540 return 0;
542 lazy_initialize_conv();
544 descriptor = conv_handles[from][to];
546 if (descriptor == (smb_iconv_t)-1 || descriptor == (smb_iconv_t)0) {
547 if (!conv_silent)
548 DEBUG(0,("convert_string_allocate: Conversion not supported.\n"));
549 return (size_t)-1;
552 convert:
554 /* +2 is for ucs2 null termination. */
555 if ((destlen*2)+2 < destlen) {
556 /* wrapped ! abort. */
557 if (!conv_silent)
558 DEBUG(0, ("convert_string_allocate: destlen wrapped !\n"));
559 if (!ctx)
560 SAFE_FREE(outbuf);
561 return (size_t)-1;
562 } else {
563 destlen = destlen * 2;
566 /* +2 is for ucs2 null termination. */
567 if (ctx) {
568 ob = (char *)TALLOC_REALLOC(ctx, ob, destlen + 2);
569 } else {
570 ob = (char *)SMB_REALLOC(ob, destlen + 2);
573 if (!ob) {
574 DEBUG(0, ("convert_string_allocate: realloc failed!\n"));
575 return (size_t)-1;
577 outbuf = ob;
578 i_len = srclen;
579 o_len = destlen;
581 again:
583 retval = smb_iconv(descriptor,
584 &inbuf, &i_len,
585 &outbuf, &o_len);
586 if(retval == (size_t)-1) {
587 const char *reason="unknown error";
588 switch(errno) {
589 case EINVAL:
590 reason="Incomplete multibyte sequence";
591 if (!conv_silent)
592 DEBUG(3,("convert_string_allocate: Conversion error: %s(%s)\n",reason,inbuf));
593 if (allow_bad_conv)
594 goto use_as_is;
595 break;
596 case E2BIG:
597 goto convert;
598 case EILSEQ:
599 reason="Illegal multibyte sequence";
600 if (!conv_silent)
601 DEBUG(3,("convert_string_allocate: Conversion error: %s(%s)\n",reason,inbuf));
602 if (allow_bad_conv)
603 goto use_as_is;
604 break;
606 if (!conv_silent)
607 DEBUG(0,("Conversion error: %s(%s)\n",reason,inbuf));
608 /* smb_panic(reason); */
609 return (size_t)-1;
612 out:
614 destlen = destlen - o_len;
615 if (ctx) {
616 /* We're shrinking here so we know the +2 is safe from wrap. */
617 ob = (char *)TALLOC_REALLOC(ctx,ob,destlen + 2);
618 } else {
619 ob = (char *)SMB_REALLOC(ob,destlen + 2);
622 if (destlen && !ob) {
623 DEBUG(0, ("convert_string_allocate: out of memory!\n"));
624 return (size_t)-1;
627 *dest = ob;
629 /* Must ucs2 null terminate in the extra space we allocated. */
630 ob[destlen] = '\0';
631 ob[destlen+1] = '\0';
633 return destlen;
635 use_as_is:
638 * Conversion not supported. This is actually an error, but there are so
639 * many misconfigured iconv systems and smb.conf's out there we can't just
640 * fail. Do a very bad conversion instead.... JRA.
644 if (o_len == 0 || i_len == 0)
645 goto out;
647 if (((from == CH_UTF16LE)||(from == CH_UTF16BE)) &&
648 ((to != CH_UTF16LE)||(to != CH_UTF16BE))) {
649 /* Can't convert from utf16 any endian to multibyte.
650 Replace with the default fail char.
653 if (i_len < 2)
654 goto out;
656 if (i_len >= 2) {
657 *outbuf = lp_failed_convert_char();
659 outbuf++;
660 o_len--;
662 inbuf += 2;
663 i_len -= 2;
666 if (o_len == 0 || i_len == 0)
667 goto out;
669 /* Keep trying with the next char... */
670 goto again;
672 } else if (from != CH_UTF16LE && from != CH_UTF16BE && to == CH_UTF16LE) {
673 /* Can't convert to UTF16LE - just widen by adding the
674 default fail char then zero.
676 if (o_len < 2)
677 goto out;
679 outbuf[0] = lp_failed_convert_char();
680 outbuf[1] = '\0';
682 inbuf++;
683 i_len--;
685 outbuf += 2;
686 o_len -= 2;
688 if (o_len == 0 || i_len == 0)
689 goto out;
691 /* Keep trying with the next char... */
692 goto again;
694 } else if (from != CH_UTF16LE && from != CH_UTF16BE &&
695 to != CH_UTF16LE && to != CH_UTF16BE) {
696 /* Failed multibyte to multibyte. Just copy the default fail char and
697 try again. */
698 outbuf[0] = lp_failed_convert_char();
700 inbuf++;
701 i_len--;
703 outbuf++;
704 o_len--;
706 if (o_len == 0 || i_len == 0)
707 goto out;
709 /* Keep trying with the next char... */
710 goto again;
712 } else {
713 /* Keep compiler happy.... */
714 goto out;
720 * Convert between character sets, allocating a new buffer using talloc for the result.
722 * @param srclen length of source buffer.
723 * @param dest always set at least to NULL
724 * @note -1 is not accepted for srclen.
726 * @returns Size in bytes of the converted string; or -1 in case of error.
728 size_t convert_string_talloc(TALLOC_CTX *ctx, charset_t from, charset_t to,
729 void const *src, size_t srclen, void *dst,
730 BOOL allow_bad_conv)
732 void **dest = (void **)dst;
733 size_t dest_len;
735 *dest = NULL;
736 dest_len=convert_string_allocate(ctx, from, to, src, srclen, dest, allow_bad_conv);
737 if (dest_len == (size_t)-1)
738 return (size_t)-1;
739 if (*dest == NULL)
740 return (size_t)-1;
741 return dest_len;
744 size_t unix_strupper(const char *src, size_t srclen, char *dest, size_t destlen)
746 size_t size;
747 smb_ucs2_t *buffer;
749 size = push_ucs2_allocate(&buffer, src);
750 if (size == (size_t)-1) {
751 smb_panic("failed to create UCS2 buffer");
753 if (!strupper_w(buffer) && (dest == src)) {
754 free(buffer);
755 return srclen;
758 size = convert_string(CH_UTF16LE, CH_UNIX, buffer, size, dest, destlen, True);
759 free(buffer);
760 return size;
764 strdup() a unix string to upper case.
765 Max size is pstring.
768 char *strdup_upper(const char *s)
770 pstring out_buffer;
771 const unsigned char *p = (const unsigned char *)s;
772 unsigned char *q = (unsigned char *)out_buffer;
774 /* this is quite a common operation, so we want it to be
775 fast. We optimise for the ascii case, knowing that all our
776 supported multi-byte character sets are ascii-compatible
777 (ie. they match for the first 128 chars) */
779 while (1) {
780 if (*p & 0x80)
781 break;
782 *q++ = toupper_ascii(*p);
783 if (!*p)
784 break;
785 p++;
786 if (p - ( const unsigned char *)s >= sizeof(pstring))
787 break;
790 if (*p) {
791 /* MB case. */
792 size_t size;
793 wpstring buffer;
794 size = convert_string(CH_UNIX, CH_UTF16LE, s, -1, buffer, sizeof(buffer), True);
795 if (size == (size_t)-1) {
796 return NULL;
799 strupper_w(buffer);
801 size = convert_string(CH_UTF16LE, CH_UNIX, buffer, -1, out_buffer, sizeof(out_buffer), True);
802 if (size == (size_t)-1) {
803 return NULL;
807 return SMB_STRDUP(out_buffer);
810 size_t unix_strlower(const char *src, size_t srclen, char *dest, size_t destlen)
812 size_t size;
813 smb_ucs2_t *buffer = NULL;
815 size = convert_string_allocate(NULL, CH_UNIX, CH_UTF16LE, src, srclen,
816 (void **)(void *)&buffer, True);
817 if (size == (size_t)-1 || !buffer) {
818 smb_panic("failed to create UCS2 buffer");
820 if (!strlower_w(buffer) && (dest == src)) {
821 SAFE_FREE(buffer);
822 return srclen;
824 size = convert_string(CH_UTF16LE, CH_UNIX, buffer, size, dest, destlen, True);
825 SAFE_FREE(buffer);
826 return size;
830 strdup() a unix string to lower case.
833 char *strdup_lower(const char *s)
835 size_t size;
836 smb_ucs2_t *buffer = NULL;
837 char *out_buffer;
839 size = push_ucs2_allocate(&buffer, s);
840 if (size == -1 || !buffer) {
841 return NULL;
844 strlower_w(buffer);
846 size = pull_ucs2_allocate(&out_buffer, buffer);
847 SAFE_FREE(buffer);
849 if (size == (size_t)-1) {
850 return NULL;
853 return out_buffer;
856 static size_t ucs2_align(const void *base_ptr, const void *p, int flags)
858 if (flags & (STR_NOALIGN|STR_ASCII))
859 return 0;
860 return PTR_DIFF(p, base_ptr) & 1;
865 * Copy a string from a char* unix src to a dos codepage string destination.
867 * @return the number of bytes occupied by the string in the destination.
869 * @param flags can include
870 * <dl>
871 * <dt>STR_TERMINATE</dt> <dd>means include the null termination</dd>
872 * <dt>STR_UPPER</dt> <dd>means uppercase in the destination</dd>
873 * </dl>
875 * @param dest_len the maximum length in bytes allowed in the
876 * destination. If @p dest_len is -1 then no maximum is used.
878 size_t push_ascii(void *dest, const char *src, size_t dest_len, int flags)
880 size_t src_len = strlen(src);
881 pstring tmpbuf;
882 size_t ret;
884 /* No longer allow a length of -1 */
885 if (dest_len == (size_t)-1)
886 smb_panic("push_ascii - dest_len == -1");
888 if (flags & STR_UPPER) {
889 pstrcpy(tmpbuf, src);
890 strupper_m(tmpbuf);
891 src = tmpbuf;
894 if (flags & (STR_TERMINATE | STR_TERMINATE_ASCII))
895 src_len++;
897 ret =convert_string(CH_UNIX, CH_DOS, src, src_len, dest, dest_len, True);
898 if (ret == (size_t)-1 &&
899 (flags & (STR_TERMINATE | STR_TERMINATE_ASCII))
900 && dest_len > 0) {
901 ((char *)dest)[0] = '\0';
903 return ret;
906 size_t push_ascii_fstring(void *dest, const char *src)
908 return push_ascii(dest, src, sizeof(fstring), STR_TERMINATE);
911 size_t push_ascii_pstring(void *dest, const char *src)
913 return push_ascii(dest, src, sizeof(pstring), STR_TERMINATE);
916 /********************************************************************
917 Push an nstring - ensure null terminated. Written by
918 moriyama@miraclelinux.com (MORIYAMA Masayuki).
919 ********************************************************************/
921 size_t push_ascii_nstring(void *dest, const char *src)
923 size_t i, buffer_len, dest_len;
924 smb_ucs2_t *buffer;
926 conv_silent = True;
927 buffer_len = push_ucs2_allocate(&buffer, src);
928 if (buffer_len == (size_t)-1) {
929 smb_panic("failed to create UCS2 buffer");
932 /* We're using buffer_len below to count ucs2 characters, not bytes. */
933 buffer_len /= sizeof(smb_ucs2_t);
935 dest_len = 0;
936 for (i = 0; buffer[i] != 0 && (i < buffer_len); i++) {
937 unsigned char mb[10];
938 /* Convert one smb_ucs2_t character at a time. */
939 size_t mb_len = convert_string(CH_UTF16LE, CH_DOS, buffer+i, sizeof(smb_ucs2_t), mb, sizeof(mb), False);
940 if ((mb_len != (size_t)-1) && (dest_len + mb_len <= MAX_NETBIOSNAME_LEN - 1)) {
941 memcpy((char *)dest + dest_len, mb, mb_len);
942 dest_len += mb_len;
943 } else {
944 errno = E2BIG;
945 break;
948 ((char *)dest)[dest_len] = '\0';
950 SAFE_FREE(buffer);
951 conv_silent = False;
952 return dest_len;
956 * Copy a string from a dos codepage source to a unix char* destination.
958 * The resulting string in "dest" is always null terminated.
960 * @param flags can have:
961 * <dl>
962 * <dt>STR_TERMINATE</dt>
963 * <dd>STR_TERMINATE means the string in @p src
964 * is null terminated, and src_len is ignored.</dd>
965 * </dl>
967 * @param src_len is the length of the source area in bytes.
968 * @returns the number of bytes occupied by the string in @p src.
970 size_t pull_ascii(char *dest, const void *src, size_t dest_len, size_t src_len, int flags)
972 size_t ret;
974 if (dest_len == (size_t)-1)
975 dest_len = sizeof(pstring);
977 if (flags & STR_TERMINATE) {
978 if (src_len == (size_t)-1) {
979 src_len = strlen((const char *)src) + 1;
980 } else {
981 size_t len = strnlen((const char *)src, src_len);
982 if (len < src_len)
983 len++;
984 src_len = len;
988 ret = convert_string(CH_DOS, CH_UNIX, src, src_len, dest, dest_len, True);
989 if (ret == (size_t)-1) {
990 ret = 0;
991 dest_len = 0;
994 if (dest_len && ret) {
995 /* Did we already process the terminating zero ? */
996 if (dest[MIN(ret-1, dest_len-1)] != 0) {
997 dest[MIN(ret, dest_len-1)] = 0;
999 } else {
1000 dest[0] = 0;
1003 return src_len;
1006 size_t pull_ascii_pstring(char *dest, const void *src)
1008 return pull_ascii(dest, src, sizeof(pstring), -1, STR_TERMINATE);
1011 size_t pull_ascii_fstring(char *dest, const void *src)
1013 return pull_ascii(dest, src, sizeof(fstring), -1, STR_TERMINATE);
1016 /* When pulling an nstring it can expand into a larger size (dos cp -> utf8). Cope with this. */
1018 size_t pull_ascii_nstring(char *dest, size_t dest_len, const void *src)
1020 return pull_ascii(dest, src, dest_len, sizeof(nstring)-1, STR_TERMINATE);
1024 * Copy a string from a char* src to a unicode destination.
1026 * @returns the number of bytes occupied by the string in the destination.
1028 * @param flags can have:
1030 * <dl>
1031 * <dt>STR_TERMINATE <dd>means include the null termination.
1032 * <dt>STR_UPPER <dd>means uppercase in the destination.
1033 * <dt>STR_NOALIGN <dd>means don't do alignment.
1034 * </dl>
1036 * @param dest_len is the maximum length allowed in the
1037 * destination. If dest_len is -1 then no maxiumum is used.
1040 size_t push_ucs2(const void *base_ptr, void *dest, const char *src, size_t dest_len, int flags)
1042 size_t len=0;
1043 size_t src_len;
1044 size_t ret;
1046 /* treat a pstring as "unlimited" length */
1047 if (dest_len == (size_t)-1)
1048 dest_len = sizeof(pstring);
1050 if (flags & STR_TERMINATE)
1051 src_len = (size_t)-1;
1052 else
1053 src_len = strlen(src);
1055 if (ucs2_align(base_ptr, dest, flags)) {
1056 *(char *)dest = 0;
1057 dest = (void *)((char *)dest + 1);
1058 if (dest_len)
1059 dest_len--;
1060 len++;
1063 /* ucs2 is always a multiple of 2 bytes */
1064 dest_len &= ~1;
1066 ret = convert_string(CH_UNIX, CH_UTF16LE, src, src_len, dest, dest_len, True);
1067 if (ret == (size_t)-1) {
1068 return 0;
1071 len += ret;
1073 if (flags & STR_UPPER) {
1074 smb_ucs2_t *dest_ucs2 = (smb_ucs2_t *)dest;
1075 size_t i;
1077 /* We check for i < (ret / 2) below as the dest string isn't null
1078 terminated if STR_TERMINATE isn't set. */
1080 for (i = 0; i < (ret / 2) && i < (dest_len / 2) && dest_ucs2[i]; i++) {
1081 smb_ucs2_t v = toupper_w(dest_ucs2[i]);
1082 if (v != dest_ucs2[i]) {
1083 dest_ucs2[i] = v;
1088 return len;
1093 * Copy a string from a unix char* src to a UCS2 destination,
1094 * allocating a buffer using talloc().
1096 * @param dest always set at least to NULL
1098 * @returns The number of bytes occupied by the string in the destination
1099 * or -1 in case of error.
1101 size_t push_ucs2_talloc(TALLOC_CTX *ctx, smb_ucs2_t **dest, const char *src)
1103 size_t src_len = strlen(src)+1;
1105 *dest = NULL;
1106 return convert_string_talloc(ctx, CH_UNIX, CH_UTF16LE, src, src_len, (void **)dest, True);
1111 * Copy a string from a unix char* src to a UCS2 destination, allocating a buffer
1113 * @param dest always set at least to NULL
1115 * @returns The number of bytes occupied by the string in the destination
1116 * or -1 in case of error.
1119 size_t push_ucs2_allocate(smb_ucs2_t **dest, const char *src)
1121 size_t src_len = strlen(src)+1;
1123 *dest = NULL;
1124 return convert_string_allocate(NULL, CH_UNIX, CH_UTF16LE, src, src_len, (void **)dest, True);
1128 Copy a string from a char* src to a UTF-8 destination.
1129 Return the number of bytes occupied by the string in the destination
1130 Flags can have:
1131 STR_TERMINATE means include the null termination
1132 STR_UPPER means uppercase in the destination
1133 dest_len is the maximum length allowed in the destination. If dest_len
1134 is -1 then no maxiumum is used.
1137 static size_t push_utf8(void *dest, const char *src, size_t dest_len, int flags)
1139 size_t src_len = strlen(src);
1140 pstring tmpbuf;
1142 /* treat a pstring as "unlimited" length */
1143 if (dest_len == (size_t)-1)
1144 dest_len = sizeof(pstring);
1146 if (flags & STR_UPPER) {
1147 pstrcpy(tmpbuf, src);
1148 strupper_m(tmpbuf);
1149 src = tmpbuf;
1152 if (flags & STR_TERMINATE)
1153 src_len++;
1155 return convert_string(CH_UNIX, CH_UTF8, src, src_len, dest, dest_len, True);
1158 size_t push_utf8_fstring(void *dest, const char *src)
1160 return push_utf8(dest, src, sizeof(fstring), STR_TERMINATE);
1164 * Copy a string from a unix char* src to a UTF-8 destination, allocating a buffer using talloc
1166 * @param dest always set at least to NULL
1168 * @returns The number of bytes occupied by the string in the destination
1171 size_t push_utf8_talloc(TALLOC_CTX *ctx, char **dest, const char *src)
1173 size_t src_len = strlen(src)+1;
1175 *dest = NULL;
1176 return convert_string_talloc(ctx, CH_UNIX, CH_UTF8, src, src_len, (void**)dest, True);
1180 * Copy a string from a unix char* src to a UTF-8 destination, allocating a buffer
1182 * @param dest always set at least to NULL
1184 * @returns The number of bytes occupied by the string in the destination
1187 size_t push_utf8_allocate(char **dest, const char *src)
1189 size_t src_len = strlen(src)+1;
1191 *dest = NULL;
1192 return convert_string_allocate(NULL, CH_UNIX, CH_UTF8, src, src_len, (void **)dest, True);
1196 Copy a string from a ucs2 source to a unix char* destination.
1197 Flags can have:
1198 STR_TERMINATE means the string in src is null terminated.
1199 STR_NOALIGN means don't try to align.
1200 if STR_TERMINATE is set then src_len is ignored if it is -1.
1201 src_len is the length of the source area in bytes
1202 Return the number of bytes occupied by the string in src.
1203 The resulting string in "dest" is always null terminated.
1206 size_t pull_ucs2(const void *base_ptr, char *dest, const void *src, size_t dest_len, size_t src_len, int flags)
1208 size_t ret;
1210 if (dest_len == (size_t)-1)
1211 dest_len = sizeof(pstring);
1213 if (ucs2_align(base_ptr, src, flags)) {
1214 src = (const void *)((const char *)src + 1);
1215 if (src_len != (size_t)-1)
1216 src_len--;
1219 if (flags & STR_TERMINATE) {
1220 /* src_len -1 is the default for null terminated strings. */
1221 if (src_len != (size_t)-1) {
1222 size_t len = strnlen_w((const smb_ucs2_t *)src,
1223 src_len/2);
1224 if (len < src_len/2)
1225 len++;
1226 src_len = len*2;
1230 /* ucs2 is always a multiple of 2 bytes */
1231 if (src_len != (size_t)-1)
1232 src_len &= ~1;
1234 ret = convert_string(CH_UTF16LE, CH_UNIX, src, src_len, dest, dest_len, True);
1235 if (ret == (size_t)-1) {
1236 return 0;
1239 if (src_len == (size_t)-1)
1240 src_len = ret*2;
1242 if (dest_len && ret) {
1243 /* Did we already process the terminating zero ? */
1244 if (dest[MIN(ret-1, dest_len-1)] != 0) {
1245 dest[MIN(ret, dest_len-1)] = 0;
1247 } else {
1248 dest[0] = 0;
1251 return src_len;
1254 size_t pull_ucs2_pstring(char *dest, const void *src)
1256 return pull_ucs2(NULL, dest, src, sizeof(pstring), -1, STR_TERMINATE);
1259 size_t pull_ucs2_fstring(char *dest, const void *src)
1261 return pull_ucs2(NULL, dest, src, sizeof(fstring), -1, STR_TERMINATE);
1265 * Copy a string from a UCS2 src to a unix char * destination, allocating a buffer using talloc
1267 * @param dest always set at least to NULL
1269 * @returns The number of bytes occupied by the string in the destination
1272 size_t pull_ucs2_talloc(TALLOC_CTX *ctx, char **dest, const smb_ucs2_t *src)
1274 size_t src_len = (strlen_w(src)+1) * sizeof(smb_ucs2_t);
1275 *dest = NULL;
1276 return convert_string_talloc(ctx, CH_UTF16LE, CH_UNIX, src, src_len, (void **)dest, True);
1280 * Copy a string from a UCS2 src to a unix char * destination, allocating a buffer
1282 * @param dest always set at least to NULL
1284 * @returns The number of bytes occupied by the string in the destination
1287 size_t pull_ucs2_allocate(char **dest, const smb_ucs2_t *src)
1289 size_t src_len = (strlen_w(src)+1) * sizeof(smb_ucs2_t);
1290 *dest = NULL;
1291 return convert_string_allocate(NULL, CH_UTF16LE, CH_UNIX, src, src_len, (void **)dest, True);
1295 * Copy a string from a UTF-8 src to a unix char * destination, allocating a buffer using talloc
1297 * @param dest always set at least to NULL
1299 * @returns The number of bytes occupied by the string in the destination
1302 size_t pull_utf8_talloc(TALLOC_CTX *ctx, char **dest, const char *src)
1304 size_t src_len = strlen(src)+1;
1305 *dest = NULL;
1306 return convert_string_talloc(ctx, CH_UTF8, CH_UNIX, src, src_len, (void **)dest, True);
1310 * Copy a string from a UTF-8 src to a unix char * destination, allocating a buffer
1312 * @param dest always set at least to NULL
1314 * @returns The number of bytes occupied by the string in the destination
1317 size_t pull_utf8_allocate(char **dest, const char *src)
1319 size_t src_len = strlen(src)+1;
1320 *dest = NULL;
1321 return convert_string_allocate(NULL, CH_UTF8, CH_UNIX, src, src_len, (void **)dest, True);
1325 * Copy a string from a DOS src to a unix char * destination, allocating a buffer using talloc
1327 * @param dest always set at least to NULL
1329 * @returns The number of bytes occupied by the string in the destination
1332 size_t pull_ascii_talloc(TALLOC_CTX *ctx, char **dest, const char *src)
1334 size_t src_len = strlen(src)+1;
1335 *dest = NULL;
1336 return convert_string_talloc(ctx, CH_DOS, CH_UNIX, src, src_len, (void **)dest, True);
1340 Copy a string from a char* src to a unicode or ascii
1341 dos codepage destination choosing unicode or ascii based on the
1342 flags in the SMB buffer starting at base_ptr.
1343 Return the number of bytes occupied by the string in the destination.
1344 flags can have:
1345 STR_TERMINATE means include the null termination.
1346 STR_UPPER means uppercase in the destination.
1347 STR_ASCII use ascii even with unicode packet.
1348 STR_NOALIGN means don't do alignment.
1349 dest_len is the maximum length allowed in the destination. If dest_len
1350 is -1 then no maxiumum is used.
1353 size_t push_string_fn(const char *function, unsigned int line, const void *base_ptr, void *dest, const char *src, size_t dest_len, int flags)
1355 #ifdef DEVELOPER
1356 /* We really need to zero fill here, not clobber
1357 * region, as we want to ensure that valgrind thinks
1358 * all of the outgoing buffer has been written to
1359 * so a send() or write() won't trap an error.
1360 * JRA.
1362 #if 0
1363 if (dest_len != (size_t)-1)
1364 clobber_region(function, line, dest, dest_len);
1365 #else
1366 if (dest_len != (size_t)-1)
1367 memset(dest, '\0', dest_len);
1368 #endif
1369 #endif
1371 if (!(flags & STR_ASCII) && \
1372 ((flags & STR_UNICODE || \
1373 (SVAL(base_ptr, smb_flg2) & FLAGS2_UNICODE_STRINGS)))) {
1374 return push_ucs2(base_ptr, dest, src, dest_len, flags);
1376 return push_ascii(dest, src, dest_len, flags);
1381 Copy a string from a unicode or ascii source (depending on
1382 the packet flags) to a char* destination.
1383 Flags can have:
1384 STR_TERMINATE means the string in src is null terminated.
1385 STR_UNICODE means to force as unicode.
1386 STR_ASCII use ascii even with unicode packet.
1387 STR_NOALIGN means don't do alignment.
1388 if STR_TERMINATE is set then src_len is ignored is it is -1
1389 src_len is the length of the source area in bytes.
1390 Return the number of bytes occupied by the string in src.
1391 The resulting string in "dest" is always null terminated.
1394 size_t pull_string_fn(const char *function, unsigned int line, const void *base_ptr, char *dest, const void *src, size_t dest_len, size_t src_len, int flags)
1396 #ifdef DEVELOPER
1397 if (dest_len != (size_t)-1)
1398 clobber_region(function, line, dest, dest_len);
1399 #endif
1401 if (!(flags & STR_ASCII) && \
1402 ((flags & STR_UNICODE || \
1403 (SVAL(base_ptr, smb_flg2) & FLAGS2_UNICODE_STRINGS)))) {
1404 return pull_ucs2(base_ptr, dest, src, dest_len, src_len, flags);
1406 return pull_ascii(dest, src, dest_len, src_len, flags);
1409 size_t align_string(const void *base_ptr, const char *p, int flags)
1411 if (!(flags & STR_ASCII) && \
1412 ((flags & STR_UNICODE || \
1413 (SVAL(base_ptr, smb_flg2) & FLAGS2_UNICODE_STRINGS)))) {
1414 return ucs2_align(base_ptr, p, flags);
1416 return 0;
1420 Return the unicode codepoint for the next multi-byte CH_UNIX character
1421 in the string. The unicode codepoint (codepoint_t) is an unsinged 32 bit value.
1423 Also return the number of bytes consumed (which tells the caller
1424 how many bytes to skip to get to the next CH_UNIX character).
1426 Return INVALID_CODEPOINT if the next character cannot be converted.
1429 codepoint_t next_codepoint(const char *str, size_t *size)
1431 /* It cannot occupy more than 4 bytes in UTF16 format */
1432 uint8_t buf[4];
1433 smb_iconv_t descriptor;
1434 size_t ilen_orig;
1435 size_t ilen;
1436 size_t olen;
1437 char *outbuf;
1439 if ((str[0] & 0x80) == 0) {
1440 *size = 1;
1441 return (codepoint_t)str[0];
1444 /* We assume that no multi-byte character can take
1445 more than 5 bytes. This is OK as we only
1446 support codepoints up to 1M */
1448 ilen_orig = strnlen(str, 5);
1449 ilen = ilen_orig;
1451 lazy_initialize_conv();
1453 descriptor = conv_handles[CH_UNIX][CH_UTF16LE];
1454 if (descriptor == (smb_iconv_t)-1 || descriptor == (smb_iconv_t)0) {
1455 *size = 1;
1456 return INVALID_CODEPOINT;
1459 /* This looks a little strange, but it is needed to cope
1460 with codepoints above 64k which are encoded as per RFC2781. */
1461 olen = 2;
1462 outbuf = (char *)buf;
1463 smb_iconv(descriptor, &str, &ilen, &outbuf, &olen);
1464 if (olen == 2) {
1465 /* We failed to convert to a 2 byte character.
1466 See if we can convert to a 4 UTF16-LE byte char encoding.
1468 olen = 4;
1469 outbuf = (char *)buf;
1470 smb_iconv(descriptor, &str, &ilen, &outbuf, &olen);
1471 if (olen == 4) {
1472 /* We didn't convert any bytes */
1473 *size = 1;
1474 return INVALID_CODEPOINT;
1476 olen = 4 - olen;
1477 } else {
1478 olen = 2 - olen;
1481 *size = ilen_orig - ilen;
1483 if (olen == 2) {
1484 /* 2 byte, UTF16-LE encoded value. */
1485 return (codepoint_t)SVAL(buf, 0);
1487 if (olen == 4) {
1488 /* Decode a 4 byte UTF16-LE character manually.
1489 See RFC2871 for the encoding machanism.
1491 codepoint_t w1 = SVAL(buf,0) & ~0xD800;
1492 codepoint_t w2 = SVAL(buf,2) & ~0xDC00;
1494 return (codepoint_t)0x10000 +
1495 (w1 << 10) + w2;
1498 /* no other length is valid */
1499 return INVALID_CODEPOINT;