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