]> git.sur5r.net Git - openldap/blob - libraries/liblber/decode.c
More ITS#6215: Catch malformed elements in ber_get_stringbvl().
[openldap] / 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         tag = ber_skip_tag( ber, &bv.bv_len );
370
371         if ( tag != LBER_DEFAULT ) {
372                 tag = 0;
373                 orig = ber->ber_ptr;
374                 last = orig + bv.bv_len;
375
376                 for ( ; ber->ber_ptr < last; i++, tot_size += siz ) {
377                         if ( ber_skip_element( ber, &bv ) == LBER_DEFAULT )
378                                 break;
379                 }
380                 if ( ber->ber_ptr != last ) {
381                         i = 0;
382                         tag = LBER_DEFAULT;
383                 }
384
385                 ber->ber_ptr = orig;
386                 ber->ber_tag = *(unsigned char *) orig;
387         }
388
389         b->siz = i;
390         if ( i == 0 ) {
391                 return tag;
392         }
393
394         /* Allocate and NULL-terminate the result vector */
395         b->result = ber_memalloc_x( tot_size + siz, ber->ber_memctx );
396         if ( b->result == NULL ) {
397                 return LBER_DEFAULT;
398         }
399         switch (b->choice) {
400         case ChArray:
401                 res.ca = b->result;
402                 res.ca[i] = NULL;
403                 break;
404         case BvArray:
405                 res.ba = b->result;
406                 res.ba[i].bv_val = NULL;
407                 break;
408         case BvVec:
409                 res.bv = b->result;
410                 res.bv[i] = NULL;
411                 break;
412         case BvOff:
413                 res.bo = (char *) b->result + b->off;
414                 ((struct berval *) (res.bo + tot_size))->bv_val = NULL;
415                 tot_size = 0;
416                 break;
417         }
418
419         n = 0;
420         do {
421                 tag = ber_get_stringbv( ber, &bv, b->alloc );
422                 if ( tag == LBER_DEFAULT ) {
423                         goto nomem;
424                 }
425
426                 /* store my result */
427                 switch (b->choice) {
428                 case ChArray:
429                         res.ca[n] = bv.bv_val;
430                         break;
431                 case BvArray:
432                         res.ba[n] = bv;
433                         break;
434                 case BvVec:
435                         bvp = ber_memalloc_x( sizeof( struct berval ),
436                                 ber->ber_memctx );
437                         if ( !bvp ) {
438                                 ber_memfree_x( bv.bv_val, ber->ber_memctx );
439                                 goto nomem;
440                         }
441                         res.bv[n] = bvp;
442                         *bvp = bv;
443                         break;
444                 case BvOff:
445                         *(struct berval *)(res.bo + tot_size) = bv;
446                         tot_size += siz;
447                         break;
448                 }
449         } while (++n < i);
450         return tag;
451
452 nomem:
453         if (b->choice != BvOff) {       /* BvOff does not have b->alloc set */
454                 while (--n >= 0) {
455                         switch(b->choice) {
456                         case ChArray:
457                                 ber_memfree_x(res.ca[n], ber->ber_memctx);
458                                 break;
459                         case BvArray:
460                                 ber_memfree_x(res.ba[n].bv_val, ber->ber_memctx);
461                                 break;
462                         case BvVec:
463                                 ber_memfree_x(res.bv[n]->bv_val, ber->ber_memctx);
464                                 ber_memfree_x(res.bv[n], ber->ber_memctx);
465                                 break;
466                         default:
467                                 break;
468                         }
469                 }
470         }
471         ber_memfree_x(b->result, ber->ber_memctx);
472         b->result = NULL;
473         return LBER_DEFAULT;
474 }
475
476 ber_tag_t
477 ber_get_stringbv( BerElement *ber, struct berval *bv, int option )
478 {
479         ber_tag_t       tag;
480         char            *data;
481
482         tag = ber_skip_element( ber, bv );
483         if ( tag == LBER_DEFAULT ) {
484                 bv->bv_val = NULL;
485                 return tag;
486         }
487
488         data = bv->bv_val;
489         if ( option & LBER_BV_ALLOC ) {
490                 bv->bv_val = (char *) ber_memalloc_x( bv->bv_len + 1,
491                         ber->ber_memctx );
492                 if ( bv->bv_val == NULL ) {
493                         return LBER_DEFAULT;
494                 }
495
496                 if ( bv->bv_len != 0 ) {
497                         memcpy( bv->bv_val, data, bv->bv_len );
498                 }
499                 data = bv->bv_val;
500         }
501         if ( !( option & LBER_BV_NOTERM ))
502                 data[bv->bv_len] = '\0';
503
504         return tag;
505 }
506
507 ber_tag_t
508 ber_get_stringbv_null( BerElement *ber, struct berval *bv, int option )
509 {
510         ber_tag_t       tag;
511         char            *data;
512
513         tag = ber_skip_element( ber, bv );
514         if ( tag == LBER_DEFAULT || bv->bv_len == 0 ) {
515                 bv->bv_val = NULL;
516                 return tag;
517         }
518
519         data = bv->bv_val;
520         if ( option & LBER_BV_ALLOC ) {
521                 bv->bv_val = (char *) ber_memalloc_x( bv->bv_len + 1,
522                         ber->ber_memctx );
523                 if ( bv->bv_val == NULL ) {
524                         return LBER_DEFAULT;
525                 }
526
527                 memcpy( bv->bv_val, data, bv->bv_len );
528                 data = bv->bv_val;
529         }
530         if ( !( option & LBER_BV_NOTERM ))
531                 data[bv->bv_len] = '\0';
532
533         return tag;
534 }
535
536 ber_tag_t
537 ber_get_stringa( BerElement *ber, char **buf )
538 {
539         BerValue        bv;
540         ber_tag_t       tag;
541
542         assert( buf != NULL );
543
544         tag = ber_get_stringbv( ber, &bv, LBER_BV_ALLOC );
545         *buf = bv.bv_val;
546
547         return tag;
548 }
549
550 ber_tag_t
551 ber_get_stringa_null( BerElement *ber, char **buf )
552 {
553         BerValue        bv;
554         ber_tag_t       tag;
555
556         assert( buf != NULL );
557
558         tag = ber_get_stringbv_null( ber, &bv, LBER_BV_ALLOC );
559         *buf = bv.bv_val;
560
561         return tag;
562 }
563
564 ber_tag_t
565 ber_get_stringal( BerElement *ber, struct berval **bv )
566 {
567         ber_tag_t       tag;
568
569         assert( ber != NULL );
570         assert( bv != NULL );
571
572         *bv = (struct berval *) ber_memalloc_x( sizeof(struct berval),
573                 ber->ber_memctx );
574         if ( *bv == NULL ) {
575                 return LBER_DEFAULT;
576         }
577
578         tag = ber_get_stringbv( ber, *bv, LBER_BV_ALLOC );
579         if ( tag == LBER_DEFAULT ) {
580                 ber_memfree_x( *bv, ber->ber_memctx );
581                 *bv = NULL;
582         }
583         return tag;
584 }
585
586 ber_tag_t
587 ber_get_bitstringa(
588         BerElement *ber,
589         char **buf,
590         ber_len_t *blen )
591 {
592         ber_tag_t       tag;
593         struct berval   data;
594         unsigned char   unusedbits;
595
596         assert( buf != NULL );
597         assert( blen != NULL );
598
599         if ( (tag = ber_skip_element( ber, &data )) == LBER_DEFAULT ) {
600                 goto fail;
601         }
602
603         if ( --data.bv_len > (ber_len_t)-1 / 8 ) {
604                 goto fail;
605         }
606         unusedbits = *(unsigned char *) data.bv_val++;
607         if ( unusedbits > 7 ) {
608                 goto fail;
609         }
610
611         *buf = (char *) ber_memalloc_x( data.bv_len, ber->ber_memctx );
612         if ( *buf == NULL ) {
613                 return LBER_DEFAULT;
614         }
615         memcpy( *buf, data.bv_val, data.bv_len );
616
617         *blen = data.bv_len * 8 - unusedbits;
618         return tag;
619
620  fail:
621         *buf = NULL;
622         return LBER_DEFAULT;
623 }
624
625 ber_tag_t
626 ber_get_null( BerElement *ber )
627 {
628         ber_len_t       len;
629         ber_tag_t       tag = ber_skip_tag( ber, &len );
630
631         return( len == 0 ? tag : LBER_DEFAULT );
632 }
633
634 ber_tag_t
635 ber_get_boolean(
636         BerElement *ber,
637         ber_int_t *boolval )
638 {
639         return ber_get_int( ber, boolval );
640 }
641
642 ber_tag_t
643 ber_first_element(
644         BerElement *ber,
645         ber_len_t *len,
646         char **last )
647 {
648         assert( last != NULL );
649
650         /* skip the sequence header, use the len to mark where to stop */
651         if ( ber_skip_tag( ber, len ) == LBER_DEFAULT ) {
652                 *last = NULL;
653                 return LBER_DEFAULT;
654         }
655
656         *last = ber->ber_ptr + *len;
657
658         if ( *len == 0 ) {
659                 return LBER_DEFAULT;
660         }
661
662         return ber_peek_tag( ber, len );
663 }
664
665 ber_tag_t
666 ber_next_element(
667         BerElement *ber,
668         ber_len_t *len,
669         LDAP_CONST char *last )
670 {
671         assert( ber != NULL );
672         assert( last != NULL );
673         assert( LBER_VALID( ber ) );
674
675         if ( ber->ber_ptr >= last ) {
676                 return LBER_DEFAULT;
677         }
678
679         return ber_peek_tag( ber, len );
680 }
681
682 /* VARARGS */
683 ber_tag_t
684 ber_scanf ( BerElement *ber,
685         LDAP_CONST char *fmt,
686         ... )
687 {
688         va_list         ap;
689         LDAP_CONST char         *fmt_reset;
690         char            *s, **ss, ***sss;
691         struct berval   data, *bval, **bvp, ***bvpp;
692         ber_int_t       *i;
693         ber_len_t       *l;
694         ber_tag_t       *t;
695         ber_tag_t       rc;
696         ber_len_t       len;
697
698         va_start( ap, fmt );
699
700         assert( ber != NULL );
701         assert( fmt != NULL );
702         assert( LBER_VALID( ber ) );
703
704         fmt_reset = fmt;
705
706         if ( ber->ber_debug & (LDAP_DEBUG_TRACE|LDAP_DEBUG_BER)) {
707                 ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
708                         "ber_scanf fmt (%s) ber:\n", fmt );
709                 ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
710         }
711
712         for ( rc = 0; *fmt && rc != LBER_DEFAULT; fmt++ ) {
713                 /* When this is modified, remember to update
714                  * the error-cleanup code below accordingly. */
715                 switch ( *fmt ) {
716                 case '!': { /* Hook */
717                                 BERDecodeCallback *f;
718                                 void *p;
719
720                                 f = va_arg( ap, BERDecodeCallback * );
721                                 p = va_arg( ap, void * );
722
723                                 rc = (*f)( ber, p, 0 );
724                         } break;
725
726                 case 'a':       /* octet string - allocate storage as needed */
727                         ss = va_arg( ap, char ** );
728                         rc = ber_get_stringa( ber, ss );
729                         break;
730
731                 case 'A':       /* octet string - allocate storage as needed,
732                                  * but return NULL if len == 0 */
733                         ss = va_arg( ap, char ** );
734                         rc = ber_get_stringa_null( ber, ss );
735                         break;
736
737                 case 'b':       /* boolean */
738                         i = va_arg( ap, ber_int_t * );
739                         rc = ber_get_boolean( ber, i );
740                         break;
741
742                 case 'B':       /* bit string - allocate storage as needed */
743                         ss = va_arg( ap, char ** );
744                         l = va_arg( ap, ber_len_t * ); /* for length, in bits */
745                         rc = ber_get_bitstringa( ber, ss, l );
746                         break;
747
748                 case 'e':       /* enumerated */
749                 case 'i':       /* integer */
750                         i = va_arg( ap, ber_int_t * );
751                         rc = ber_get_int( ber, i );
752                         break;
753
754                 case 'l':       /* length of next item */
755                         l = va_arg( ap, ber_len_t * );
756                         rc = ber_peek_tag( ber, l );
757                         break;
758
759                 case 'm':       /* octet string in berval, in-place */
760                         bval = va_arg( ap, struct berval * );
761                         rc = ber_get_stringbv( ber, bval, 0 );
762                         break;
763
764                 case 'M':       /* bvoffarray - must include address of
765                                  * a record len, and record offset.
766                                  * number of records will be returned thru
767                                  * len ptr on finish. parsed in-place.
768                                  */
769                 {
770                         bgbvr cookie = { BvOff, 0 };
771                         bvp = va_arg( ap, struct berval ** );
772                         l = va_arg( ap, ber_len_t * );
773                         cookie.siz = *l;
774                         cookie.off = va_arg( ap, ber_len_t );
775                         rc = ber_get_stringbvl( ber, &cookie );
776                         *bvp = cookie.result;
777                         *l = cookie.siz;
778                         break;
779                 }
780
781                 case 'n':       /* null */
782                         rc = ber_get_null( ber );
783                         break;
784
785                 case 'o':       /* octet string in a supplied berval */
786                         bval = va_arg( ap, struct berval * );
787                         rc = ber_get_stringbv( ber, bval, LBER_BV_ALLOC );
788                         break;
789
790                 case 'O':       /* octet string - allocate & include length */
791                         bvp = va_arg( ap, struct berval ** );
792                         rc = ber_get_stringal( ber, bvp );
793                         break;
794
795                 case 's':       /* octet string - in a buffer */
796                         s = va_arg( ap, char * );
797                         l = va_arg( ap, ber_len_t * );
798                         rc = ber_get_stringb( ber, s, l );
799                         break;
800
801                 case 't':       /* tag of next item */
802                         t = va_arg( ap, ber_tag_t * );
803                         *t = rc = ber_peek_tag( ber, &len );
804                         break;
805
806                 case 'T':       /* skip tag of next item */
807                         t = va_arg( ap, ber_tag_t * );
808                         *t = rc = ber_skip_tag( ber, &len );
809                         break;
810
811                 case 'v':       /* sequence of strings */
812                 {
813                         bgbvr cookie = {
814                                 ChArray, LBER_BV_ALLOC, sizeof( char * )
815                         };
816                         rc = ber_get_stringbvl( ber, &cookie );
817                         *(va_arg( ap, char *** )) = cookie.result;
818                         break;
819                 }
820
821                 case 'V':       /* sequence of strings + lengths */
822                 {
823                         bgbvr cookie = {
824                                 BvVec, LBER_BV_ALLOC, sizeof( struct berval * )
825                         };
826                         rc = ber_get_stringbvl( ber, &cookie );
827                         *(va_arg( ap, struct berval *** )) = cookie.result;
828                         break;
829                 }
830
831                 case 'W':       /* bvarray */
832                 {
833                         bgbvr cookie = {
834                                 BvArray, LBER_BV_ALLOC, sizeof( struct berval )
835                         };
836                         rc = ber_get_stringbvl( ber, &cookie );
837                         *(va_arg( ap, struct berval ** )) = cookie.result;
838                         break;
839                 }
840
841                 case 'x':       /* skip the next element - whatever it is */
842                         rc = ber_skip_element( ber, &data );
843                         break;
844
845                 case '{':       /* begin sequence */
846                 case '[':       /* begin set */
847                         switch ( fmt[1] ) {
848                         case 'v': case 'V': case 'W': case 'M':
849                                 break;
850                         default:
851                                 rc = ber_skip_tag( ber, &len );
852                                 break;
853                         }
854                         break;
855
856                 case '}':       /* end sequence */
857                 case ']':       /* end set */
858                         break;
859
860                 default:
861                         if( ber->ber_debug ) {
862                                 ber_log_printf( LDAP_DEBUG_ANY, ber->ber_debug,
863                                         "ber_scanf: unknown fmt %c\n", *fmt );
864                         }
865                         rc = LBER_DEFAULT;
866                         break;
867                 }
868         }
869
870         va_end( ap );
871
872         if ( rc == LBER_DEFAULT ) {
873                 /*
874                  * Error.  Reclaim malloced memory that was given to the caller.
875                  * Set allocated pointers to NULL, "data length" outvalues to 0.
876                  */
877                 va_start( ap, fmt );
878
879                 for ( ; fmt_reset < fmt; fmt_reset++ ) {
880                 switch ( *fmt_reset ) {
881                 case '!': { /* Hook */
882                                 BERDecodeCallback *f;
883                                 void *p;
884
885                                 f = va_arg( ap, BERDecodeCallback * );
886                                 p = va_arg( ap, void * );
887
888                                 (void) (*f)( ber, p, 1 );
889                         } break;
890
891                 case 'a':       /* octet string - allocate storage as needed */
892                 case 'A':
893                         ss = va_arg( ap, char ** );
894                         ber_memfree_x( *ss, ber->ber_memctx );
895                         *ss = NULL;
896                         break;
897
898                 case 'b':       /* boolean */
899                 case 'e':       /* enumerated */
900                 case 'i':       /* integer */
901                         (void) va_arg( ap, ber_int_t * );
902                         break;
903
904                 case 'l':       /* length of next item */
905                         *(va_arg( ap, ber_len_t * )) = 0;
906                         break;
907
908                 case 'm':       /* berval in-place */
909                         bval = va_arg( ap, struct berval * );
910                         BER_BVZERO( bval );
911                         break;
912
913                 case 'M':       /* BVoff array in-place */
914                         bvp = va_arg( ap, struct berval ** );
915                         ber_memfree_x( *bvp, ber->ber_memctx );
916                         *bvp = NULL;
917                         *(va_arg( ap, ber_len_t * )) = 0;
918                         (void) va_arg( ap, ber_len_t );
919                         break;
920
921                 case 'o':       /* octet string in a supplied berval */
922                         bval = va_arg( ap, struct berval * );
923                         ber_memfree_x( bval->bv_val, ber->ber_memctx );
924                         BER_BVZERO( bval );
925                         break;
926
927                 case 'O':       /* octet string - allocate & include length */
928                         bvp = va_arg( ap, struct berval ** );
929                         ber_bvfree_x( *bvp, ber->ber_memctx );
930                         *bvp = NULL;
931                         break;
932
933                 case 's':       /* octet string - in a buffer */
934                         (void) va_arg( ap, char * );
935                         *(va_arg( ap, ber_len_t * )) = 0;
936                         break;
937
938                 case 't':       /* tag of next item */
939                 case 'T':       /* skip tag of next item */
940                         (void) va_arg( ap, ber_tag_t * );
941                         break;
942
943                 case 'B':       /* bit string - allocate storage as needed */
944                         ss = va_arg( ap, char ** );
945                         ber_memfree_x( *ss, ber->ber_memctx );
946                         *ss = NULL;
947                         *(va_arg( ap, ber_len_t * )) = 0; /* for length, in bits */
948                         break;
949
950                 case 'v':       /* sequence of strings */
951                         sss = va_arg( ap, char *** );
952                         ber_memvfree_x( (void **) *sss, ber->ber_memctx );
953                         *sss = NULL;
954                         break;
955
956                 case 'V':       /* sequence of strings + lengths */
957                         bvpp = va_arg( ap, struct berval *** );
958                         ber_bvecfree_x( *bvpp, ber->ber_memctx );
959                         *bvpp = NULL;
960                         break;
961
962                 case 'W':       /* BerVarray */
963                         bvp = va_arg( ap, struct berval ** );
964                         ber_bvarray_free_x( *bvp, ber->ber_memctx );
965                         *bvp = NULL;
966                         break;
967
968                 case 'n':       /* null */
969                 case 'x':       /* skip the next element - whatever it is */
970                 case '{':       /* begin sequence */
971                 case '[':       /* begin set */
972                 case '}':       /* end sequence */
973                 case ']':       /* end set */
974                         break;
975
976                 default:
977                         /* format should be good */
978                         assert( 0 );
979                 }
980                 }
981
982                 va_end( ap );
983         }
984
985         return rc;
986 }