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