Change strupper_m() to return a value.
[Samba.git] / source3 / lib / util_str.c
blobf97cd3cc25e16b1fd0b54bd03030d4ba408cf44e
1 /*
2 Unix SMB/CIFS implementation.
3 Samba utility functions
5 Copyright (C) Andrew Tridgell 1992-2001
6 Copyright (C) Simo Sorce 2001-2002
7 Copyright (C) Martin Pool 2003
8 Copyright (C) James Peach 2006
9 Copyright (C) Jeremy Allison 1992-2007
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include "includes.h"
26 #include "lib/param/loadparm.h"
28 const char toupper_ascii_fast_table[128] = {
29 0x0, 0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8, 0x9, 0xa, 0xb, 0xc, 0xd, 0xe, 0xf,
30 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x19, 0x1a, 0x1b, 0x1c, 0x1d, 0x1e, 0x1f,
31 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2a, 0x2b, 0x2c, 0x2d, 0x2e, 0x2f,
32 0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3a, 0x3b, 0x3c, 0x3d, 0x3e, 0x3f,
33 0x40, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f,
34 0x50, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a, 0x5b, 0x5c, 0x5d, 0x5e, 0x5f,
35 0x60, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f,
36 0x50, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a, 0x7b, 0x7c, 0x7d, 0x7e, 0x7f
39 /**
40 * Compare 2 strings up to and including the nth char.
42 * @note The comparison is case-insensitive.
43 **/
44 bool strnequal(const char *s1,const char *s2,size_t n)
46 if (s1 == s2)
47 return(true);
48 if (!s1 || !s2 || !n)
49 return(false);
51 return(strncasecmp_m(s1,s2,n)==0);
54 /**
55 Convert a string to "normal" form.
56 **/
58 void strnorm(char *s, int case_default)
60 if (case_default == CASE_UPPER)
61 strupper_m(s);
62 else
63 strlower_m(s);
66 /**
67 * Skip past some strings in a buffer - old version - no checks.
68 * **/
70 char *push_skip_string(char *buf)
72 buf += strlen(buf) + 1;
73 return(buf);
76 /**
77 Skip past a string in a buffer. Buffer may not be
78 null terminated. end_ptr points to the first byte after
79 then end of the buffer.
80 **/
82 char *skip_string(const char *base, size_t len, char *buf)
84 const char *end_ptr = base + len;
86 if (end_ptr < base || !base || !buf || buf >= end_ptr) {
87 return NULL;
90 /* Skip the string */
91 while (*buf) {
92 buf++;
93 if (buf >= end_ptr) {
94 return NULL;
97 /* Skip the '\0' */
98 buf++;
99 return buf;
103 Count the number of characters in a string. Normally this will
104 be the same as the number of bytes in a string for single byte strings,
105 but will be different for multibyte.
108 size_t str_charnum(const char *s)
110 size_t ret, converted_size;
111 smb_ucs2_t *tmpbuf2 = NULL;
112 if (!push_ucs2_talloc(talloc_tos(), &tmpbuf2, s, &converted_size)) {
113 return 0;
115 ret = strlen_w(tmpbuf2);
116 TALLOC_FREE(tmpbuf2);
117 return ret;
120 bool trim_char(char *s,char cfront,char cback)
122 bool ret = false;
123 char *ep;
124 char *fp = s;
126 /* Ignore null or empty strings. */
127 if (!s || (s[0] == '\0'))
128 return false;
130 if (cfront) {
131 while (*fp && *fp == cfront)
132 fp++;
133 if (!*fp) {
134 /* We ate the string. */
135 s[0] = '\0';
136 return true;
138 if (fp != s)
139 ret = true;
142 ep = fp + strlen(fp) - 1;
143 if (cback) {
144 /* Attempt ascii only. Bail for mb strings. */
145 while ((ep >= fp) && (*ep == cback)) {
146 ret = true;
147 if ((ep > fp) && (((unsigned char)ep[-1]) & 0x80)) {
148 /* Could be mb... bail back to tim_string. */
149 char fs[2], bs[2];
150 if (cfront) {
151 fs[0] = cfront;
152 fs[1] = '\0';
154 bs[0] = cback;
155 bs[1] = '\0';
156 return trim_string(s, cfront ? fs : NULL, bs);
157 } else {
158 ep--;
161 if (ep < fp) {
162 /* We ate the string. */
163 s[0] = '\0';
164 return true;
168 ep[1] = '\0';
169 memmove(s, fp, ep-fp+2);
170 return ret;
174 Like strncpy but always null terminates. Make sure there is room!
175 The variable n should always be one less than the available size.
177 char *StrnCpy(char *dest,const char *src,size_t n)
179 char *d = dest;
181 if (!dest) {
182 smb_panic("ERROR: NULL dest in StrnCpy");
185 if (!src) {
186 *dest = 0;
187 return(dest);
190 while (n-- && (*d = *src)) {
191 d++;
192 src++;
195 *d = 0;
196 return(dest);
200 Check if a string is part of a list.
203 bool in_list(const char *s, const char *list, bool casesensitive)
205 char *tok = NULL;
206 bool ret = false;
207 TALLOC_CTX *frame;
209 if (!list) {
210 return false;
213 frame = talloc_stackframe();
214 while (next_token_talloc(frame, &list, &tok,LIST_SEP)) {
215 if (casesensitive) {
216 if (strcmp(tok,s) == 0) {
217 ret = true;
218 break;
220 } else {
221 if (strcasecmp_m(tok,s) == 0) {
222 ret = true;
223 break;
227 TALLOC_FREE(frame);
228 return ret;
232 * Internal guts of talloc_string_sub and talloc_all_string_sub.
233 * talloc version of string_sub2.
236 char *talloc_string_sub2(TALLOC_CTX *mem_ctx, const char *src,
237 const char *pattern,
238 const char *insert,
239 bool remove_unsafe_characters,
240 bool replace_once,
241 bool allow_trailing_dollar)
243 char *p, *in;
244 char *s;
245 char *string;
246 ssize_t ls,lp,li,ld, i;
248 if (!insert || !pattern || !*pattern || !src) {
249 return NULL;
252 string = talloc_strdup(mem_ctx, src);
253 if (string == NULL) {
254 DEBUG(0, ("talloc_string_sub2: "
255 "talloc_strdup failed\n"));
256 return NULL;
259 s = string;
261 in = talloc_strdup(mem_ctx, insert);
262 if (!in) {
263 DEBUG(0, ("talloc_string_sub2: ENOMEM\n"));
264 return NULL;
266 ls = (ssize_t)strlen(s);
267 lp = (ssize_t)strlen(pattern);
268 li = (ssize_t)strlen(insert);
269 ld = li - lp;
271 for (i=0;i<li;i++) {
272 switch (in[i]) {
273 case '$':
274 /* allow a trailing $
275 * (as in machine accounts) */
276 if (allow_trailing_dollar && (i == li - 1 )) {
277 break;
279 case '`':
280 case '"':
281 case '\'':
282 case ';':
283 case '%':
284 case '\r':
285 case '\n':
286 if (remove_unsafe_characters) {
287 in[i] = '_';
288 break;
290 default:
291 /* ok */
292 break;
296 while ((p = strstr_m(s,pattern))) {
297 if (ld > 0) {
298 int offset = PTR_DIFF(s,string);
299 string = (char *)TALLOC_REALLOC(mem_ctx, string,
300 ls + ld + 1);
301 if (!string) {
302 DEBUG(0, ("talloc_string_sub: out of "
303 "memory!\n"));
304 TALLOC_FREE(in);
305 return NULL;
307 p = string + offset + (p - s);
309 if (li != lp) {
310 memmove(p+li,p+lp,strlen(p+lp)+1);
312 memcpy(p, in, li);
313 s = p + li;
314 ls += ld;
316 if (replace_once) {
317 break;
320 TALLOC_FREE(in);
321 return string;
324 /* Same as string_sub, but returns a talloc'ed string */
326 char *talloc_string_sub(TALLOC_CTX *mem_ctx,
327 const char *src,
328 const char *pattern,
329 const char *insert)
331 return talloc_string_sub2(mem_ctx, src, pattern, insert,
332 true, false, false);
335 char *talloc_all_string_sub(TALLOC_CTX *ctx,
336 const char *src,
337 const char *pattern,
338 const char *insert)
340 return talloc_string_sub2(ctx, src, pattern, insert,
341 false, false, false);
345 Write an octal as a string.
348 char *octal_string(int i)
350 char *result;
351 if (i == -1) {
352 result = talloc_strdup(talloc_tos(), "-1");
354 else {
355 result = talloc_asprintf(talloc_tos(), "0%o", i);
357 SMB_ASSERT(result != NULL);
358 return result;
363 Truncate a string at a specified length.
366 char *string_truncate(char *s, unsigned int length)
368 if (s && strlen(s) > length)
369 s[length] = 0;
370 return s;
374 /***********************************************************************
375 Return the equivalent of doing strrchr 'n' times - always going
376 backwards.
377 ***********************************************************************/
379 char *strnrchr_m(const char *s, char c, unsigned int n)
381 smb_ucs2_t *ws = NULL;
382 char *s2 = NULL;
383 smb_ucs2_t *p;
384 char *ret;
385 size_t converted_size;
387 if (!push_ucs2_talloc(talloc_tos(), &ws, s, &converted_size)) {
388 /* Too hard to try and get right. */
389 return NULL;
391 p = strnrchr_w(ws, UCS2_CHAR(c), n);
392 if (!p) {
393 TALLOC_FREE(ws);
394 return NULL;
396 *p = 0;
397 if (!pull_ucs2_talloc(talloc_tos(), &s2, ws, &converted_size)) {
398 TALLOC_FREE(ws);
399 /* Too hard to try and get right. */
400 return NULL;
402 ret = discard_const_p(char, (s+strlen(s2)));
403 TALLOC_FREE(ws);
404 TALLOC_FREE(s2);
405 return ret;
408 static bool unix_strlower(const char *src, size_t srclen, char *dest, size_t destlen)
410 size_t size;
411 smb_ucs2_t *buffer = NULL;
412 bool ret;
414 if (!convert_string_talloc(talloc_tos(), CH_UNIX, CH_UTF16LE, src, srclen,
415 (void **)(void *)&buffer, &size))
417 smb_panic("failed to create UCS2 buffer");
418 /* NOTREACHED. Yet. */
419 return false;
421 if (!strlower_w(buffer) && (dest == src)) {
422 TALLOC_FREE(buffer);
423 return true;
425 ret = convert_string(CH_UTF16LE, CH_UNIX, buffer, size, dest, destlen, &size);
426 TALLOC_FREE(buffer);
427 return ret;
430 #if 0 /* Alternate function that avoid talloc calls for ASCII and non ASCII */
433 Convert a string to lower case.
435 _PUBLIC_ void strlower_m(char *s)
437 char *d;
438 struct smb_iconv_handle *iconv_handle;
440 iconv_handle = get_iconv_handle();
442 d = s;
444 while (*s) {
445 size_t c_size, c_size2;
446 codepoint_t c = next_codepoint_handle(iconv_handle, s, &c_size);
447 c_size2 = push_codepoint_handle(iconv_handle, d, tolower_m(c));
448 if (c_size2 > c_size) {
449 DEBUG(0,("FATAL: codepoint 0x%x (0x%x) expanded from %d to %d bytes in strlower_m\n",
450 c, tolower_m(c), (int)c_size, (int)c_size2));
451 smb_panic("codepoint expansion in strlower_m\n");
453 s += c_size;
454 d += c_size2;
456 *d = 0;
459 #endif
462 Convert a string to lower case.
465 void strlower_m(char *s)
467 size_t len;
468 int errno_save;
470 /* this is quite a common operation, so we want it to be
471 fast. We optimise for the ascii case, knowing that all our
472 supported multi-byte character sets are ascii-compatible
473 (ie. they match for the first 128 chars) */
475 while (*s && !(((unsigned char)s[0]) & 0x80)) {
476 *s = tolower_m((unsigned char)*s);
477 s++;
480 if (!*s)
481 return;
483 /* I assume that lowercased string takes the same number of bytes
484 * as source string even in UTF-8 encoding. (VIV) */
485 len = strlen(s) + 1;
486 errno_save = errno;
487 errno = 0;
488 unix_strlower(s,len,s,len);
489 /* Catch mb conversion errors that may not terminate. */
490 if (errno)
491 s[len-1] = '\0';
492 errno = errno_save;
495 static bool unix_strupper(const char *src, size_t srclen, char *dest, size_t destlen)
497 size_t size;
498 smb_ucs2_t *buffer;
499 bool ret;
501 if (!push_ucs2_talloc(talloc_tos(), &buffer, src, &size)) {
502 return false;
505 if (!strupper_w(buffer) && (dest == src)) {
506 TALLOC_FREE(buffer);
507 return true;
510 ret = convert_string(CH_UTF16LE, CH_UNIX, buffer, size, dest, destlen, &size);
511 TALLOC_FREE(buffer);
512 return ret;
515 #if 0 /* Alternate function that avoid talloc calls for ASCII and non ASCII */
518 Convert a string to UPPER case.
520 _PUBLIC_ void strupper_m(char *s)
522 char *d;
523 struct smb_iconv_handle *iconv_handle;
525 iconv_handle = get_iconv_handle();
527 d = s;
529 while (*s) {
530 size_t c_size, c_size2;
531 codepoint_t c = next_codepoint_handle(iconv_handle, s, &c_size);
532 c_size2 = push_codepoint_handle(iconv_handle, d, toupper_m(c));
533 if (c_size2 > c_size) {
534 DEBUG(0,("FATAL: codepoint 0x%x (0x%x) expanded from %d to %d bytes in strupper_m\n",
535 c, toupper_m(c), (int)c_size, (int)c_size2));
536 smb_panic("codepoint expansion in strupper_m\n");
538 s += c_size;
539 d += c_size2;
541 *d = 0;
544 #endif
547 Convert a string to upper case.
550 bool strupper_m(char *s)
552 size_t len;
553 int errno_save;
554 bool ret = false;
556 /* this is quite a common operation, so we want it to be
557 fast. We optimise for the ascii case, knowing that all our
558 supported multi-byte character sets are ascii-compatible
559 (ie. they match for the first 128 chars) */
561 while (*s && !(((unsigned char)s[0]) & 0x80)) {
562 *s = toupper_ascii_fast((unsigned char)*s);
563 s++;
566 if (!*s)
567 return true;
569 /* I assume that lowercased string takes the same number of bytes
570 * as source string even in multibyte encoding. (VIV) */
571 len = strlen(s) + 1;
572 errno_save = errno;
573 errno = 0;
574 ret = unix_strupper(s,len,s,len);
575 /* Catch mb conversion errors that may not terminate. */
576 if (errno) {
577 s[len-1] = '\0';
578 ret = false;
580 errno = errno_save;
581 return ret;
585 Just a typesafety wrapper for snprintf into a fstring.
588 int fstr_sprintf(fstring s, const char *fmt, ...)
590 va_list ap;
591 int ret;
593 va_start(ap, fmt);
594 ret = vsnprintf(s, FSTRING_LEN, fmt, ap);
595 va_end(ap);
596 return ret;
600 List of Strings manipulation functions
603 #define S_LIST_ABS 16 /* List Allocation Block Size */
605 /******************************************************************************
606 substitute a specific pattern in a string list
607 *****************************************************************************/
609 bool str_list_substitute(char **list, const char *pattern, const char *insert)
611 TALLOC_CTX *ctx = list;
612 char *p, *s, *t;
613 ssize_t ls, lp, li, ld, i, d;
615 if (!list)
616 return false;
617 if (!pattern)
618 return false;
619 if (!insert)
620 return false;
622 lp = (ssize_t)strlen(pattern);
623 li = (ssize_t)strlen(insert);
624 ld = li -lp;
626 while (*list) {
627 s = *list;
628 ls = (ssize_t)strlen(s);
630 while ((p = strstr_m(s, pattern))) {
631 t = *list;
632 d = p -t;
633 if (ld) {
634 t = talloc_array(ctx, char, ls +ld +1);
635 if (!t) {
636 DEBUG(0,("str_list_substitute: "
637 "Unable to allocate memory"));
638 return false;
640 memcpy(t, *list, d);
641 memcpy(t +d +li, p +lp, ls -d -lp +1);
642 TALLOC_FREE(*list);
643 *list = t;
644 ls += ld;
645 s = t +d +li;
648 for (i = 0; i < li; i++) {
649 switch (insert[i]) {
650 case '`':
651 case '"':
652 case '\'':
653 case ';':
654 case '$':
655 case '%':
656 case '\r':
657 case '\n':
658 t[d +i] = '_';
659 break;
660 default:
661 t[d +i] = insert[i];
666 list++;
669 return true;
673 #define IPSTR_LIST_SEP ","
674 #define IPSTR_LIST_CHAR ','
677 * Add ip string representation to ipstr list. Used also
678 * as part of @function ipstr_list_make
680 * @param ipstr_list pointer to string containing ip list;
681 * MUST BE already allocated and IS reallocated if necessary
682 * @param ipstr_size pointer to current size of ipstr_list (might be changed
683 * as a result of reallocation)
684 * @param ip IP address which is to be added to list
685 * @return pointer to string appended with new ip and possibly
686 * reallocated to new length
689 static char *ipstr_list_add(char **ipstr_list, const struct ip_service *service)
691 char *new_ipstr = NULL;
692 char addr_buf[INET6_ADDRSTRLEN];
693 int ret;
695 /* arguments checking */
696 if (!ipstr_list || !service) {
697 return NULL;
700 print_sockaddr(addr_buf,
701 sizeof(addr_buf),
702 &service->ss);
704 /* attempt to convert ip to a string and append colon separator to it */
705 if (*ipstr_list) {
706 if (service->ss.ss_family == AF_INET) {
707 /* IPv4 */
708 ret = asprintf(&new_ipstr, "%s%s%s:%d", *ipstr_list,
709 IPSTR_LIST_SEP, addr_buf,
710 service->port);
711 } else {
712 /* IPv6 */
713 ret = asprintf(&new_ipstr, "%s%s[%s]:%d", *ipstr_list,
714 IPSTR_LIST_SEP, addr_buf,
715 service->port);
717 SAFE_FREE(*ipstr_list);
718 } else {
719 if (service->ss.ss_family == AF_INET) {
720 /* IPv4 */
721 ret = asprintf(&new_ipstr, "%s:%d", addr_buf,
722 service->port);
723 } else {
724 /* IPv6 */
725 ret = asprintf(&new_ipstr, "[%s]:%d", addr_buf,
726 service->port);
729 if (ret == -1) {
730 return NULL;
732 *ipstr_list = new_ipstr;
733 return *ipstr_list;
737 * Allocate and initialise an ipstr list using ip adresses
738 * passed as arguments.
740 * @param ipstr_list pointer to string meant to be allocated and set
741 * @param ip_list array of ip addresses to place in the list
742 * @param ip_count number of addresses stored in ip_list
743 * @return pointer to allocated ip string
746 char *ipstr_list_make(char **ipstr_list,
747 const struct ip_service *ip_list,
748 int ip_count)
750 int i;
752 /* arguments checking */
753 if (!ip_list || !ipstr_list) {
754 return 0;
757 *ipstr_list = NULL;
759 /* process ip addresses given as arguments */
760 for (i = 0; i < ip_count; i++) {
761 *ipstr_list = ipstr_list_add(ipstr_list, &ip_list[i]);
764 return (*ipstr_list);
769 * Parse given ip string list into array of ip addresses
770 * (as ip_service structures)
771 * e.g. [IPv6]:port,192.168.1.100:389,192.168.1.78, ...
773 * @param ipstr ip string list to be parsed
774 * @param ip_list pointer to array of ip addresses which is
775 * allocated by this function and must be freed by caller
776 * @return number of successfully parsed addresses
779 int ipstr_list_parse(const char *ipstr_list, struct ip_service **ip_list)
781 TALLOC_CTX *frame;
782 char *token_str = NULL;
783 size_t count;
784 int i;
786 if (!ipstr_list || !ip_list)
787 return 0;
789 count = count_chars(ipstr_list, IPSTR_LIST_CHAR) + 1;
790 if ( (*ip_list = SMB_MALLOC_ARRAY(struct ip_service, count)) == NULL ) {
791 DEBUG(0,("ipstr_list_parse: malloc failed for %lu entries\n",
792 (unsigned long)count));
793 return 0;
796 frame = talloc_stackframe();
797 for ( i=0; next_token_talloc(frame, &ipstr_list, &token_str,
798 IPSTR_LIST_SEP) && i<count; i++ ) {
799 char *s = token_str;
800 char *p = strrchr(token_str, ':');
802 if (p) {
803 *p = 0;
804 (*ip_list)[i].port = atoi(p+1);
807 /* convert single token to ip address */
808 if (token_str[0] == '[') {
809 /* IPv6 address. */
810 s++;
811 p = strchr(token_str, ']');
812 if (!p) {
813 continue;
815 *p = '\0';
817 if (!interpret_string_addr(&(*ip_list)[i].ss,
819 AI_NUMERICHOST)) {
820 continue;
823 TALLOC_FREE(frame);
824 return count;
828 * Safely free ip string list
830 * @param ipstr_list ip string list to be freed
833 void ipstr_list_free(char* ipstr_list)
835 SAFE_FREE(ipstr_list);
838 /* read a SMB_BIG_UINT from a string */
839 uint64_t STR_TO_SMB_BIG_UINT(const char *nptr, const char **entptr)
842 uint64_t val = (uint64_t)-1;
843 const char *p = nptr;
845 if (!p) {
846 if (entptr) {
847 *entptr = p;
849 return val;
852 while (*p && isspace(*p))
853 p++;
855 sscanf(p,"%"PRIu64,&val);
856 if (entptr) {
857 while (*p && isdigit(*p))
858 p++;
859 *entptr = p;
862 return val;
865 /* Convert a size specification to a count of bytes. We accept the following
866 * suffixes:
867 * bytes if there is no suffix
868 * kK kibibytes
869 * mM mebibytes
870 * gG gibibytes
871 * tT tibibytes
872 * pP whatever the ISO name for petabytes is
874 * Returns 0 if the string can't be converted.
876 uint64_t conv_str_size(const char * str)
878 uint64_t lval;
879 char * end;
881 if (str == NULL || *str == '\0') {
882 return 0;
885 lval = strtoull(str, &end, 10 /* base */);
887 if (end == NULL || end == str) {
888 return 0;
891 if (*end == '\0') {
892 return lval;
895 if (strwicmp(end, "K") == 0) {
896 lval *= 1024ULL;
897 } else if (strwicmp(end, "M") == 0) {
898 lval *= (1024ULL * 1024ULL);
899 } else if (strwicmp(end, "G") == 0) {
900 lval *= (1024ULL * 1024ULL *
901 1024ULL);
902 } else if (strwicmp(end, "T") == 0) {
903 lval *= (1024ULL * 1024ULL *
904 1024ULL * 1024ULL);
905 } else if (strwicmp(end, "P") == 0) {
906 lval *= (1024ULL * 1024ULL *
907 1024ULL * 1024ULL *
908 1024ULL);
909 } else {
910 return 0;
913 return lval;
916 /* Append an sprintf'ed string. Double buffer size on demand. Usable without
917 * error checking in between. The indiation that something weird happened is
918 * string==NULL */
920 void sprintf_append(TALLOC_CTX *mem_ctx, char **string, ssize_t *len,
921 size_t *bufsize, const char *fmt, ...)
923 va_list ap;
924 char *newstr;
925 int ret;
926 bool increased;
928 /* len<0 is an internal marker that something failed */
929 if (*len < 0)
930 goto error;
932 if (*string == NULL) {
933 if (*bufsize == 0)
934 *bufsize = 128;
936 *string = talloc_array(mem_ctx, char, *bufsize);
937 if (*string == NULL)
938 goto error;
941 va_start(ap, fmt);
942 ret = vasprintf(&newstr, fmt, ap);
943 va_end(ap);
945 if (ret < 0)
946 goto error;
948 increased = false;
950 while ((*len)+ret >= *bufsize) {
951 increased = true;
952 *bufsize *= 2;
953 if (*bufsize >= (1024*1024*256))
954 goto error;
957 if (increased) {
958 *string = talloc_realloc(mem_ctx, *string, char,
959 *bufsize);
960 if (*string == NULL) {
961 goto error;
965 StrnCpy((*string)+(*len), newstr, ret);
966 (*len) += ret;
967 free(newstr);
968 return;
970 error:
971 *len = -1;
972 *string = NULL;
976 * asprintf into a string and strupper_m it after that.
979 int asprintf_strupper_m(char **strp, const char *fmt, ...)
981 va_list ap;
982 char *result;
983 int ret;
985 va_start(ap, fmt);
986 ret = vasprintf(&result, fmt, ap);
987 va_end(ap);
989 if (ret == -1)
990 return -1;
992 strupper_m(result);
993 *strp = result;
994 return ret;
997 char *talloc_asprintf_strupper_m(TALLOC_CTX *t, const char *fmt, ...)
999 va_list ap;
1000 char *ret;
1002 va_start(ap, fmt);
1003 ret = talloc_vasprintf(t, fmt, ap);
1004 va_end(ap);
1006 if (ret == NULL) {
1007 return NULL;
1009 strupper_m(ret);
1010 return ret;
1013 char *talloc_asprintf_strlower_m(TALLOC_CTX *t, const char *fmt, ...)
1015 va_list ap;
1016 char *ret;
1018 va_start(ap, fmt);
1019 ret = talloc_vasprintf(t, fmt, ap);
1020 va_end(ap);
1022 if (ret == NULL) {
1023 return NULL;
1025 strlower_m(ret);
1026 return ret;
1030 /********************************************************************
1031 Check a string for any occurrences of a specified list of invalid
1032 characters.
1033 ********************************************************************/
1035 bool validate_net_name( const char *name,
1036 const char *invalid_chars,
1037 int max_len)
1039 int i;
1041 if (!name) {
1042 return false;
1045 for ( i=0; i<max_len && name[i]; i++ ) {
1046 /* fail if strchr_m() finds one of the invalid characters */
1047 if ( name[i] && strchr_m( invalid_chars, name[i] ) ) {
1048 return false;
1052 return true;
1056 /*******************************************************************
1057 Add a shell escape character '\' to any character not in a known list
1058 of characters. UNIX charset format.
1059 *******************************************************************/
1061 #define INCLUDE_LIST "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_/ \t.,"
1062 #define INSIDE_DQUOTE_LIST "$`\n\"\\"
1064 char *escape_shell_string(const char *src)
1066 size_t srclen = strlen(src);
1067 char *ret = SMB_MALLOC_ARRAY(char, (srclen * 2) + 1);
1068 char *dest = ret;
1069 bool in_s_quote = false;
1070 bool in_d_quote = false;
1071 bool next_escaped = false;
1073 if (!ret) {
1074 return NULL;
1077 while (*src) {
1078 size_t c_size;
1079 codepoint_t c = next_codepoint(src, &c_size);
1081 if (c == INVALID_CODEPOINT) {
1082 SAFE_FREE(ret);
1083 return NULL;
1086 if (c_size > 1) {
1087 memcpy(dest, src, c_size);
1088 src += c_size;
1089 dest += c_size;
1090 next_escaped = false;
1091 continue;
1095 * Deal with backslash escaped state.
1096 * This only lasts for one character.
1099 if (next_escaped) {
1100 *dest++ = *src++;
1101 next_escaped = false;
1102 continue;
1106 * Deal with single quote state. The
1107 * only thing we care about is exiting
1108 * this state.
1111 if (in_s_quote) {
1112 if (*src == '\'') {
1113 in_s_quote = false;
1115 *dest++ = *src++;
1116 continue;
1120 * Deal with double quote state. The most
1121 * complex state. We must cope with \, meaning
1122 * possibly escape next char (depending what it
1123 * is), ", meaning exit this state, and possibly
1124 * add an \ escape to any unprotected character
1125 * (listed in INSIDE_DQUOTE_LIST).
1128 if (in_d_quote) {
1129 if (*src == '\\') {
1131 * Next character might be escaped.
1132 * We have to peek. Inside double
1133 * quotes only INSIDE_DQUOTE_LIST
1134 * characters are escaped by a \.
1137 char nextchar;
1139 c = next_codepoint(&src[1], &c_size);
1140 if (c == INVALID_CODEPOINT) {
1141 SAFE_FREE(ret);
1142 return NULL;
1144 if (c_size > 1) {
1146 * Don't escape the next char.
1147 * Just copy the \.
1149 *dest++ = *src++;
1150 continue;
1153 nextchar = src[1];
1155 if (nextchar && strchr(INSIDE_DQUOTE_LIST,
1156 (int)nextchar)) {
1157 next_escaped = true;
1159 *dest++ = *src++;
1160 continue;
1163 if (*src == '\"') {
1164 /* Exit double quote state. */
1165 in_d_quote = false;
1166 *dest++ = *src++;
1167 continue;
1171 * We know the character isn't \ or ",
1172 * so escape it if it's any of the other
1173 * possible unprotected characters.
1176 if (strchr(INSIDE_DQUOTE_LIST, (int)*src)) {
1177 *dest++ = '\\';
1179 *dest++ = *src++;
1180 continue;
1184 * From here to the end of the loop we're
1185 * not in the single or double quote state.
1188 if (*src == '\\') {
1189 /* Next character must be escaped. */
1190 next_escaped = true;
1191 *dest++ = *src++;
1192 continue;
1195 if (*src == '\'') {
1196 /* Go into single quote state. */
1197 in_s_quote = true;
1198 *dest++ = *src++;
1199 continue;
1202 if (*src == '\"') {
1203 /* Go into double quote state. */
1204 in_d_quote = true;
1205 *dest++ = *src++;
1206 continue;
1209 /* Check if we need to escape the character. */
1211 if (!strchr(INCLUDE_LIST, (int)*src)) {
1212 *dest++ = '\\';
1214 *dest++ = *src++;
1216 *dest++ = '\0';
1217 return ret;
1220 /***************************************************
1221 str_list_make, v3 version. The v4 version does not
1222 look at quoted strings with embedded blanks, so
1223 do NOT merge this function please!
1224 ***************************************************/
1226 #define S_LIST_ABS 16 /* List Allocation Block Size */
1228 char **str_list_make_v3(TALLOC_CTX *mem_ctx, const char *string,
1229 const char *sep)
1231 char **list;
1232 const char *str;
1233 char *s, *tok;
1234 int num, lsize;
1236 if (!string || !*string)
1237 return NULL;
1239 list = talloc_array(mem_ctx, char *, S_LIST_ABS+1);
1240 if (list == NULL) {
1241 return NULL;
1243 lsize = S_LIST_ABS;
1245 s = talloc_strdup(list, string);
1246 if (s == NULL) {
1247 DEBUG(0,("str_list_make: Unable to allocate memory"));
1248 TALLOC_FREE(list);
1249 return NULL;
1251 if (!sep) sep = LIST_SEP;
1253 num = 0;
1254 str = s;
1256 while (next_token_talloc(list, &str, &tok, sep)) {
1258 if (num == lsize) {
1259 char **tmp;
1261 lsize += S_LIST_ABS;
1263 tmp = talloc_realloc(mem_ctx, list, char *,
1264 lsize + 1);
1265 if (tmp == NULL) {
1266 DEBUG(0,("str_list_make: "
1267 "Unable to allocate memory"));
1268 TALLOC_FREE(list);
1269 return NULL;
1272 list = tmp;
1274 memset (&list[num], 0,
1275 ((sizeof(char**)) * (S_LIST_ABS +1)));
1278 list[num] = tok;
1279 num += 1;
1282 list[num] = NULL;
1284 TALLOC_FREE(s);
1285 return list;