git.sur5r.net Git - openldap/blob - libraries/liblber/decode.c

   1 /* decode.c - ber input decoding routines */
   2 /*
   3  * Copyright 1998-1999 The OpenLDAP Foundation, All Rights Reserved.
   4  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
   5  */
   6 /* Portions
   7  * Copyright (c) 1990 Regents of the University of Michigan.
   8  * All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms are permitted
  11  * provided that this notice is preserved and that due credit is given
  12  * to the University of Michigan at Ann Arbor. The name of the University
  13  * may not be used to endorse or promote products derived from this
  14  * software without specific prior written permission. This software
  15  * is provided ``as is'' without express or implied warranty.
  16  */
  17
  18 #include "portable.h"
  19
  20 #include <stdio.h>
  21 #include <stdlib.h>
  22
  23 #include <ac/stdarg.h>
  24
  25 #include <ac/string.h>
  26 #include <ac/socket.h>
  27
  28 #include "lber-int.h"
  29
  30 static int ber_getnint LDAP_P(( BerElement *ber, long *num, int len ));
  31
  32 /* return the tag - LBER_DEFAULT returned means trouble */
  33 unsigned long
  34 ber_get_tag( BerElement *ber )
  35 {
  36         unsigned char   xbyte;
  37         unsigned long   tag;
  38         char            *tagp;
  39         unsigned int    i;
  40
  41         assert( ber != NULL );
  42
  43         if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 )
  44                 return( LBER_DEFAULT );
  45
  46         if ( (xbyte & LBER_BIG_TAG_MASK) != LBER_BIG_TAG_MASK )
  47                 return( (unsigned long) xbyte );
  48
  49         tagp = (char *) &tag;
  50         tagp[0] = xbyte;
  51         for ( i = 1; i < sizeof(long); i++ ) {
  52                 if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 )
  53                         return( LBER_DEFAULT );
  54
  55                 tagp[i] = xbyte;
  56
  57                 if ( ! (xbyte & LBER_MORE_TAG_MASK) )
  58                         break;
  59         }
  60
  61         /* tag too big! */
  62         if ( i == sizeof(long) )
  63                 return( LBER_DEFAULT );
  64
  65         /* want leading, not trailing 0's */
  66         return( tag >> (sizeof(long) - i - 1) );
  67 }
  68
  69 unsigned long
  70 ber_skip_tag( BerElement *ber, unsigned long *len )
  71 {
  72         unsigned long   tag;
  73         unsigned char   lc;
  74         int             noctets, diff;
  75         unsigned long   netlen;
  76
  77         assert( ber != NULL );
  78         assert( len != NULL );
  79
  80         /*
  81          * Any ber element looks like this: tag length contents.
  82          * Assuming everything's ok, we return the tag byte (we
  83          * can assume a single byte), and return the length in len.
  84          *
  85          * Assumptions:
  86          *      1) definite lengths
  87          *      2) primitive encodings used whenever possible
  88          */
  89
  90         /*
  91          * First, we read the tag.
  92          */
  93
  94         if ( (tag = ber_get_tag( ber )) == LBER_DEFAULT )
  95                 return( LBER_DEFAULT );
  96
  97         /*
  98          * Next, read the length.  The first byte contains the length of
  99          * the length.  If bit 8 is set, the length is the long form,
 100          * otherwise it's the short form.  We don't allow a length that's
 101          * greater than what we can hold in an unsigned long.
 102          */
 103
 104         *len = netlen = 0;
 105         if ( ber_read( ber, (char *) &lc, 1 ) != 1 )
 106                 return( LBER_DEFAULT );
 107         if ( lc & 0x80U ) {
 108                 noctets = (lc & 0x7fU);
 109                 if ( (unsigned) noctets > sizeof(unsigned long) )
 110                         return( LBER_DEFAULT );
 111                 diff = sizeof(unsigned long) - noctets;
 112                 if ( ber_read( ber, (char *) &netlen + diff, noctets )
 113                     != noctets )
 114                         return( LBER_DEFAULT );
 115                 *len = AC_NTOHL( netlen );
 116         } else {
 117                 *len = lc;
 118         }
 119
 120         return( tag );
 121 }
 122
 123 unsigned long
 124 ber_peek_tag(
 125         LDAP_CONST BerElement *ber_in, /* not const per c-api-02 */
 126         unsigned long *len )
 127 {
 128         unsigned long   tag;
 129         BerElement *ber = ber_dup( ber_in );
 130
 131         if( ber == NULL ) {
 132                 return LBER_ERROR;
 133         }
 134
 135         tag = ber_skip_tag( ber, len );
 136
 137         ber_free( ber, 1 );
 138         return( tag );
 139 }
 140
 141 static int
 142 ber_getnint( BerElement *ber, long *num, int len )
 143 {
 144         int     diff, sign, i;
 145         long    netnum;
 146         char    *p;
 147
 148         assert( ber != NULL );
 149         assert( num != NULL );
 150
 151         /*
 152          * The tag and length have already been stripped off.  We should
 153          * be sitting right before len bytes of 2's complement integer,
 154          * ready to be read straight into an int.  We may have to sign
 155          * extend after we read it in.
 156          */
 157
 158         if ( (unsigned) len > sizeof(long) )
 159                 return( -1 );
 160
 161         netnum = 0;
 162         diff = sizeof(long) - len;
 163         /* read into the low-order bytes of netnum */
 164         if ( ber_read( ber, ((char *) &netnum) + diff, len ) != len )
 165                 return( -1 );
 166
 167         /* sign extend if necessary */
 168         p = (char *) &netnum;
 169         sign = (0x80 & *(p+diff) );
 170         if ( sign && ((unsigned) len < sizeof(long)) ) {
 171                 for ( i = 0; i < diff; i++ ) {
 172                         *(p+i) = (unsigned char) 0xff;
 173                 }
 174         }
 175         *num = AC_NTOHL( netnum );
 176
 177         return( len );
 178 }
 179
 180 unsigned long
 181 ber_get_int( BerElement *ber, long *num )
 182 {
 183         unsigned long   tag, len;
 184
 185         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
 186                 return( LBER_DEFAULT );
 187
 188         if ( (unsigned long) ber_getnint( ber, num, (int)len ) != len )
 189                 return( LBER_DEFAULT );
 190         else
 191                 return( tag );
 192 }
 193
 194 unsigned long
 195 ber_get_stringb( BerElement *ber, char *buf, unsigned long *len )
 196 {
 197         unsigned long   datalen, tag;
 198 #ifdef STR_TRANSLATION
 199         char            *transbuf;
 200 #endif /* STR_TRANSLATION */
 201
 202         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT )
 203                 return( LBER_DEFAULT );
 204         if ( datalen > (*len - 1) )
 205                 return( LBER_DEFAULT );
 206
 207         if ( (unsigned long) ber_read( ber, buf, datalen ) != datalen )
 208                 return( LBER_DEFAULT );
 209
 210         buf[datalen] = '\0';
 211
 212 #ifdef STR_TRANSLATION
 213         if ( datalen > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
 214             && ber->ber_decode_translate_proc ) {
 215                 transbuf = buf;
 216                 ++datalen;
 217                 if ( (*(ber->ber_decode_translate_proc))( &transbuf, &datalen,
 218                     0 ) != 0 ) {
 219                         return( LBER_DEFAULT );
 220                 }
 221                 if ( datalen > *len ) {
 222                         free( transbuf );
 223                         return( LBER_DEFAULT );
 224                 }
 225                 SAFEMEMCPY( buf, transbuf, datalen );
 226                 free( transbuf );
 227                 --datalen;
 228         }
 229 #endif /* STR_TRANSLATION */
 230
 231         *len = datalen;
 232         return( tag );
 233 }
 234
 235 unsigned long
 236 ber_get_stringa( BerElement *ber, char **buf )
 237 {
 238         unsigned long   datalen, tag;
 239
 240         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
 241                 *buf = NULL;
 242                 return( LBER_DEFAULT );
 243         }
 244
 245         if ( (*buf = (char *) malloc( (size_t)datalen + 1 )) == NULL )
 246                 return( LBER_DEFAULT );
 247
 248         if ( (unsigned long) ber_read( ber, *buf, datalen ) != datalen ) {
 249                 free( *buf );
 250                 *buf = NULL;
 251                 return( LBER_DEFAULT );
 252         }
 253         (*buf)[datalen] = '\0';
 254
 255 #ifdef STR_TRANSLATION
 256         if ( datalen > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
 257             && ber->ber_decode_translate_proc ) {
 258                 ++datalen;
 259                 if ( (*(ber->ber_decode_translate_proc))( buf, &datalen, 1 )
 260                     != 0 ) {
 261                         free( *buf );
 262                         *buf = NULL;
 263                         return( LBER_DEFAULT );
 264                 }
 265         }
 266 #endif /* STR_TRANSLATION */
 267
 268         return( tag );
 269 }
 270
 271 unsigned long
 272 ber_get_stringal( BerElement *ber, struct berval **bv )
 273 {
 274         unsigned long   len, tag;
 275
 276         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
 277                 *bv = NULL;
 278                 return( LBER_DEFAULT );
 279         }
 280
 281         if ( (*bv = (struct berval *) malloc( sizeof(struct berval) )) == NULL )
 282                 return( LBER_DEFAULT );
 283
 284         if ( ((*bv)->bv_val = (char *) malloc( (size_t)len + 1 )) == NULL ) {
 285                 free( *bv );
 286                 *bv = NULL;
 287                 return( LBER_DEFAULT );
 288         }
 289
 290         if ( (unsigned long) ber_read( ber, (*bv)->bv_val, len ) != len ) {
 291                 ber_bvfree( *bv );
 292                 *bv = NULL;
 293                 return( LBER_DEFAULT );
 294         }
 295         ((*bv)->bv_val)[len] = '\0';
 296         (*bv)->bv_len = len;
 297
 298 #ifdef STR_TRANSLATION
 299         if ( len > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
 300             && ber->ber_decode_translate_proc ) {
 301                 ++len;
 302                 if ( (*(ber->ber_decode_translate_proc))( &((*bv)->bv_val),
 303                     &len, 1 ) != 0 ) {
 304                         ber_bvfree( *bv );
 305                         *bv = NULL;
 306                         return( LBER_DEFAULT );
 307                 }
 308                 (*bv)->bv_len = len - 1;
 309         }
 310 #endif /* STR_TRANSLATION */
 311
 312         return( tag );
 313 }
 314
 315 unsigned long
 316 ber_get_bitstringa( BerElement *ber, char **buf, unsigned long *blen )
 317 {
 318         unsigned long   datalen, tag;
 319         unsigned char   unusedbits;
 320
 321         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
 322                 *buf = NULL;
 323                 return( LBER_DEFAULT );
 324         }
 325         --datalen;
 326
 327         if ( (*buf = (char *) malloc( (size_t)datalen )) == NULL )
 328                 return( LBER_DEFAULT );
 329
 330         if ( ber_read( ber, (char *)&unusedbits, 1 ) != 1 ) {
 331                 free( buf );
 332                 *buf = NULL;
 333                 return( LBER_DEFAULT );
 334         }
 335
 336         if ( (unsigned long) ber_read( ber, *buf, datalen ) != datalen ) {
 337                 free( buf );
 338                 *buf = NULL;
 339                 return( LBER_DEFAULT );
 340         }
 341
 342         *blen = datalen * 8 - unusedbits;
 343         return( tag );
 344 }
 345
 346 unsigned long
 347 ber_get_null( BerElement *ber )
 348 {
 349         unsigned long   len, tag;
 350
 351         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
 352                 return( LBER_DEFAULT );
 353
 354         if ( len != 0 )
 355                 return( LBER_DEFAULT );
 356
 357         return( tag );
 358 }
 359
 360 unsigned long
 361 ber_get_boolean( BerElement *ber, int *boolval )
 362 {
 363         long    longbool;
 364         int     rc;
 365
 366         rc = ber_get_int( ber, &longbool );
 367         *boolval = longbool;
 368
 369         return( rc );
 370 }
 371
 372 unsigned long
 373 ber_first_element( BerElement *ber, unsigned long *len, char **last )
 374 {
 375         /* skip the sequence header, use the len to mark where to stop */
 376         if ( ber_skip_tag( ber, len ) == LBER_DEFAULT ) {
 377                 *last = NULL;
 378                 return( LBER_DEFAULT );
 379         }
 380
 381         *last = ber->ber_ptr + *len;
 382
 383         if ( *last == ber->ber_ptr ) {
 384 #ifdef LBER_END_SEQORSET
 385                 return( LBER_END_SEQORSET );
 386 #else
 387                 return( LBER_DEFAULT );
 388 #endif
 389         }
 390
 391         return( ber_peek_tag( ber, len ) );
 392 }
 393
 394 unsigned long
 395 ber_next_element( BerElement *ber, unsigned long *len, char *last )
 396 {
 397         if ( ber->ber_ptr == last ) {
 398 #ifdef LBER_END_SEQORSET
 399                 return( LBER_END_SEQORSET );
 400 #else
 401                 return( LBER_DEFAULT );
 402 #endif
 403         }
 404
 405         return( ber_peek_tag( ber, len ) );
 406 }
 407
 408 /* VARARGS */
 409 unsigned long
 410 ber_scanf
 411 #if HAVE_STDARG
 412         ( BerElement *ber,
 413         LDAP_CONST char *fmt,
 414         ... )
 415 #else
 416         ( va_alist )
 417 va_dcl
 418 #endif
 419 {
 420         va_list         ap;
 421 #ifndef HAVE_STDARG
 422         BerElement      *ber;
 423         char            *fmt;
 424 #endif
 425         LDAP_CONST char         *fmt_reset;
 426         char            *last;
 427         char            *s, **ss, ***sss;
 428         struct berval   ***bv, **bvp, *bval;
 429         int             *i, j;
 430         long            *l;
 431         unsigned long   rc, tag, len;
 432
 433         assert( ber != NULL );
 434
 435 #ifdef HAVE_STDARG
 436         va_start( ap, fmt );
 437 #else
 438         va_start( ap );
 439         ber = va_arg( ap, BerElement * );
 440         fmt = va_arg( ap, char * );
 441 #endif
 442
 443         assert( ber != NULL );
 444         assert( fmt != NULL );
 445
 446         fmt_reset = fmt;
 447
 448         if ( ber->ber_debug ) {
 449                 ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
 450                         "ber_scanf fmt (%s) ber:\n", fmt );
 451                 ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
 452         }
 453
 454         for ( rc = 0; *fmt && rc != LBER_DEFAULT; fmt++ ) {
 455                 /* When this is modified, remember to update
 456                  * the error-cleanup code below accordingly. */
 457                 switch ( *fmt ) {
 458                 case '!': { /* Hook */
 459                                 BERDecodeCallback *f;
 460                                 void *p;
 461
 462                                 f = va_arg( ap, BERDecodeCallback * );
 463                                 p = va_arg( ap, void * );
 464
 465                                 rc = (*f)( ber, p, 0 );
 466                         } break;
 467
 468                 case 'a':       /* octet string - allocate storage as needed */
 469                         ss = va_arg( ap, char ** );
 470                         rc = ber_get_stringa( ber, ss );
 471                         break;
 472
 473                 case 'b':       /* boolean */
 474                         i = va_arg( ap, int * );
 475                         rc = ber_get_boolean( ber, i );
 476                         break;
 477
 478                 case 'e':       /* enumerated */
 479                 case 'i':       /* int */
 480                         l = va_arg( ap, long * );
 481                         rc = ber_get_int( ber, l );
 482                         break;
 483
 484                 case 'l':       /* length of next item */
 485                         l = va_arg( ap, long * );
 486                         rc = ber_peek_tag( ber, (unsigned long *)l );
 487                         break;
 488
 489                 case 'n':       /* null */
 490                         rc = ber_get_null( ber );
 491                         break;
 492
 493                 case 's':       /* octet string - in a buffer */
 494                         s = va_arg( ap, char * );
 495                         l = va_arg( ap, long * );
 496                         rc = ber_get_stringb( ber, s, (unsigned long *)l );
 497                         break;
 498
 499                 case 'o':       /* octet string in a supplied berval */
 500                         bval = va_arg( ap, struct berval * );
 501                         ber_peek_tag( ber, &bval->bv_len );
 502                         rc = ber_get_stringa( ber, &bval->bv_val );
 503                         break;
 504
 505                 case 'O':       /* octet string - allocate & include length */
 506                         bvp = va_arg( ap, struct berval ** );
 507                         rc = ber_get_stringal( ber, bvp );
 508                         break;
 509
 510                 case 'B':       /* bit string - allocate storage as needed */
 511                         ss = va_arg( ap, char ** );
 512                         l = va_arg( ap, long * ); /* for length, in bits */
 513                         rc = ber_get_bitstringa( ber, ss, (unsigned long *)l );
 514                         break;
 515
 516                 case 't':       /* tag of next item */
 517                         i = va_arg( ap, int * );
 518                         *i = rc = ber_peek_tag( ber, &len );
 519                         break;
 520
 521                 case 'T':       /* skip tag of next item */
 522                         i = va_arg( ap, int * );
 523                         *i = rc = ber_skip_tag( ber, &len );
 524                         break;
 525
 526                 case 'v':       /* sequence of strings */
 527                         sss = va_arg( ap, char *** );
 528                         *sss = NULL;
 529                         j = 0;
 530                         for ( tag = ber_first_element( ber, &len, &last );
 531                             tag != LBER_DEFAULT &&
 532 #ifdef LBER_END_SEQORSET
 533                                         tag != LBER_END_SEQORSET &&
 534 #endif
 535                                         rc != LBER_DEFAULT;
 536                             tag = ber_next_element( ber, &len, last ) )
 537                         {
 538                                 if ( *sss == NULL ) {
 539                                         *sss = (char **) malloc(
 540                                             2 * sizeof(char *) );
 541                                 } else {
 542                                         *sss = (char **) realloc( *sss,
 543                                             (j + 2) * sizeof(char *) );
 544                                 }
 545                                 rc = ber_get_stringa( ber, &((*sss)[j]) );
 546                                 j++;
 547                         }
 548 #ifdef LBER_END_SEQORSET
 549                         if (rc != LBER_DEFAULT &&
 550                                 tag != LBER_END_SEQORSET )
 551                         {
 552                                 rc = LBER_DEFAULT;
 553                         }
 554 #endif
 555                         if ( j > 0 )
 556                                 (*sss)[j] = NULL;
 557                         break;
 558
 559                 case 'V':       /* sequence of strings + lengths */
 560                         bv = va_arg( ap, struct berval *** );
 561                         *bv = NULL;
 562                         j = 0;
 563                         for ( tag = ber_first_element( ber, &len, &last );
 564                             tag != LBER_DEFAULT &&
 565 #ifdef LBER_END_SEQORSET
 566                                         tag != LBER_END_SEQORSET &&
 567 #endif
 568                                         rc != LBER_DEFAULT;
 569                             tag = ber_next_element( ber, &len, last ) )
 570                         {
 571                                 if ( *bv == NULL ) {
 572                                         *bv = (struct berval **) malloc(
 573                                             2 * sizeof(struct berval *) );
 574                                 } else {
 575                                         *bv = (struct berval **) realloc( *bv,
 576                                             (j + 2) * sizeof(struct berval *) );
 577                                 }
 578                                 rc = ber_get_stringal( ber, &((*bv)[j]) );
 579                                 j++;
 580                         }
 581 #ifdef LBER_END_SEQORSET
 582                         if (rc != LBER_DEFAULT &&
 583                                 tag != LBER_END_SEQORSET )
 584                         {
 585                                 rc = LBER_DEFAULT;
 586                         }
 587 #endif
 588                         if ( j > 0 )
 589                                 (*bv)[j] = NULL;
 590                         break;
 591
 592                 case 'x':       /* skip the next element - whatever it is */
 593                         if ( (rc = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
 594                                 break;
 595                         ber->ber_ptr += len;
 596                         break;
 597
 598                 case '{':       /* begin sequence */
 599                 case '[':       /* begin set */
 600                         if ( *(fmt + 1) != 'v' && *(fmt + 1) != 'V' )
 601                                 rc = ber_skip_tag( ber, &len );
 602                         break;
 603
 604                 case '}':       /* end sequence */
 605                 case ']':       /* end set */
 606                         break;
 607
 608                 default:
 609                         if( ber->ber_debug ) {
 610                                 ber_log_printf( LDAP_DEBUG_ANY, ber->ber_debug,
 611                                         "ber_scanf: unknown fmt %c\n", *fmt );
 612                         }
 613                         rc = LBER_DEFAULT;
 614                         break;
 615                 }
 616         }
 617
 618         va_end( ap );
 619
 620         if ( rc == LBER_DEFAULT ) {
 621             /*
 622              * Error.  Reclaim malloced memory that was given to the caller.
 623              * Set allocated pointers to NULL, "data length" outvalues to 0.
 624              */
 625 #ifdef HAVE_STDARG
 626             va_start( ap, fmt );
 627 #else
 628             va_start( ap );
 629             (void) va_arg( ap, BerElement * );
 630             (void) va_arg( ap, char * );
 631 #endif
 632
 633             for ( ; fmt_reset < fmt; fmt_reset++ ) {
 634                 switch ( *fmt_reset ) {
 635                 case '!': { /* Hook */
 636                                 BERDecodeCallback *f;
 637                                 void *p;
 638
 639                                 f = va_arg( ap, BERDecodeCallback * );
 640                                 p = va_arg( ap, void * );
 641
 642                                 (void) (*f)( ber, p, 1 );
 643                         } break;
 644
 645                 case 'a':       /* octet string - allocate storage as needed */
 646                         ss = va_arg( ap, char ** );
 647                         if ( *ss ) {
 648                                 free( *ss );
 649                                 *ss = NULL;
 650                         }
 651                         break;
 652
 653                 case 'b':       /* boolean */
 654                 case 't':       /* tag of next item */
 655                 case 'T':       /* skip tag of next item */
 656                         (void) va_arg( ap, int * );
 657                         break;
 658
 659                 case 's':       /* octet string - in a buffer */
 660                         (void) va_arg( ap, char * );
 661                         /* Fall through */
 662                 case 'e':       /* enumerated */
 663                 case 'i':       /* int */
 664                 case 'l':       /* length of next item */
 665                         (void) va_arg( ap, long * );
 666                         break;
 667
 668                 case 'o':       /* octet string in a supplied berval */
 669                         bval = va_arg( ap, struct berval * );
 670                         if ( bval->bv_val ) {
 671                                 free( bval->bv_val );
 672                                 bval->bv_val = NULL;
 673                         }
 674                         bval->bv_len = 0;
 675                         break;
 676
 677                 case 'O':       /* octet string - allocate & include length */
 678                         bvp = va_arg( ap, struct berval ** );
 679                         if ( *bvp ) {
 680                                 ber_bvfree( *bvp );
 681                                 *bvp = NULL;
 682                         }
 683                         break;
 684
 685                 case 'B':       /* bit string - allocate storage as needed */
 686                         ss = va_arg( ap, char ** );
 687                         if ( *ss ) {
 688                                 free( *ss );
 689                                 *ss = NULL;
 690                         }
 691                         *(va_arg( ap, long * )) = 0; /* for length, in bits */
 692                         break;
 693
 694                 case 'v':       /* sequence of strings */
 695                         sss = va_arg( ap, char *** );
 696                         if ( *sss ) {
 697                                 for (j = 0;  (*sss)[j];  j++) {
 698                                         free( (*sss)[j] );
 699                                         (*sss)[j] = NULL;
 700                                 }
 701                                 free( *sss );
 702                                 *sss = NULL;
 703                         }
 704                         break;
 705
 706                 case 'V':       /* sequence of strings + lengths */
 707                         bv = va_arg( ap, struct berval *** );
 708                         if ( *bv ) {
 709                                 ber_bvecfree( *bv );
 710                                 *bv = NULL;
 711                         }
 712                         break;
 713
 714 #if 0           /* No action for these format characters */
 715                 case 'n':       /* null */
 716                 case 'x':       /* skip the next element - whatever it is */
 717                 case '{':       /* begin sequence */
 718                 case '[':       /* begin set */
 719                 case '}':       /* end sequence */
 720                 case ']':       /* end set */
 721 #endif
 722
 723                 }
 724             }
 725
 726             va_end( ap );
 727         }
 728
 729         return( rc );
 730 }
 731
 732 void
 733 ber_bvfree( struct berval *bv )
 734 {
 735         assert(bv != NULL);                     /* bv damn better point to something */
 736
 737         if ( bv->bv_val != NULL )
 738                 free( bv->bv_val );
 739         free( (char *) bv );
 740 }
 741
 742 void
 743 ber_bvecfree( struct berval **bv )
 744 {
 745         int     i;
 746
 747         assert(bv != NULL);                     /* bv damn better point to something */
 748
 749         for ( i = 0; bv[i] != NULL; i++ )
 750                 ber_bvfree( bv[i] );
 751         free( (char *) bv );
 752 }
 753
 754 struct berval *
 755 ber_bvdup(
 756         LDAP_CONST struct berval *bv )
 757 {
 758         struct berval   *new;
 759
 760         assert( bv != NULL );
 761
 762         if( bv == NULL ) {
 763                 return NULL;
 764         }
 765
 766         if ( (new = (struct berval *) malloc( sizeof(struct berval) ))
 767             == NULL ) {
 768                 return( NULL );
 769         }
 770
 771         if ( bv->bv_val == NULL ) {
 772                 new->bv_val = NULL;
 773                 new->bv_len = 0;
 774                 return ( new );
 775         }
 776
 777         if ( (new->bv_val = (char *) malloc( bv->bv_len + 1 )) == NULL ) {
 778                 free( new );
 779                 return( NULL );
 780         }
 781
 782         SAFEMEMCPY( new->bv_val, bv->bv_val, (size_t) bv->bv_len );
 783         new->bv_val[bv->bv_len] = '\0';
 784         new->bv_len = bv->bv_len;
 785
 786         return( new );
 787 }
 788
 789
 790 #ifdef STR_TRANSLATION
 791 void
 792 ber_set_string_translators( BerElement *ber, BERTranslateProc encode_proc,
 793         BERTranslateProc decode_proc )
 794 {
 795         assert( ber != NULL );
 796
 797     ber->ber_encode_translate_proc = encode_proc;
 798     ber->ber_decode_translate_proc = decode_proc;
 799 }
 800 #endif /* STR_TRANSLATION */