]> git.sur5r.net Git - openldap/blob - libraries/liblber/decode.c
488318db964670831d23c6702d9ddd591226fdde
[openldap] / libraries / liblber / decode.c
1 /* decode.c - ber input decoding routines */
2 /* $OpenLDAP$ */
3 /*
4  * Copyright 1998-2000 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_read( ber, (char *) &xbyte, 1 ) != 1 ) {
48                 return LBER_DEFAULT;
49         }
50
51         tag = xbyte;
52
53         if ( (xbyte & LBER_BIG_TAG_MASK) != LBER_BIG_TAG_MASK ) {
54                 return tag;
55         }
56
57         for ( i = 1; i < sizeof(ber_tag_t); i++ ) {
58                 if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 ) {
59                         return LBER_DEFAULT;
60                 }
61
62                 tag <<= 8;
63                 tag |= 0x00ffUL & (ber_tag_t) xbyte;
64
65                 if ( ! (xbyte & LBER_MORE_TAG_MASK) ) {
66                         break;
67                 }
68         }
69
70         /* tag too big! */
71         if ( i == sizeof(ber_tag_t) ) {
72                 return LBER_DEFAULT;
73         }
74
75         return tag;
76 }
77
78 ber_tag_t
79 ber_skip_tag( BerElement *ber, ber_len_t *len )
80 {
81         ber_tag_t       tag;
82         unsigned char   lc;
83         ber_len_t       i, noctets;
84         unsigned char netlen[sizeof(ber_len_t)];
85
86         assert( ber != NULL );
87         assert( len != NULL );
88         assert( LBER_VALID( ber ) );
89
90         /*
91          * Any ber element looks like this: tag length contents.
92          * Assuming everything's ok, we return the tag byte (we
93          * can assume a single byte), and return the length in len.
94          *
95          * Assumptions:
96          *      1) definite lengths
97          *      2) primitive encodings used whenever possible
98          */
99
100         *len = 0;
101
102         /*
103          * First, we read the tag.
104          */
105
106         if ( (tag = ber_get_tag( ber )) == LBER_DEFAULT ) {
107                 return LBER_DEFAULT;
108         }
109
110         /*
111          * Next, read the length.  The first byte contains the length of
112          * the length.  If bit 8 is set, the length is the long form,
113          * otherwise it's the short form.  We don't allow a length that's
114          * greater than what we can hold in a ber_len_t.
115          */
116
117         if ( ber_read( ber, (char *) &lc, 1 ) != 1 )
118                 return LBER_DEFAULT;
119
120         if ( lc & 0x80U ) {
121                 noctets = (lc & 0x7fU);
122
123                 if ( noctets > sizeof(ber_len_t) ) {
124                         return LBER_DEFAULT;
125                 }
126
127                 if( (unsigned) ber_read( ber, netlen, noctets ) != noctets ) {
128                         return LBER_DEFAULT;
129                 }
130
131                 for( i = 0; i < noctets; i++ ) {
132                         *len <<= 8;
133                         *len |= netlen[i];
134                 }
135
136         } else {
137                 *len = lc;
138         }
139
140         /* BER length should be non-negative */
141         if( *len < 0 ) {
142                 return LBER_DEFAULT;
143         }
144
145         /* BER element should have enough data left */
146         if( *len > (ber_len_t) ber_pvt_ber_remaining( ber ) ) {
147                 return LBER_DEFAULT;
148         }
149
150         return tag;
151 }
152
153 ber_tag_t
154 ber_peek_tag(
155         BerElement *ber,
156         ber_len_t *len )
157 {
158         /*
159          * This implementation assumes ber_skip_tag() only
160          * modifies ber_ptr field of the BerElement.
161          */
162
163         char *save;
164         ber_tag_t       tag;
165
166         save = ber->ber_ptr;
167         tag = ber_skip_tag( ber, len );
168         ber->ber_ptr = save;
169
170         return tag;
171 }
172
173 static ber_len_t
174 ber_getnint(
175         BerElement *ber,
176         ber_int_t *num,
177         ber_len_t len )
178 {
179         unsigned char buf[sizeof(ber_int_t)];
180
181         assert( ber != NULL );
182         assert( num != NULL );
183         assert( LBER_VALID( ber ) );
184
185         /*
186          * The tag and length have already been stripped off.  We should
187          * be sitting right before len bytes of 2's complement integer,
188          * ready to be read straight into an int.  We may have to sign
189          * extend after we read it in.
190          */
191
192         if ( len > sizeof(ber_int_t) ) {
193                 return -1;
194         }
195
196         /* read into the low-order bytes of our buffer */
197         if ( (ber_len_t) ber_read( ber, (char *) buf, len ) != len ) {
198                 return -1;
199         }
200
201         if( len ) {
202                 /* sign extend if necessary */
203                 ber_len_t i;
204                 ber_int_t netnum = 0x80 & buf[0] ? -1 : 0;
205
206                 /* shift in the bytes */
207                 for( i=0 ; i<len; i++ ) {
208                         netnum = (netnum << 8 ) | buf[i];
209                 }
210
211                 *num = netnum;
212
213         } else {
214                 *num = 0;
215         }
216
217         return len;
218 }
219
220 ber_tag_t
221 ber_get_int(
222         BerElement *ber,
223         ber_int_t *num )
224 {
225         ber_tag_t       tag;
226         ber_len_t       len;
227
228         assert( ber != NULL );
229         assert( LBER_VALID( ber ) );
230
231         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
232                 return LBER_DEFAULT;
233         }
234
235         if ( ber_getnint( ber, num, len ) != len ) {
236                 return LBER_DEFAULT;
237         }
238         
239         return tag;
240 }
241
242 ber_tag_t
243 ber_get_enum(
244         BerElement *ber,
245         ber_int_t *num )
246 {
247         return ber_get_int( ber, num );
248 }
249
250 ber_tag_t
251 ber_get_stringb(
252         BerElement *ber,
253         char *buf,
254         ber_len_t *len )
255 {
256         ber_len_t       datalen;
257         ber_tag_t       tag;
258
259         assert( ber != NULL );
260         assert( LBER_VALID( ber ) );
261
262         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
263                 return LBER_DEFAULT;
264         }
265
266         /* must fit within allocated space with termination */
267         if ( datalen >= *len ) {
268                 return LBER_DEFAULT;
269         }
270
271         if ( (ber_len_t) ber_read( ber, buf, datalen ) != datalen ) {
272                 return LBER_DEFAULT;
273         }
274
275         buf[datalen] = '\0';
276
277         *len = datalen;
278         return tag;
279 }
280
281 ber_tag_t
282 ber_get_stringbv( BerElement *ber, struct berval *bv )
283 {
284         ber_tag_t       tag;
285
286         assert( ber != NULL );
287         assert( bv != NULL );
288
289         assert( LBER_VALID( ber ) );
290
291         if ( (tag = ber_skip_tag( ber, &bv->bv_len )) == LBER_DEFAULT ) {
292                 bv->bv_val = NULL;
293                 return LBER_DEFAULT;
294         }
295
296         if ( (bv->bv_val = (char *) LBER_MALLOC( bv->bv_len + 1 )) == NULL ) {
297                 return LBER_DEFAULT;
298         }
299
300         if ( bv->bv_len > 0 && (ber_len_t) ber_read( ber, bv->bv_val,
301                 bv->bv_len ) != bv->bv_len ) {
302                 LBER_FREE( bv->bv_val );
303                 bv->bv_val = NULL;
304                 return LBER_DEFAULT;
305         }
306         bv->bv_val[bv->bv_len] = '\0';
307
308         return tag;
309 }
310
311 ber_tag_t
312 ber_get_stringa( BerElement *ber, char **buf )
313 {
314         BerValue        bv;
315         ber_tag_t       tag;
316
317         assert( buf != NULL );
318
319         tag = ber_get_stringbv( ber, &bv );
320         *buf = bv.bv_val;
321
322         return tag;
323 }
324
325 ber_tag_t
326 ber_get_stringal( BerElement *ber, struct berval **bv )
327 {
328         ber_tag_t       tag;
329
330         assert( ber != NULL );
331         assert( bv != NULL );
332
333         *bv = (struct berval *) LBER_MALLOC( sizeof(struct berval) );
334         if ( *bv == NULL ) {
335                 return LBER_DEFAULT;
336         }
337
338         tag = ber_get_stringbv( ber, *bv );
339         if ( tag == LBER_DEFAULT ) {
340                 LBER_FREE( *bv );
341                 *bv = NULL;
342         }
343         return tag;
344 }
345
346 ber_tag_t
347 ber_get_bitstringa(
348         BerElement *ber,
349         char **buf,
350         ber_len_t *blen )
351 {
352         ber_len_t       datalen;
353         ber_tag_t       tag;
354         unsigned char   unusedbits;
355
356         assert( ber != NULL );
357         assert( buf != NULL );
358         assert( blen != NULL );
359
360         assert( LBER_VALID( ber ) );
361
362         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
363                 *buf = NULL;
364                 return LBER_DEFAULT;
365         }
366         --datalen;
367
368         if ( (*buf = (char *) LBER_MALLOC( datalen )) == NULL ) {
369                 return LBER_DEFAULT;
370         }
371
372         if ( ber_read( ber, (char *)&unusedbits, 1 ) != 1 ) {
373                 LBER_FREE( buf );
374                 *buf = NULL;
375                 return LBER_DEFAULT;
376         }
377
378         if ( (ber_len_t) ber_read( ber, *buf, datalen ) != datalen ) {
379                 LBER_FREE( buf );
380                 *buf = NULL;
381                 return LBER_DEFAULT;
382         }
383
384         *blen = datalen * 8 - unusedbits;
385         return tag;
386 }
387
388 ber_tag_t
389 ber_get_null( BerElement *ber )
390 {
391         ber_len_t       len;
392         ber_tag_t       tag;
393
394         assert( ber != NULL );
395         assert( LBER_VALID( ber ) );
396
397         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
398                 return LBER_DEFAULT;
399         }
400
401         if ( len != 0 ) {
402                 return LBER_DEFAULT;
403         }
404
405         return( tag );
406 }
407
408 ber_tag_t
409 ber_get_boolean(
410         BerElement *ber,
411         ber_int_t *boolval )
412 {
413         ber_int_t       longbool;
414         ber_tag_t       rc;
415
416         assert( ber != NULL );
417         assert( boolval != NULL );
418
419         assert( LBER_VALID( ber ) );
420
421         rc = ber_get_int( ber, &longbool );
422         *boolval = longbool;
423
424         return rc;
425 }
426
427 ber_tag_t
428 ber_first_element(
429         BerElement *ber,
430         ber_len_t *len,
431         char **last )
432 {
433         assert( ber != NULL );
434         assert( len != NULL );
435         assert( last != NULL );
436
437         /* skip the sequence header, use the len to mark where to stop */
438         if ( ber_skip_tag( ber, len ) == LBER_DEFAULT ) {
439                 *last = NULL;
440                 return LBER_DEFAULT;
441         }
442
443         *last = ber->ber_ptr + *len;
444
445         if ( *last == ber->ber_ptr ) {
446                 return LBER_DEFAULT;
447         }
448
449         return ber_peek_tag( ber, len );
450 }
451
452 ber_tag_t
453 ber_next_element(
454         BerElement *ber,
455         ber_len_t *len,
456         LDAP_CONST char *last )
457 {
458         assert( ber != NULL );
459         assert( len != NULL );
460         assert( last != NULL );
461
462         assert( LBER_VALID( ber ) );
463
464         if ( ber->ber_ptr == last ) {
465                 return LBER_DEFAULT;
466         }
467
468         return ber_peek_tag( ber, len );
469 }
470
471 /* Hopefully no one sends vectors with more elements than this */
472 #define TMP_SLOTS       1024
473
474 /* VARARGS */
475 ber_tag_t
476 ber_scanf ( BerElement *ber,
477         LDAP_CONST char *fmt,
478         ... )
479 {
480         va_list         ap;
481         LDAP_CONST char         *fmt_reset;
482         char            *last;
483         char            *s, **ss, ***sss;
484         struct berval   ***bv, **bvp, *bval;
485         ber_int_t       *i;
486         int j;
487         ber_len_t       *l;
488         ber_tag_t       *t;
489         ber_tag_t       rc, tag;
490         ber_len_t       len;
491
492         va_start( ap, fmt );
493
494         assert( ber != NULL );
495         assert( fmt != NULL );
496
497         assert( LBER_VALID( ber ) );
498
499         fmt_reset = fmt;
500
501 #ifdef NEW_LOGGING
502         LDAP_LOG(( "liblber", LDAP_LEVEL_ENTRY, "ber_scanf fmt (%s) ber:\n", fmt ));
503         BER_DUMP(( "liblber", LDAP_LEVEL_DETAIL2, ber, 1 ));
504 #else
505         ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
506                 "ber_scanf fmt (%s) ber:\n", fmt );
507         ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
508 #endif
509
510         for ( rc = 0; *fmt && rc != LBER_DEFAULT; fmt++ ) {
511                 /* When this is modified, remember to update
512                  * the error-cleanup code below accordingly. */
513                 switch ( *fmt ) {
514                 case '!': { /* Hook */
515                                 BERDecodeCallback *f;
516                                 void *p;
517
518                                 f = va_arg( ap, BERDecodeCallback * );
519                                 p = va_arg( ap, void * );
520
521                                 rc = (*f)( ber, p, 0 );
522                         } break;
523
524                 case 'a':       /* octet string - allocate storage as needed */
525                         ss = va_arg( ap, char ** );
526                         rc = ber_get_stringa( ber, ss );
527                         break;
528
529                 case 'b':       /* boolean */
530                         i = va_arg( ap, ber_int_t * );
531                         rc = ber_get_boolean( ber, i );
532                         break;
533
534                 case 'e':       /* enumerated */
535                 case 'i':       /* int */
536                         i = va_arg( ap, ber_int_t * );
537                         rc = ber_get_int( ber, i );
538                         break;
539
540                 case 'l':       /* length of next item */
541                         l = va_arg( ap, ber_len_t * );
542                         rc = ber_peek_tag( ber, l );
543                         break;
544
545                 case 'n':       /* null */
546                         rc = ber_get_null( ber );
547                         break;
548
549                 case 's':       /* octet string - in a buffer */
550                         s = va_arg( ap, char * );
551                         l = va_arg( ap, ber_len_t * );
552                         rc = ber_get_stringb( ber, s, l );
553                         break;
554
555                 case 'o':       /* octet string in a supplied berval */
556                         bval = va_arg( ap, struct berval * );
557                         rc = ber_get_stringbv( ber, bval );
558                         break;
559
560                 case 'O':       /* octet string - allocate & include length */
561                         bvp = va_arg( ap, struct berval ** );
562                         rc = ber_get_stringal( ber, bvp );
563                         break;
564
565                 case 'B':       /* bit string - allocate storage as needed */
566                         ss = va_arg( ap, char ** );
567                         l = va_arg( ap, ber_len_t * ); /* for length, in bits */
568                         rc = ber_get_bitstringa( ber, ss, l );
569                         break;
570
571                 case 't':       /* tag of next item */
572                         t = va_arg( ap, ber_tag_t * );
573                         *t = rc = ber_peek_tag( ber, &len );
574                         break;
575
576                 case 'T':       /* skip tag of next item */
577                         t = va_arg( ap, ber_tag_t * );
578                         *t = rc = ber_skip_tag( ber, &len );
579                         break;
580
581                 case 'v':       /* sequence of strings */
582                 {
583                         char *tmp[TMP_SLOTS];
584                         sss = va_arg( ap, char *** );
585                         *sss = NULL;
586                         j = 0;
587                         for ( tag = ber_first_element( ber, &len, &last );
588                             tag != LBER_DEFAULT && rc != LBER_DEFAULT;
589                             tag = ber_next_element( ber, &len, last ) )
590                         {
591                                 rc = ber_get_stringa( ber, &tmp[j] );
592                                 j++;
593                                 assert(j < TMP_SLOTS);
594                         }
595                         if (j > 0 && rc != LBER_DEFAULT ) {
596                                 *sss = (char **)LBER_MALLOC( (j+1) * sizeof(char *));
597                                 if (*sss == NULL) {
598                                         rc = LBER_DEFAULT;
599                                 } else {
600                                         (*sss)[j] = NULL;
601                                         for (j--; j>=0; j--)
602                                                 (*sss)[j] = tmp[j];
603                                 }
604                         }
605                         if ( rc == LBER_DEFAULT ) {
606                                 for (j--; j>=0; j--)
607                                         LBER_FREE(tmp[j]);
608                         }
609                         break;
610                 }
611
612                 case 'V':       /* sequence of strings + lengths */
613                 {
614                         struct berval *tmp[TMP_SLOTS];
615                         bv = va_arg( ap, struct berval *** );
616                         *bv = NULL;
617                         j = 0;
618                         for ( tag = ber_first_element( ber, &len, &last );
619                             tag != LBER_DEFAULT && rc != LBER_DEFAULT;
620                             tag = ber_next_element( ber, &len, last ) )
621                         {
622                                 rc = ber_get_stringal( ber, &tmp[j] );
623                                 j++;
624                                 assert( j < TMP_SLOTS);
625                         }
626                         if (j > 0 && rc != LBER_DEFAULT ) {
627                                 *bv = (struct berval **)LBER_MALLOC( (j+1) * sizeof(struct berval *));
628                                 if (*bv == NULL) {
629                                         rc = LBER_DEFAULT;
630                                 } else {
631                                         (*bv)[j] = NULL;
632                                         for (j--; j>=0; j--)
633                                                 (*bv)[j] = tmp[j];
634                                 }
635                         }
636                         if ( rc == LBER_DEFAULT ) {
637                                 for (j--; j>=0; j--)
638                                         ber_bvfree(tmp[j]);
639                         }
640                         break;
641                 }
642
643                 case 'W':       /* bvarray */
644                 {
645                         struct berval tmp[TMP_SLOTS];
646                         bvp = va_arg( ap, struct berval ** );
647                         *bvp = NULL;
648                         j = 0;
649                         for ( tag = ber_first_element( ber, &len, &last );
650                             tag != LBER_DEFAULT && rc != LBER_DEFAULT;
651                             tag = ber_next_element( ber, &len, last ) )
652                         {
653                                 rc = ber_get_stringbv( ber, &tmp[j] );
654                                 j++;
655                                 assert( j < TMP_SLOTS);
656                         }
657                         if (j > 0 && rc != LBER_DEFAULT ) {
658                                 *bvp = (struct berval *)LBER_MALLOC( (j+1) * sizeof(struct berval));
659                                 if (*bvp == NULL) {
660                                         rc = LBER_DEFAULT;
661                                 } else {
662                                         (*bvp)[j].bv_val = NULL;
663                                         (*bvp)[j].bv_len = 0;
664                                         for (j--; j>=0; j--)
665                                                 (*bvp)[j] = tmp[j];
666                                 }
667                         }
668                         if ( rc == LBER_DEFAULT ) {
669                                 for (j--; j>=0; j--)
670                                         LBER_FREE(tmp[j].bv_val);
671                         }
672                         break;
673                 }
674
675                 case 'x':       /* skip the next element - whatever it is */
676                         if ( (rc = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
677                                 break;
678                         ber->ber_ptr += len;
679                         break;
680
681                 case '{':       /* begin sequence */
682                 case '[':       /* begin set */
683                         if ( *(fmt + 1) != 'v' && *(fmt + 1) != 'V'
684                                 && *(fmt + 1) != 'W' )
685                                 rc = ber_skip_tag( ber, &len );
686                         break;
687
688                 case '}':       /* end sequence */
689                 case ']':       /* end set */
690                         break;
691
692                 default:
693                         if( ber->ber_debug ) {
694 #ifdef NEW_LOGGING
695                                 LDAP_LOG(( "liblber", LDAP_LEVEL_ERR,
696                                            "ber_scanf: unknown fmt %c\n", *fmt ));
697 #else
698                                 ber_log_printf( LDAP_DEBUG_ANY, ber->ber_debug,
699                                         "ber_scanf: unknown fmt %c\n", *fmt );
700 #endif
701                         }
702                         rc = LBER_DEFAULT;
703                         break;
704                 }
705         }
706
707         va_end( ap );
708         if ( rc == LBER_DEFAULT ) {
709             /*
710              * Error.  Reclaim malloced memory that was given to the caller.
711              * Set allocated pointers to NULL, "data length" outvalues to 0.
712              */
713             va_start( ap, fmt );
714
715             for ( ; fmt_reset < fmt; fmt_reset++ ) {
716                 switch ( *fmt_reset ) {
717                 case '!': { /* Hook */
718                                 BERDecodeCallback *f;
719                                 void *p;
720
721                                 f = va_arg( ap, BERDecodeCallback * );
722                                 p = va_arg( ap, void * );
723
724                                 (void) (*f)( ber, p, 1 );
725                         } break;
726
727                 case 'a':       /* octet string - allocate storage as needed */
728                         ss = va_arg( ap, char ** );
729                         if ( *ss ) {
730                                 LBER_FREE( *ss );
731                                 *ss = NULL;
732                         }
733                         break;
734
735                 case 'b':       /* boolean */
736                 case 'e':       /* enumerated */
737                 case 'i':       /* int */
738                         (void) va_arg( ap, int * );
739                         break;
740
741                 case 's':       /* octet string - in a buffer */
742                         (void) va_arg( ap, char * );
743                         (void) va_arg( ap, ber_len_t * );
744                         break;
745
746                 case 'l':       /* length of next item */
747                         (void) va_arg( ap, ber_len_t * );
748                         break;
749
750                 case 't':       /* tag of next item */
751                 case 'T':       /* skip tag of next item */
752                         (void) va_arg( ap, ber_tag_t * );
753                         break;
754
755                 case 'o':       /* octet string in a supplied berval */
756                         bval = va_arg( ap, struct berval * );
757                         if ( bval->bv_val != NULL ) {
758                                 LBER_FREE( bval->bv_val );
759                                 bval->bv_val = NULL;
760                         }
761                         bval->bv_len = 0;
762                         break;
763
764                 case 'O':       /* octet string - allocate & include length */
765                         bvp = va_arg( ap, struct berval ** );
766                         if ( *bvp ) {
767                                 ber_bvfree( *bvp );
768                                 *bvp = NULL;
769                         }
770                         break;
771
772                 case 'B':       /* bit string - allocate storage as needed */
773                         ss = va_arg( ap, char ** );
774                         if ( *ss ) {
775                                 LBER_FREE( *ss );
776                                 *ss = NULL;
777                         }
778                         *(va_arg( ap, ber_len_t * )) = 0; /* for length, in bits */
779                         break;
780
781                 case 'v':       /* sequence of strings */
782                 case 'V':       /* sequence of strings + lengths */
783                 case 'W':       /* BVarray */
784                 case 'n':       /* null */
785                 case 'x':       /* skip the next element - whatever it is */
786                 case '{':       /* begin sequence */
787                 case '[':       /* begin set */
788                 case '}':       /* end sequence */
789                 case ']':       /* end set */
790                         break;
791
792                 default:
793                         /* format should be good */
794                         assert( 0 );
795                 }
796             }
797
798             va_end( ap );
799         }
800
801         return rc;
802 }