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