source3/lib/util_unistr.c

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