]> git.sur5r.net Git - openldap/blob - libraries/liblber/io.c
ITS#2657: authzid (and assertion) should apply to most everything
[openldap] / libraries / liblber / io.c
1 /* io.c - ber general i/o routines */
2 /* $OpenLDAP$ */
3 /*
4  * Copyright 1998-2003 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/ctype.h>
26 #include <ac/errno.h>
27 #include <ac/socket.h>
28 #include <ac/string.h>
29 #include <ac/unistd.h>
30
31 #ifdef HAVE_IO_H
32 #include <io.h>
33 #endif
34
35 #include "lber-int.h"
36 #include "ldap_log.h"
37
38 ber_slen_t
39 ber_read(
40         BerElement *ber,
41         char *buf,
42         ber_len_t len )
43 {
44         ber_len_t       actuallen, nleft;
45
46         assert( ber != NULL );
47         assert( buf != NULL );
48
49         assert( LBER_VALID( ber ) );
50
51         nleft = ber_pvt_ber_remaining( ber );
52         actuallen = nleft < len ? nleft : len;
53
54         AC_MEMCPY( buf, ber->ber_ptr, actuallen );
55
56         ber->ber_ptr += actuallen;
57
58         return( (ber_slen_t) actuallen );
59 }
60
61 ber_slen_t
62 ber_write(
63         BerElement *ber,
64         LDAP_CONST char *buf,
65         ber_len_t len,
66         int nosos )
67 {
68         assert( ber != NULL );
69         assert( buf != NULL );
70
71         assert( LBER_VALID( ber ) );
72
73         if ( nosos || ber->ber_sos == NULL ) {
74                 if ( ber->ber_ptr + len > ber->ber_end ) {
75                         if ( ber_realloc( ber, len ) != 0 ) return( -1 );
76                 }
77                 AC_MEMCPY( ber->ber_ptr, buf, (size_t)len );
78                 ber->ber_ptr += len;
79                 return( (ber_slen_t) len );
80
81         } else {
82                 if ( ber->ber_sos->sos_ptr + len > ber->ber_end ) {
83                         if ( ber_realloc( ber, len ) != 0 ) return( -1 );
84                 }
85                 AC_MEMCPY( ber->ber_sos->sos_ptr, buf, (size_t)len );
86                 ber->ber_sos->sos_ptr += len;
87                 ber->ber_sos->sos_clen += len;
88                 return( (ber_slen_t) len );
89         }
90 }
91
92 int
93 ber_realloc( BerElement *ber, ber_len_t len )
94 {
95         ber_len_t       total;
96         Seqorset        *s;
97         long            off;
98         char            *oldbuf;
99
100         assert( ber != NULL );
101         assert( len > 0 );
102         assert( LBER_VALID( ber ) );
103
104         total = ber_pvt_ber_total( ber );
105
106 #define LBER_EXBUFSIZ   4060 /* a few words less than 2^N for binary buddy */
107 #if defined( LBER_EXBUFSIZ ) && LBER_EXBUFSIZ > 0
108 # ifndef notdef
109         /* don't realloc by small amounts */
110         total += len < LBER_EXBUFSIZ ? LBER_EXBUFSIZ : len;
111 # else
112         {       /* not sure what value this adds */
113                 ber_len_t have = (total + (LBER_EXBUFSIZE - 1)) / LBER_EXBUFSIZ;
114                 ber_len_t need = (len + (LBER_EXBUFSIZ - 1)) / LBER_EXBUFSIZ;
115                 total = ( have + need ) * LBER_EXBUFSIZ;
116         }
117 # endif
118 #else
119         total += len;   /* realloc just what's needed */
120 #endif
121
122         oldbuf = ber->ber_buf;
123
124         ber->ber_buf = (char *) ber_memrealloc_x( oldbuf, total, ber->ber_memctx );
125         
126         if ( ber->ber_buf == NULL ) {
127                 ber->ber_buf = oldbuf;
128                 return( -1 );
129         }
130
131         ber->ber_end = ber->ber_buf + total;
132
133         /*
134          * If the stinking thing was moved, we need to go through and
135          * reset all the sos and ber pointers.  Offsets would've been
136          * a better idea... oh well.
137          */
138
139         if ( ber->ber_buf != oldbuf ) {
140                 ber->ber_ptr = ber->ber_buf + (ber->ber_ptr - oldbuf);
141
142                 for ( s = ber->ber_sos; s != NULL; s = s->sos_next ) {
143                         off = s->sos_first - oldbuf;
144                         s->sos_first = ber->ber_buf + off;
145
146                         off = s->sos_ptr - oldbuf;
147                         s->sos_ptr = ber->ber_buf + off;
148                 }
149         }
150
151         return( 0 );
152 }
153
154 void
155 ber_free_buf( BerElement *ber )
156 {
157         Seqorset *s, *next;
158
159         assert( LBER_VALID( ber ) );
160
161         if ( ber->ber_buf) ber_memfree_x( ber->ber_buf, ber->ber_memctx );
162
163         for( s = ber->ber_sos ; s != NULL ; s = next ) {
164                 next = s->sos_next;
165                 ber_memfree_x( s, ber->ber_memctx );
166         }
167
168         ber->ber_buf = NULL;
169         ber->ber_sos = NULL;
170         ber->ber_valid = LBER_UNINITIALIZED;
171 }
172
173 void
174 ber_free( BerElement *ber, int freebuf )
175 {
176 #ifdef LDAP_MEMORY_DEBUG
177         assert( ber != NULL );
178 #endif
179
180         if( ber == NULL ) {
181                 return;
182         }
183
184         if( freebuf ) ber_free_buf( ber );
185
186         ber_memfree_x( (char *) ber, ber->ber_memctx );
187 }
188
189 int
190 ber_flush( Sockbuf *sb, BerElement *ber, int freeit )
191 {
192         ber_len_t       towrite;
193         ber_slen_t      rc;     
194
195         assert( sb != NULL );
196         assert( ber != NULL );
197
198         assert( SOCKBUF_VALID( sb ) );
199         assert( LBER_VALID( ber ) );
200
201         if ( ber->ber_rwptr == NULL ) {
202                 ber->ber_rwptr = ber->ber_buf;
203         }
204         towrite = ber->ber_ptr - ber->ber_rwptr;
205
206         if ( sb->sb_debug ) {
207 #ifdef NEW_LOGGING
208                 LDAP_LOG( BER, DETAIL1,
209                            "ber_flush: %ld bytes to sd %ld%s\n",
210                            towrite, (long)sb->sb_fd,
211                            ber->ber_rwptr != ber->ber_buf ? " (re-flush)" : "" );
212
213                 if(LDAP_LOGS_TEST(BER, DETAIL2))
214                                 BER_DUMP(( "liblber", LDAP_LEVEL_DETAIL2, ber, 1 ));
215
216 #else
217                 ber_log_printf( LDAP_DEBUG_TRACE, sb->sb_debug,
218                         "ber_flush: %ld bytes to sd %ld%s\n",
219                         towrite, (long) sb->sb_fd,
220                         ber->ber_rwptr != ber->ber_buf ?  " (re-flush)" : "" );
221                 ber_log_bprint( LDAP_DEBUG_PACKETS, sb->sb_debug,
222                         ber->ber_rwptr, towrite );
223 #endif
224         }
225
226         while ( towrite > 0 ) {
227 #ifdef LBER_TRICKLE
228                 sleep(1);
229                 rc = ber_int_sb_write( sb, ber->ber_rwptr, 1 );
230 #else
231                 rc = ber_int_sb_write( sb, ber->ber_rwptr, towrite );
232 #endif
233                 if (rc<=0) {
234                         return -1;
235                 }
236                 towrite -= rc;
237                 ber->ber_rwptr += rc;
238         } 
239
240         if ( freeit ) ber_free( ber, 1 );
241
242         return( 0 );
243 }
244
245 BerElement *
246 ber_alloc_t( int options )
247 {
248         BerElement      *ber;
249
250     ber_int_options.lbo_valid = LBER_INITIALIZED;
251
252         ber = (BerElement *) LBER_CALLOC( 1, sizeof(BerElement) );
253
254         if ( ber == NULL ) {
255                 return NULL;
256         }
257
258         ber->ber_valid = LBER_VALID_BERELEMENT;
259         ber->ber_tag = LBER_DEFAULT;
260         ber->ber_options = options;
261         ber->ber_debug = ber_int_debug;
262
263         assert( LBER_VALID( ber ) );
264         return ber;
265 }
266
267 BerElement *
268 ber_alloc( void )       /* deprecated */
269 {
270         return ber_alloc_t( 0 );
271 }
272
273 BerElement *
274 der_alloc( void )       /* deprecated */
275 {
276         return ber_alloc_t( LBER_USE_DER );
277 }
278
279 BerElement *
280 ber_dup( BerElement *ber )
281 {
282         BerElement      *new;
283
284         assert( ber != NULL );
285         assert( LBER_VALID( ber ) );
286
287         if ( (new = ber_alloc_t( ber->ber_options )) == NULL ) {
288                 return NULL;
289         }
290
291         *new = *ber;
292
293         assert( LBER_VALID( new ) );
294         return( new );
295 }
296
297
298 void
299 ber_init2( BerElement *ber, struct berval *bv, int options )
300 {
301         assert( ber != NULL );
302
303         ber_int_options.lbo_valid = LBER_INITIALIZED;
304
305         (void) memset( (char *)ber, '\0', sizeof( BerElement ));
306         ber->ber_valid = LBER_VALID_BERELEMENT;
307         ber->ber_tag = LBER_DEFAULT;
308         ber->ber_options = (char) options;
309         ber->ber_debug = ber_int_debug;
310
311         if ( bv != NULL ) {
312                 ber->ber_buf = bv->bv_val;
313                 ber->ber_ptr = ber->ber_buf;
314                 ber->ber_end = ber->ber_buf + bv->bv_len;
315         }
316
317         assert( LBER_VALID( ber ) );
318 }
319
320 /* OLD U-Mich ber_init() */
321 void
322 ber_init_w_nullc( BerElement *ber, int options )
323 {
324         ber_init2( ber, NULL, options );
325 }
326
327 /* New C-API ber_init() */
328 /* This function constructs a BerElement containing a copy
329 ** of the data in the bv argument.
330 */
331 BerElement *
332 ber_init( struct berval *bv )
333 {
334         BerElement *ber;
335
336         assert( bv != NULL );
337
338     ber_int_options.lbo_valid = LBER_INITIALIZED;
339
340         if ( bv == NULL ) {
341                 return NULL;
342         }
343
344         ber = ber_alloc_t( 0 );
345
346         if( ber == NULL ) {
347                 /* allocation failed */
348                 return NULL;
349         }
350
351         /* copy the data */
352         if ( ((ber_len_t) ber_write ( ber, bv->bv_val, bv->bv_len, 0 ))
353                 != bv->bv_len )
354         {
355                 /* write failed, so free and return NULL */
356                 ber_free( ber, 1 );
357                 return NULL;
358         }
359
360         ber_reset( ber, 1 );    /* reset the pointer to the start of the buffer */
361         return ber;
362 }
363
364 /* New C-API ber_flatten routine */
365 /* This routine allocates a struct berval whose contents are a BER
366 ** encoding taken from the ber argument.  The bvPtr pointer points to
367 ** the returned berval.
368 **
369 ** ber_flatten2 is the same, but uses a struct berval passed by
370 ** the caller. If alloc is 0 the returned bv uses the ber buf directly.
371 */
372 int ber_flatten2(
373         BerElement *ber,
374         struct berval *bv,
375         int alloc )
376 {
377         assert( bv != NULL );
378
379         ber_int_options.lbo_valid = LBER_INITIALIZED;
380
381         if ( bv == NULL ) {
382                 return -1;
383         }
384
385         if ( ber == NULL ) {
386                 /* ber is null, create an empty berval */
387                 bv->bv_val = NULL;
388                 bv->bv_len = 0;
389
390         } else {
391                 /* copy the berval */
392                 ber_len_t len = ber_pvt_ber_write( ber );
393
394                 if ( alloc ) {
395                         bv->bv_val = (char *) ber_memalloc_x( len + 1, ber->ber_memctx );
396                         if ( bv->bv_val == NULL ) {
397                                 return -1;
398                         }
399                         AC_MEMCPY( bv->bv_val, ber->ber_buf, len );
400                 } else {
401                         bv->bv_val = ber->ber_buf;
402                 }
403                 bv->bv_val[len] = '\0';
404                 bv->bv_len = len;
405         }
406         return 0;
407 }
408
409 int ber_flatten(
410         BerElement *ber,
411         struct berval **bvPtr)
412 {
413         struct berval *bv;
414         int rc;
415  
416         assert( bvPtr != NULL );
417
418         ber_int_options.lbo_valid = LBER_INITIALIZED;
419
420         if(bvPtr == NULL) {
421                 return -1;
422         }
423
424         bv = ber_memalloc_x( sizeof(struct berval), ber->ber_memctx );
425         if ( bv == NULL ) {
426                 return -1;
427         }
428         rc = ber_flatten2(ber, bv, 1);
429         if (rc == -1) {
430                 ber_memfree_x(bv, ber->ber_memctx);
431         } else {
432                 *bvPtr = bv;
433         }
434         return rc;
435 }
436
437 void
438 ber_reset( BerElement *ber, int was_writing )
439 {
440         assert( ber != NULL );
441         assert( LBER_VALID( ber ) );
442
443         if ( was_writing ) {
444                 ber->ber_end = ber->ber_ptr;
445                 ber->ber_ptr = ber->ber_buf;
446
447         } else {
448                 ber->ber_ptr = ber->ber_end;
449         }
450
451         ber->ber_rwptr = NULL;
452 }
453
454 /*
455  * A rewrite of ber_get_next that can safely be called multiple times 
456  * for the same packet. It will simply continue where it stopped until
457  * a full packet is read.
458  */
459
460 #define LENSIZE 4
461
462 ber_tag_t
463 ber_get_next(
464         Sockbuf *sb,
465         ber_len_t *len,
466         BerElement *ber )
467 {
468         assert( sb != NULL );
469         assert( len != NULL );
470         assert( ber != NULL );
471
472         assert( SOCKBUF_VALID( sb ) );
473         assert( LBER_VALID( ber ) );
474
475 #ifdef NEW_LOGGING
476         LDAP_LOG( BER, ENTRY, "ber_get_next: enter\n", 0, 0, 0 );
477 #else
478         ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
479                 "ber_get_next\n" );
480 #endif
481
482         /*
483          * Any ber element looks like this: tag length contents.
484          * Assuming everything's ok, we return the tag byte (we
485          * can assume a single byte), return the length in len,
486          * and the rest of the undecoded element in buf.
487          *
488          * Assumptions:
489          *      1) small tags (less than 128)
490          *      2) definite lengths
491          *      3) primitive encodings used whenever possible
492          *
493          * The code also handles multi-byte tags. The first few bytes
494          * of the message are read to check for multi-byte tags and
495          * lengths. These bytes are temporarily stored in the ber_tag,
496          * ber_len, and ber_usertag fields of the berelement until
497          * tag/len parsing is complete. After this parsing, any leftover
498          * bytes and the rest of the message are copied into the ber_buf.
499          *
500          * We expect tag and len to be at most 32 bits wide.
501          */
502
503         if (ber->ber_rwptr == NULL) {
504                 assert( ber->ber_buf == NULL );
505                 ber->ber_rwptr = (char *) &ber->ber_len-1;
506                 ber->ber_ptr = ber->ber_rwptr;
507                 ber->ber_tag = 0;
508         }
509
510         while (ber->ber_rwptr > (char *)&ber->ber_tag && ber->ber_rwptr <
511                 (char *)&ber->ber_len + LENSIZE*2 -1) {
512                 ber_slen_t sblen;
513                 char buf[sizeof(ber->ber_len)-1];
514                 ber_len_t tlen = 0;
515
516                 errno = 0;
517                 sblen=ber_int_sb_read( sb, ber->ber_rwptr,
518                         ((char *)&ber->ber_len + LENSIZE*2 - 1)-ber->ber_rwptr);
519                 if (sblen<=0) return LBER_DEFAULT;
520                 ber->ber_rwptr += sblen;
521
522                 /* We got at least one byte, try to parse the tag. */
523                 if (ber->ber_ptr == (char *)&ber->ber_len-1) {
524                         ber_tag_t tag;
525                         unsigned char *p = (unsigned char *)ber->ber_ptr;
526                         tag = *p++;
527                         if ((tag & LBER_BIG_TAG_MASK) == LBER_BIG_TAG_MASK) {
528                                 ber_len_t i;
529                                 for (i=1; (char *)p<ber->ber_rwptr; i++) {
530                                         tag <<= 8;
531                                         tag |= *p++;
532                                         if (!(tag & LBER_MORE_TAG_MASK))
533                                                 break;
534                                         /* Is the tag too big? */
535                                         if (i == sizeof(ber_tag_t)-1) {
536                                                 errno = ERANGE;
537                                                 return LBER_DEFAULT;
538                                         }
539                                 }
540                                 /* Did we run out of bytes? */
541                                 if ((char *)p == ber->ber_rwptr) {
542 #if defined( EWOULDBLOCK )
543                                         errno = EWOULDBLOCK;
544 #elif defined( EAGAIN )
545                                         errno = EAGAIN;
546 #endif                  
547                                         return LBER_DEFAULT;
548                                 }
549                         }
550                         ber->ber_tag = tag;
551                         ber->ber_ptr = (char *)p;
552                 }
553
554                 if ( ber->ber_ptr == ber->ber_rwptr ) {
555 #if defined( EWOULDBLOCK )
556                         errno = EWOULDBLOCK;
557 #elif defined( EAGAIN )
558                         errno = EAGAIN;
559 #endif                  
560                         return LBER_DEFAULT;
561                 }
562
563                 /* Now look for the length */
564                 if (*ber->ber_ptr & 0x80) {     /* multi-byte */
565                         ber_len_t i;
566                         unsigned char *p = (unsigned char *)ber->ber_ptr;
567                         int llen = *p++ & 0x7f;
568                         if (llen > (int)sizeof(ber_len_t)) {
569                                 errno = ERANGE;
570                                 return LBER_DEFAULT;
571                         }
572                         /* Not enough bytes? */
573                         if (ber->ber_rwptr - (char *)p < llen) {
574 #if defined( EWOULDBLOCK )
575                                 errno = EWOULDBLOCK;
576 #elif defined( EAGAIN )
577                                 errno = EAGAIN;
578 #endif                  
579                                 return LBER_DEFAULT;
580                         }
581                         for (i=0; i<llen; i++) {
582                                 tlen <<=8;
583                                 tlen |= *p++;
584                         }
585                         ber->ber_ptr = (char *)p;
586                 } else {
587                         tlen = *(unsigned char *)ber->ber_ptr++;
588                 }
589
590                 /* Are there leftover data bytes inside ber->ber_len? */
591                 if (ber->ber_ptr < (char *)&ber->ber_usertag) {
592                         if (ber->ber_rwptr < (char *)&ber->ber_usertag) {
593                                 sblen = ber->ber_rwptr - ber->ber_ptr;
594                         } else {
595                                 sblen = (char *)&ber->ber_usertag - ber->ber_ptr;
596                         }
597                         AC_MEMCPY(buf, ber->ber_ptr, sblen);
598                         ber->ber_ptr += sblen;
599                 } else {
600                         sblen = 0;
601                 }
602                 ber->ber_len = tlen;
603
604                 /* now fill the buffer. */
605
606                 /* make sure length is reasonable */
607                 if ( ber->ber_len == 0 ) {
608                         errno = ERANGE;
609                         return LBER_DEFAULT;
610                 }
611
612                 if ( sb->sb_max_incoming && ber->ber_len > sb->sb_max_incoming ) {
613 #ifdef NEW_LOGGING
614                         LDAP_LOG( BER, ERR, 
615                                 "ber_get_next: sockbuf_max_incoming exceeded "
616                                 "(%d > %d)\n", ber->ber_len, sb->sb_max_incoming, 0 );
617 #else
618                         ber_log_printf( LDAP_DEBUG_CONNS, ber->ber_debug,
619                                 "ber_get_next: sockbuf_max_incoming exceeded "
620                                 "(%ld > %ld)\n", ber->ber_len, sb->sb_max_incoming );
621 #endif
622                         errno = ERANGE;
623                         return LBER_DEFAULT;
624                 }
625
626                 if (ber->ber_buf==NULL) {
627                         ber_len_t l = ber->ber_rwptr - ber->ber_ptr;
628                         /* ber->ber_ptr is always <= ber->ber->ber_rwptr.
629                          * make sure ber->ber_len agrees with what we've
630                          * already read.
631                          */
632                         if ( ber->ber_len < sblen + l ) {
633                                 errno = ERANGE;
634                                 return LBER_DEFAULT;
635                         }
636                         ber->ber_buf = (char *) ber_memalloc_x( ber->ber_len + 1, ber->ber_memctx );
637                         if (ber->ber_buf==NULL) {
638                                 return LBER_DEFAULT;
639                         }
640                         ber->ber_end = ber->ber_buf + ber->ber_len;
641                         if (sblen) {
642                                 AC_MEMCPY(ber->ber_buf, buf, sblen);
643                         }
644                         if (l > 0) {
645                                 AC_MEMCPY(ber->ber_buf + sblen, ber->ber_ptr, l);
646                                 sblen += l;
647                         }
648                         ber->ber_ptr = ber->ber_buf;
649                         ber->ber_usertag = 0;
650                         if ((ber_len_t)sblen == ber->ber_len) {
651                                 goto done;
652                         }
653                         ber->ber_rwptr = ber->ber_buf + sblen;
654                 }
655         }
656
657         if ((ber->ber_rwptr>=ber->ber_buf) && (ber->ber_rwptr<ber->ber_end)) {
658                 ber_slen_t res;
659                 ber_slen_t to_go;
660                 
661                 to_go = ber->ber_end - ber->ber_rwptr;
662                 assert( to_go > 0 );
663                 
664                 errno = 0;
665                 res = ber_int_sb_read( sb, ber->ber_rwptr, to_go );
666                 if (res<=0) return LBER_DEFAULT;
667                 ber->ber_rwptr+=res;
668                 
669                 if (res<to_go) {
670 #if defined( EWOULDBLOCK )
671                         errno = EWOULDBLOCK;
672 #elif defined( EAGAIN )
673                         errno = EAGAIN;
674 #endif                  
675                         return LBER_DEFAULT;
676                 }
677 done:
678                 ber->ber_rwptr = NULL;
679                 *len = ber->ber_len;
680                 if ( ber->ber_debug ) {
681 #ifdef NEW_LOGGING
682                         LDAP_LOG( BER, DETAIL1, 
683                                 "ber_get_next: tag 0x%lx len %ld\n", 
684                                 ber->ber_tag, ber->ber_len, 0  );
685                         if(LDAP_LOGS_TEST(BER, DETAIL2))
686                                         BER_DUMP(( "liblber", LDAP_LEVEL_DETAIL2, ber, 1 ));
687 #else
688                         ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
689                                 "ber_get_next: tag 0x%lx len %ld contents:\n",
690                                 ber->ber_tag, ber->ber_len );
691                         ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
692 #endif
693                 }
694                 return (ber->ber_tag);
695         }
696
697         assert( 0 ); /* ber structure is messed up ?*/
698         return LBER_DEFAULT;
699 }
700
701 char *
702 ber_start( BerElement* ber )
703 {
704         return ber->ber_buf;
705 }
706
707 int
708 ber_len( BerElement* ber )
709 {
710         return ( ber->ber_end - ber->ber_buf );
711 }
712
713 int
714 ber_ptrlen( BerElement* ber )
715 {
716         return ( ber->ber_ptr - ber->ber_buf );
717 }
718
719 void
720 ber_rewind ( BerElement * ber )
721 {
722         ber->ber_rwptr = NULL;
723         ber->ber_sos = NULL;
724         ber->ber_end = ber->ber_ptr;
725         ber->ber_ptr = ber->ber_buf;
726 }
727
728 int
729 ber_remaining( BerElement * ber )
730 {
731         return ber_pvt_ber_remaining( ber );
732 }