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

   1 /* decode.c - ber input decoding routines */
   2 /* $OpenLDAP$ */
   3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
   4  *
   5  * Copyright 1998-2007 The OpenLDAP Foundation.
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted only as authorized by the OpenLDAP
  10  * Public License.
  11  *
  12  * A copy of this license is available in the file LICENSE in the
  13  * top-level directory of the distribution or, alternatively, at
  14  * <http://www.OpenLDAP.org/license.html>.
  15  */
  16 /* Portions Copyright (c) 1990 Regents of the University of Michigan.
  17  * All rights reserved.
  18  *
  19  * Redistribution and use in source and binary forms are permitted
  20  * provided that this notice is preserved and that due credit is given
  21  * to the University of Michigan at Ann Arbor. The name of the University
  22  * may not be used to endorse or promote products derived from this
  23  * software without specific prior written permission. This software
  24  * is provided ``as is'' without express or implied warranty.
  25  */
  26 /* ACKNOWLEDGEMENTS:
  27  * This work was originally developed by the University of Michigan
  28  * (as part of U-MICH LDAP).
  29  */
  30
  31 #include "portable.h"
  32
  33 #include <stdio.h>
  34
  35 #include <ac/stdlib.h>
  36
  37 #include <ac/stdarg.h>
  38 #include <ac/string.h>
  39 #include <ac/socket.h>
  40
  41 #include "lber-int.h"
  42
  43 static ber_len_t ber_getnint LDAP_P((
  44         BerElement *ber,
  45         ber_int_t *num,
  46         ber_len_t len ));
  47
  48 /* return the tag - LBER_DEFAULT returned means trouble */
  49 ber_tag_t
  50 ber_get_tag( BerElement *ber )
  51 {
  52         unsigned char   xbyte;
  53         ber_tag_t       tag;
  54         unsigned int    i;
  55
  56         assert( ber != NULL );
  57         assert( LBER_VALID( ber ) );
  58
  59         if ( ber_pvt_ber_remaining( ber ) < 1 ) {
  60                 return LBER_DEFAULT;
  61         }
  62
  63         if ( ber->ber_ptr == ber->ber_buf ) {
  64                 tag = *(unsigned char *)ber->ber_ptr;
  65         } else {
  66                 tag = ber->ber_tag;
  67         }
  68         ber->ber_ptr++;
  69
  70         if ( (tag & LBER_BIG_TAG_MASK) != LBER_BIG_TAG_MASK ) {
  71                 return tag;
  72         }
  73
  74         for ( i = 1; i < sizeof(ber_tag_t); i++ ) {
  75                 if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 ) {
  76                         return LBER_DEFAULT;
  77                 }
  78
  79                 tag <<= 8;
  80                 tag |= 0x00ffUL & (ber_tag_t) xbyte;
  81
  82                 if ( ! (xbyte & LBER_MORE_TAG_MASK) ) {
  83                         break;
  84                 }
  85         }
  86
  87         /* tag too big! */
  88         if ( i == sizeof(ber_tag_t) ) {
  89                 return LBER_DEFAULT;
  90         }
  91
  92         return tag;
  93 }
  94
  95 ber_tag_t
  96 ber_skip_tag( BerElement *ber, ber_len_t *len )
  97 {
  98         ber_tag_t       tag;
  99         unsigned char   lc;
 100         ber_len_t       i, noctets;
 101         unsigned char netlen[sizeof(ber_len_t)];
 102
 103         assert( ber != NULL );
 104         assert( len != NULL );
 105         assert( LBER_VALID( ber ) );
 106
 107         /*
 108          * Any ber element looks like this: tag length contents.
 109          * Assuming everything's ok, we return the tag byte (we
 110          * can assume a single byte), and return the length in len.
 111          *
 112          * Assumptions:
 113          *      1) definite lengths
 114          *      2) primitive encodings used whenever possible
 115          */
 116
 117         *len = 0;
 118
 119         /*
 120          * First, we read the tag.
 121          */
 122
 123         if ( (tag = ber_get_tag( ber )) == LBER_DEFAULT ) {
 124                 return LBER_DEFAULT;
 125         }
 126
 127         /*
 128          * Next, read the length.  The first byte contains the length of
 129          * the length.  If bit 8 is set, the length is the long form,
 130          * otherwise it's the short form.  We don't allow a length that's
 131          * greater than what we can hold in a ber_len_t.
 132          */
 133
 134         if ( ber_read( ber, (char *) &lc, 1 ) != 1 ) {
 135                 return LBER_DEFAULT;
 136         }
 137
 138         if ( lc & 0x80U ) {
 139                 noctets = (lc & 0x7fU);
 140
 141                 if ( noctets > sizeof(ber_len_t) ) {
 142                         return LBER_DEFAULT;
 143                 }
 144
 145                 if( (unsigned) ber_read( ber, (char *) netlen, noctets ) != noctets ) {
 146                         return LBER_DEFAULT;
 147                 }
 148
 149                 for( i = 0; i < noctets; i++ ) {
 150                         *len <<= 8;
 151                         *len |= netlen[i];
 152                 }
 153
 154         } else {
 155                 *len = lc;
 156         }
 157
 158         /* BER element should have enough data left */
 159         if( *len > (ber_len_t) ber_pvt_ber_remaining( ber ) ) {
 160                 return LBER_DEFAULT;
 161         }
 162         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 163
 164         return tag;
 165 }
 166
 167 ber_tag_t
 168 ber_peek_tag(
 169         BerElement *ber,
 170         ber_len_t *len )
 171 {
 172         /*
 173          * This implementation assumes ber_skip_tag() only
 174          * modifies ber_ptr field of the BerElement.
 175          */
 176
 177         char *save;
 178         ber_tag_t       tag, old;
 179
 180         old = ber->ber_tag;
 181         save = ber->ber_ptr;
 182         tag = ber_skip_tag( ber, len );
 183         ber->ber_ptr = save;
 184         ber->ber_tag = old;
 185
 186         return tag;
 187 }
 188
 189 static ber_len_t
 190 ber_getnint(
 191         BerElement *ber,
 192         ber_int_t *num,
 193         ber_len_t len )
 194 {
 195         unsigned char buf[sizeof(ber_int_t)];
 196
 197         assert( ber != NULL );
 198         assert( num != NULL );
 199         assert( LBER_VALID( ber ) );
 200
 201         /*
 202          * The tag and length have already been stripped off.  We should
 203          * be sitting right before len bytes of 2's complement integer,
 204          * ready to be read straight into an int.  We may have to sign
 205          * extend after we read it in.
 206          */
 207
 208         if ( len > sizeof(ber_int_t) ) {
 209                 return -1;
 210         }
 211
 212         /* read into the low-order bytes of our buffer */
 213         if ( (ber_len_t) ber_read( ber, (char *) buf, len ) != len ) {
 214                 return -1;
 215         }
 216
 217         if( len ) {
 218                 /* sign extend if necessary */
 219                 ber_len_t i;
 220                 ber_int_t netnum = 0x80 & buf[0] ? -1 : 0;
 221
 222                 /* shift in the bytes */
 223                 for( i=0 ; i<len; i++ ) {
 224                         netnum = (netnum << 8 ) | buf[i];
 225                 }
 226
 227                 *num = netnum;
 228
 229         } else {
 230                 *num = 0;
 231         }
 232         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 233
 234         return len;
 235 }
 236
 237 ber_tag_t
 238 ber_get_int(
 239         BerElement *ber,
 240         ber_int_t *num )
 241 {
 242         ber_tag_t       tag;
 243         ber_len_t       len;
 244
 245         assert( ber != NULL );
 246         assert( LBER_VALID( ber ) );
 247
 248         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
 249                 return LBER_DEFAULT;
 250         }
 251
 252         if ( ber_getnint( ber, num, len ) != len ) {
 253                 return LBER_DEFAULT;
 254         }
 255
 256         return tag;
 257 }
 258
 259 ber_tag_t
 260 ber_get_enum(
 261         BerElement *ber,
 262         ber_int_t *num )
 263 {
 264         return ber_get_int( ber, num );
 265 }
 266
 267 ber_tag_t
 268 ber_get_stringb(
 269         BerElement *ber,
 270         char *buf,
 271         ber_len_t *len )
 272 {
 273         ber_len_t       datalen;
 274         ber_tag_t       tag;
 275
 276         assert( ber != NULL );
 277         assert( LBER_VALID( ber ) );
 278
 279         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
 280                 return LBER_DEFAULT;
 281         }
 282
 283         /* must fit within allocated space with termination */
 284         if ( datalen >= *len ) {
 285                 return LBER_DEFAULT;
 286         }
 287
 288         if ( (ber_len_t) ber_read( ber, buf, datalen ) != datalen ) {
 289                 return LBER_DEFAULT;
 290         }
 291         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 292
 293         buf[datalen] = '\0';
 294
 295         *len = datalen;
 296         return tag;
 297 }
 298
 299 /* Definitions for get_string vector
 300  *
 301  * ChArray, BvArray, and BvVec are self-explanatory.
 302  * BvOff is a struct berval embedded in an array of larger structures
 303  * of siz bytes at off bytes from the beginning of the struct.
 304  */
 305 enum bgbvc { ChArray, BvArray, BvVec, BvOff };
 306
 307 /* Use this single cookie for state, to keep actual
 308  * stack use to the absolute minimum.
 309  */
 310 typedef struct bgbvr {
 311         enum bgbvc choice;
 312         BerElement *ber;
 313         int alloc;
 314         ber_len_t siz;
 315         ber_len_t off;
 316         union {
 317                 char ***c;
 318                 BerVarray *ba;
 319                 struct berval ***bv;
 320         } res;
 321 } bgbvr;
 322
 323 static ber_tag_t
 324 ber_get_stringbvl( bgbvr *b, ber_len_t *rlen )
 325 {
 326         int i = 0, n;
 327         ber_tag_t tag;
 328         ber_len_t len;
 329         char *last, *orig;
 330         struct berval bv, *bvp = NULL;
 331
 332         /* For rewinding, just like ber_peek_tag() */
 333         orig = b->ber->ber_ptr;
 334         tag = b->ber->ber_tag;
 335
 336         if ( ber_first_element( b->ber, &len, &last ) != LBER_DEFAULT ) {
 337                 for ( ; b->ber->ber_ptr < last; i++ ) {
 338                         if (ber_skip_tag( b->ber, &len ) == LBER_DEFAULT) break;
 339                         b->ber->ber_ptr += len;
 340                         b->ber->ber_tag = *(unsigned char *)b->ber->ber_ptr;
 341                 }
 342         }
 343
 344         if ( rlen ) *rlen = i;
 345
 346         if ( i == 0 ) {
 347                 *b->res.c = NULL;
 348                 return 0;
 349         }
 350
 351         n = i;
 352
 353         /* Allocate the result vector */
 354         switch (b->choice) {
 355         case ChArray:
 356                 *b->res.c = ber_memalloc_x( (n+1)*sizeof( char * ),
 357                         b->ber->ber_memctx);
 358                 if ( *b->res.c == NULL ) return LBER_DEFAULT;
 359                 (*b->res.c)[n] = NULL;
 360                 break;
 361         case BvArray:
 362                 *b->res.ba = ber_memalloc_x( (n+1)*sizeof( struct berval ),
 363                         b->ber->ber_memctx);
 364                 if ( *b->res.ba == NULL ) return LBER_DEFAULT;
 365                 (*b->res.ba)[n].bv_val = NULL;
 366                 break;
 367         case BvVec:
 368                 *b->res.bv = ber_memalloc_x( (n+1)*sizeof( struct berval *),
 369                         b->ber->ber_memctx);
 370                 if ( *b->res.bv == NULL ) return LBER_DEFAULT;
 371                 (*b->res.bv)[n] = NULL;
 372                 break;
 373         case BvOff:
 374                 *b->res.ba = ber_memalloc_x( (n+1) * b->siz, b->ber->ber_memctx );
 375                 if ( *b->res.ba == NULL ) return LBER_DEFAULT;
 376                 ((struct berval *)((long)(*b->res.ba) + n*b->siz +
 377                         b->off))->bv_val = NULL;
 378                 break;
 379         }
 380         b->ber->ber_ptr = orig;
 381         b->ber->ber_tag = tag;
 382         ber_skip_tag( b->ber, &len );
 383
 384         for (n=0; n<i; n++)
 385         {
 386                 tag = ber_next_element( b->ber, &len, last );
 387                 if ( ber_get_stringbv( b->ber, &bv, b->alloc ) == LBER_DEFAULT ) {
 388                         goto nomem;
 389                 }
 390
 391                 /* store my result */
 392                 switch (b->choice) {
 393                 case ChArray:
 394                         (*b->res.c)[n] = bv.bv_val;
 395                         break;
 396                 case BvArray:
 397                         (*b->res.ba)[n] = bv;
 398                         break;
 399                 case BvVec:
 400                         bvp = ber_memalloc_x( sizeof( struct berval ), b->ber->ber_memctx);
 401                         if ( !bvp ) {
 402                                 LBER_FREE(bv.bv_val);
 403                                 goto nomem;
 404                         }
 405                         (*b->res.bv)[n] = bvp;
 406                         *bvp = bv;
 407                         break;
 408                 case BvOff:
 409                         *(BerVarray)((long)(*b->res.ba)+n*b->siz+b->off) = bv;
 410                         break;
 411                 }
 412         }
 413         return tag;
 414
 415 nomem:
 416         if (b->alloc || b->choice == BvVec) {
 417                 for (--n; n>=0; n--) {
 418                         switch(b->choice) {
 419                         case ChArray:
 420                                 LBER_FREE((*b->res.c)[n]);
 421                                 break;
 422                         case BvArray:
 423                                 LBER_FREE((*b->res.ba)[n].bv_val);
 424                                 break;
 425                         case BvVec:
 426                                 LBER_FREE((*b->res.bv)[n]->bv_val);
 427                                 LBER_FREE((*b->res.bv)[n]);
 428                                 break;
 429                         default:
 430                                 break;
 431                         }
 432                 }
 433         }
 434         LBER_FREE(*b->res.c);
 435         *b->res.c = NULL;
 436         return LBER_DEFAULT;
 437 }
 438
 439 ber_tag_t
 440 ber_get_stringbv( BerElement *ber, struct berval *bv, int alloc )
 441 {
 442         ber_tag_t       tag;
 443
 444         assert( ber != NULL );
 445         assert( bv != NULL );
 446
 447         assert( LBER_VALID( ber ) );
 448
 449         if ( (tag = ber_skip_tag( ber, &bv->bv_len )) == LBER_DEFAULT ) {
 450                 bv->bv_val = NULL;
 451                 return LBER_DEFAULT;
 452         }
 453
 454         if ( (ber_len_t) ber_pvt_ber_remaining( ber ) < bv->bv_len ) {
 455                 return LBER_DEFAULT;
 456         }
 457
 458         if ( alloc ) {
 459                 bv->bv_val = (char *) ber_memalloc_x( bv->bv_len + 1,
 460                         ber->ber_memctx );
 461                 if ( bv->bv_val == NULL ) {
 462                         return LBER_DEFAULT;
 463                 }
 464
 465                 if ( bv->bv_len > 0 && (ber_len_t) ber_read( ber, bv->bv_val,
 466                         bv->bv_len ) != bv->bv_len )
 467                 {
 468                         LBER_FREE( bv->bv_val );
 469                         bv->bv_val = NULL;
 470                         return LBER_DEFAULT;
 471                 }
 472         } else {
 473                 bv->bv_val = ber->ber_ptr;
 474                 ber->ber_ptr += bv->bv_len;
 475         }
 476         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 477         bv->bv_val[bv->bv_len] = '\0';
 478
 479         return tag;
 480 }
 481
 482 ber_tag_t
 483 ber_get_stringbv_null( BerElement *ber, struct berval *bv, int alloc )
 484 {
 485         ber_tag_t       tag;
 486
 487         assert( ber != NULL );
 488         assert( bv != NULL );
 489
 490         assert( LBER_VALID( ber ) );
 491
 492         if ( (tag = ber_skip_tag( ber, &bv->bv_len )) == LBER_DEFAULT ) {
 493                 bv->bv_val = NULL;
 494                 return LBER_DEFAULT;
 495         }
 496
 497         if ( (ber_len_t) ber_pvt_ber_remaining( ber ) < bv->bv_len ) {
 498                 return LBER_DEFAULT;
 499         }
 500
 501         if ( bv->bv_len == 0 ) {
 502                 bv->bv_val = NULL;
 503                 ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 504                 return tag;
 505         }
 506
 507         if ( alloc ) {
 508                 bv->bv_val = (char *) ber_memalloc_x( bv->bv_len + 1,
 509                         ber->ber_memctx );
 510                 if ( bv->bv_val == NULL ) {
 511                         return LBER_DEFAULT;
 512                 }
 513
 514                 if ( bv->bv_len > 0 && (ber_len_t) ber_read( ber, bv->bv_val,
 515                         bv->bv_len ) != bv->bv_len )
 516                 {
 517                         LBER_FREE( bv->bv_val );
 518                         bv->bv_val = NULL;
 519                         return LBER_DEFAULT;
 520                 }
 521         } else {
 522                 bv->bv_val = ber->ber_ptr;
 523                 ber->ber_ptr += bv->bv_len;
 524         }
 525         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 526         bv->bv_val[bv->bv_len] = '\0';
 527
 528         return tag;
 529 }
 530
 531 ber_tag_t
 532 ber_get_stringa( BerElement *ber, char **buf )
 533 {
 534         BerValue        bv;
 535         ber_tag_t       tag;
 536
 537         assert( buf != NULL );
 538
 539         tag = ber_get_stringbv( ber, &bv, 1 );
 540         *buf = bv.bv_val;
 541
 542         return tag;
 543 }
 544
 545 ber_tag_t
 546 ber_get_stringa_null( BerElement *ber, char **buf )
 547 {
 548         BerValue        bv;
 549         ber_tag_t       tag;
 550
 551         assert( buf != NULL );
 552
 553         tag = ber_get_stringbv_null( ber, &bv, 1 );
 554         *buf = bv.bv_val;
 555
 556         return tag;
 557 }
 558
 559 ber_tag_t
 560 ber_get_stringal( BerElement *ber, struct berval **bv )
 561 {
 562         ber_tag_t       tag;
 563
 564         assert( ber != NULL );
 565         assert( bv != NULL );
 566
 567         *bv = (struct berval *) ber_memalloc_x( sizeof(struct berval),
 568                 ber->ber_memctx );
 569         if ( *bv == NULL ) {
 570                 return LBER_DEFAULT;
 571         }
 572
 573         tag = ber_get_stringbv( ber, *bv, 1 );
 574         if ( tag == LBER_DEFAULT ) {
 575                 LBER_FREE( *bv );
 576                 *bv = NULL;
 577         }
 578         return tag;
 579 }
 580
 581 ber_tag_t
 582 ber_get_bitstringa(
 583         BerElement *ber,
 584         char **buf,
 585         ber_len_t *blen )
 586 {
 587         ber_len_t       datalen;
 588         ber_tag_t       tag;
 589         unsigned char   unusedbits;
 590
 591         assert( ber != NULL );
 592         assert( buf != NULL );
 593         assert( blen != NULL );
 594
 595         assert( LBER_VALID( ber ) );
 596
 597         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
 598                 *buf = NULL;
 599                 return LBER_DEFAULT;
 600         }
 601         --datalen;
 602
 603         *buf = (char *) ber_memalloc_x( datalen, ber->ber_memctx );
 604         if ( *buf == NULL ) {
 605                 return LBER_DEFAULT;
 606         }
 607
 608         if ( ber_read( ber, (char *)&unusedbits, 1 ) != 1 ) {
 609                 LBER_FREE( buf );
 610                 *buf = NULL;
 611                 return LBER_DEFAULT;
 612         }
 613
 614         if ( (ber_len_t) ber_read( ber, *buf, datalen ) != datalen ) {
 615                 LBER_FREE( buf );
 616                 *buf = NULL;
 617                 return LBER_DEFAULT;
 618         }
 619         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 620
 621         *blen = datalen * 8 - unusedbits;
 622         return tag;
 623 }
 624
 625 ber_tag_t
 626 ber_get_null( BerElement *ber )
 627 {
 628         ber_len_t       len;
 629         ber_tag_t       tag;
 630
 631         assert( ber != NULL );
 632         assert( LBER_VALID( ber ) );
 633
 634         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
 635                 return LBER_DEFAULT;
 636         }
 637
 638         if ( len != 0 ) {
 639                 return LBER_DEFAULT;
 640         }
 641         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 642
 643         return( tag );
 644 }
 645
 646 ber_tag_t
 647 ber_get_boolean(
 648         BerElement *ber,
 649         ber_int_t *boolval )
 650 {
 651         ber_int_t       longbool;
 652         ber_tag_t       rc;
 653
 654         assert( ber != NULL );
 655         assert( boolval != NULL );
 656
 657         assert( LBER_VALID( ber ) );
 658
 659         rc = ber_get_int( ber, &longbool );
 660         *boolval = longbool;
 661
 662         return rc;
 663 }
 664
 665 ber_tag_t
 666 ber_first_element(
 667         BerElement *ber,
 668         ber_len_t *len,
 669         char **last )
 670 {
 671         assert( ber != NULL );
 672         assert( len != NULL );
 673         assert( last != NULL );
 674
 675         /* skip the sequence header, use the len to mark where to stop */
 676         if ( ber_skip_tag( ber, len ) == LBER_DEFAULT ) {
 677                 *last = NULL;
 678                 return LBER_DEFAULT;
 679         }
 680         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 681
 682         *last = ber->ber_ptr + *len;
 683
 684         if ( *last == ber->ber_ptr ) {
 685                 return LBER_DEFAULT;
 686         }
 687
 688         return ber_peek_tag( ber, len );
 689 }
 690
 691 ber_tag_t
 692 ber_next_element(
 693         BerElement *ber,
 694         ber_len_t *len,
 695         LDAP_CONST char *last )
 696 {
 697         assert( ber != NULL );
 698         assert( len != NULL );
 699         assert( last != NULL );
 700
 701         assert( LBER_VALID( ber ) );
 702
 703         if ( ber->ber_ptr >= last ) {
 704                 return LBER_DEFAULT;
 705         }
 706
 707         return ber_peek_tag( ber, len );
 708 }
 709
 710 /* VARARGS */
 711 ber_tag_t
 712 ber_scanf ( BerElement *ber,
 713         LDAP_CONST char *fmt,
 714         ... )
 715 {
 716         va_list         ap;
 717         LDAP_CONST char         *fmt_reset;
 718         char            *s, **ss;
 719         struct berval   **bvp, *bval;
 720         ber_int_t       *i;
 721         ber_len_t       *l;
 722         ber_tag_t       *t;
 723         ber_tag_t       rc;
 724         ber_len_t       len;
 725
 726         va_start( ap, fmt );
 727
 728         assert( ber != NULL );
 729         assert( fmt != NULL );
 730
 731         assert( LBER_VALID( ber ) );
 732
 733         fmt_reset = fmt;
 734
 735         ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
 736                 "ber_scanf fmt (%s) ber:\n", fmt );
 737         ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
 738
 739         for ( rc = 0; *fmt && rc != LBER_DEFAULT; fmt++ ) {
 740                 /* When this is modified, remember to update
 741                  * the error-cleanup code below accordingly. */
 742                 switch ( *fmt ) {
 743                 case '!': { /* Hook */
 744                                 BERDecodeCallback *f;
 745                                 void *p;
 746
 747                                 f = va_arg( ap, BERDecodeCallback * );
 748                                 p = va_arg( ap, void * );
 749
 750                                 rc = (*f)( ber, p, 0 );
 751                         } break;
 752
 753                 case 'a':       /* octet string - allocate storage as needed */
 754                         ss = va_arg( ap, char ** );
 755                         rc = ber_get_stringa( ber, ss );
 756                         break;
 757
 758                 case 'A':       /* octet string - allocate storage as needed,
 759                                  * but return NULL if len == 0 */
 760                         ss = va_arg( ap, char ** );
 761                         rc = ber_get_stringa_null( ber, ss );
 762                         break;
 763
 764                 case 'b':       /* boolean */
 765                         i = va_arg( ap, ber_int_t * );
 766                         rc = ber_get_boolean( ber, i );
 767                         break;
 768
 769                 case 'B':       /* bit string - allocate storage as needed */
 770                         ss = va_arg( ap, char ** );
 771                         l = va_arg( ap, ber_len_t * ); /* for length, in bits */
 772                         rc = ber_get_bitstringa( ber, ss, l );
 773                         break;
 774
 775                 case 'e':       /* enumerated */
 776                 case 'i':       /* int */
 777                         i = va_arg( ap, ber_int_t * );
 778                         rc = ber_get_int( ber, i );
 779                         break;
 780
 781                 case 'l':       /* length of next item */
 782                         l = va_arg( ap, ber_len_t * );
 783                         rc = ber_peek_tag( ber, l );
 784                         break;
 785
 786                 case 'm':       /* octet string in berval, in-place */
 787                         bval = va_arg( ap, struct berval * );
 788                         rc = ber_get_stringbv( ber, bval, 0 );
 789                         break;
 790
 791                 case 'M':       /* bvoffarray - must include address of
 792                                  * a record len, and record offset.
 793                                  * number of records will be returned thru
 794                                  * len ptr on finish. parsed in-place.
 795                                  */
 796                 {
 797                         bgbvr cookie = { BvOff };
 798                         cookie.ber = ber;
 799                         cookie.res.ba = va_arg( ap, struct berval ** );
 800                         cookie.alloc = 0;
 801                         l = va_arg( ap, ber_len_t * );
 802                         cookie.siz = *l;
 803                         cookie.off = va_arg( ap, ber_len_t );
 804                         rc = ber_get_stringbvl( &cookie, l );
 805                         break;
 806                 }
 807
 808                 case 'n':       /* null */
 809                         rc = ber_get_null( ber );
 810                         break;
 811
 812                 case 'o':       /* octet string in a supplied berval */
 813                         bval = va_arg( ap, struct berval * );
 814                         rc = ber_get_stringbv( ber, bval, 1 );
 815                         break;
 816
 817                 case 'O':       /* octet string - allocate & include length */
 818                         bvp = va_arg( ap, struct berval ** );
 819                         rc = ber_get_stringal( ber, bvp );
 820                         break;
 821
 822                 case 's':       /* octet string - in a buffer */
 823                         s = va_arg( ap, char * );
 824                         l = va_arg( ap, ber_len_t * );
 825                         rc = ber_get_stringb( ber, s, l );
 826                         break;
 827
 828                 case 't':       /* tag of next item */
 829                         t = va_arg( ap, ber_tag_t * );
 830                         *t = rc = ber_peek_tag( ber, &len );
 831                         break;
 832
 833                 case 'T':       /* skip tag of next item */
 834                         t = va_arg( ap, ber_tag_t * );
 835                         *t = rc = ber_skip_tag( ber, &len );
 836                         break;
 837
 838                 case 'v':       /* sequence of strings */
 839                 {
 840                         bgbvr cookie = { ChArray };
 841                         cookie.ber = ber;
 842                         cookie.res.c = va_arg( ap, char *** );
 843                         cookie.alloc = 1;
 844                         rc = ber_get_stringbvl( &cookie, NULL );
 845                         break;
 846                 }
 847
 848                 case 'V':       /* sequence of strings + lengths */
 849                 {
 850                         bgbvr cookie = { BvVec };
 851                         cookie.ber = ber;
 852                         cookie.res.bv = va_arg( ap, struct berval *** );
 853                         cookie.alloc = 1;
 854                         rc = ber_get_stringbvl( &cookie, NULL );
 855                         break;
 856                 }
 857
 858                 case 'W':       /* bvarray */
 859                 {
 860                         bgbvr cookie = { BvArray };
 861                         cookie.ber = ber;
 862                         cookie.res.ba = va_arg( ap, struct berval ** );
 863                         cookie.alloc = 1;
 864                         rc = ber_get_stringbvl( &cookie, NULL );
 865                         break;
 866                 }
 867
 868                 case 'x':       /* skip the next element - whatever it is */
 869                         if ( (rc = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
 870                                 break;
 871                         ber->ber_ptr += len;
 872                         ber->ber_tag = *(unsigned char *)ber->ber_ptr;
 873                         break;
 874
 875                 case '{':       /* begin sequence */
 876                 case '[':       /* begin set */
 877                         if ( *(fmt + 1) != 'v' && *(fmt + 1) != 'V'
 878                                 && *(fmt + 1) != 'W' && *(fmt + 1) != 'M' )
 879                                 rc = ber_skip_tag( ber, &len );
 880                         break;
 881
 882                 case '}':       /* end sequence */
 883                 case ']':       /* end set */
 884                         break;
 885
 886                 default:
 887                         if( ber->ber_debug ) {
 888                                 ber_log_printf( LDAP_DEBUG_ANY, ber->ber_debug,
 889                                         "ber_scanf: unknown fmt %c\n", *fmt );
 890                         }
 891                         rc = LBER_DEFAULT;
 892                         break;
 893                 }
 894         }
 895
 896         va_end( ap );
 897         if ( rc == LBER_DEFAULT ) {
 898                 /*
 899                  * Error.  Reclaim malloced memory that was given to the caller.
 900                  * Set allocated pointers to NULL, "data length" outvalues to 0.
 901                  */
 902                 va_start( ap, fmt );
 903
 904                 for ( ; fmt_reset < fmt; fmt_reset++ ) {
 905                 switch ( *fmt_reset ) {
 906                 case '!': { /* Hook */
 907                                 BERDecodeCallback *f;
 908                                 void *p;
 909
 910                                 f = va_arg( ap, BERDecodeCallback * );
 911                                 p = va_arg( ap, void * );
 912
 913                                 (void) (*f)( ber, p, 1 );
 914                         } break;
 915
 916                 case 'a':       /* octet string - allocate storage as needed */
 917                 case 'A':
 918                         ss = va_arg( ap, char ** );
 919                         if ( *ss ) {
 920                                 LBER_FREE( *ss );
 921                                 *ss = NULL;
 922                         }
 923                         break;
 924
 925                 case 'b':       /* boolean */
 926                 case 'e':       /* enumerated */
 927                 case 'i':       /* int */
 928                         (void) va_arg( ap, int * );
 929                         break;
 930
 931                 case 'l':       /* length of next item */
 932                         (void) va_arg( ap, ber_len_t * );
 933                         break;
 934
 935                 case 'o':       /* octet string in a supplied berval */
 936                         bval = va_arg( ap, struct berval * );
 937                         if ( bval->bv_val != NULL ) {
 938                                 LBER_FREE( bval->bv_val );
 939                                 bval->bv_val = NULL;
 940                         }
 941                         bval->bv_len = 0;
 942                         break;
 943
 944                 case 'O':       /* octet string - allocate & include length */
 945                         bvp = va_arg( ap, struct berval ** );
 946                         if ( *bvp ) {
 947                                 ber_bvfree( *bvp );
 948                                 *bvp = NULL;
 949                         }
 950                         break;
 951
 952                 case 's':       /* octet string - in a buffer */
 953                         (void) va_arg( ap, char * );
 954                         (void) va_arg( ap, ber_len_t * );
 955                         break;
 956
 957                 case 't':       /* tag of next item */
 958                 case 'T':       /* skip tag of next item */
 959                         (void) va_arg( ap, ber_tag_t * );
 960                         break;
 961
 962                 case 'B':       /* bit string - allocate storage as needed */
 963                         ss = va_arg( ap, char ** );
 964                         if ( *ss ) {
 965                                 LBER_FREE( *ss );
 966                                 *ss = NULL;
 967                         }
 968                         *(va_arg( ap, ber_len_t * )) = 0; /* for length, in bits */
 969                         break;
 970
 971                 case 'm':       /* berval in-place */
 972                 case 'M':       /* BVoff array in-place */
 973                 case 'n':       /* null */
 974                 case 'v':       /* sequence of strings */
 975                 case 'V':       /* sequence of strings + lengths */
 976                 case 'W':       /* BerVarray */
 977                 case 'x':       /* skip the next element - whatever it is */
 978                 case '{':       /* begin sequence */
 979                 case '[':       /* begin set */
 980                 case '}':       /* end sequence */
 981                 case ']':       /* end set */
 982                         break;
 983
 984                 default:
 985                         /* format should be good */
 986                         assert( 0 );
 987                 }
 988                 }
 989
 990                 va_end( ap );
 991         }
 992
 993         return rc;
 994 }