1 /* idl.c - ldap id list handling routines */
10 #include "ldapconfig.h"
12 #include "back-ldbm.h"
15 /* Allocate an ID_BLOCK with room for nids ids */
21 /* nmax + nids + space for the ids */
22 new = (ID_BLOCK *) ch_calloc( (ID_BLOCK_IDS_OFFSET + nids), sizeof(ID) );
23 ID_BLOCK_NMAX(new) = nids;
24 ID_BLOCK_NIDS(new) = 0;
30 /* Allocate an empty ALLIDS ID_BLOCK */
32 idl_allids( Backend *be )
37 ID_BLOCK_NMAX(idl) = ID_BLOCK_ALLIDS_VALUE;
38 ID_BLOCK_NIDS(idl) = next_id_get( be );
44 /* Free an ID_BLOCK */
46 idl_free( ID_BLOCK *idl )
49 Debug( LDAP_DEBUG_TRACE,
50 "idl_free: called with NULL pointer\n",
59 /* Fetch an single ID_BLOCK from the cache */
70 ldbm_datum_init( data );
72 /* Debug( LDAP_DEBUG_TRACE, "=> idl_fetch_one\n", 0, 0, 0 ); */
74 data = ldbm_cache_fetch( db, key );
76 idl = (ID_BLOCK *) data.dptr;
82 /* Fetch a set of ID_BLOCKs from the cache
84 * if block return is an ALLIDS block,
85 * return an new ALLIDS block
88 * construct super block from all blocks referenced by INDIRECT block
104 ldbm_datum_init( k2 );
105 ldbm_datum_init( data );
107 /* Debug( LDAP_DEBUG_TRACE, "=> idl_fetch\n", 0, 0, 0 ); */
109 data = ldbm_cache_fetch( db, key );
111 if ( (idl = (ID_BLOCK *) data.dptr) == NULL ) {
116 if ( ! ID_BLOCK_INDIRECT( idl ) ) {
118 Debug( LDAP_DEBUG_TRACE, "<= idl_fetch %d ids (%d max)\n",
119 ID_BLOCK_NIDS(idl), ID_BLOCK_NMAX(idl), 0 );
122 /* make sure we have the current value of highest id */
123 if ( ID_BLOCK_ALLIDS(idl) ) {
125 idl = idl_allids( be );
131 * this is an indirect block which points to other blocks.
132 * we need to read in all the blocks it points to and construct
133 * a big id list containing all the ids, which we will return.
136 /* count the number of blocks & allocate space for pointers to them */
137 for ( i = 0; !ID_BLOCK_NOID(idl, i); i++ )
139 tmp = (ID_BLOCK **) ch_malloc( (i + 1) * sizeof(ID_BLOCK *) );
141 /* read in all the blocks */
142 kstr = (char *) ch_malloc( key.dsize + 20 );
144 for ( i = 0; !ID_BLOCK_NOID(idl, i); i++ ) {
145 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, i) );
147 k2.dsize = strlen( kstr ) + 1;
149 if ( (tmp[i] = idl_fetch_one( be, db, k2 )) == NULL ) {
150 Debug( LDAP_DEBUG_ANY,
151 "idl_fetch of (%s) returns NULL\n", k2.dptr, 0, 0 );
155 nids += ID_BLOCK_NIDS(tmp[i]);
160 /* allocate space for the big block */
161 idl = idl_alloc( nids );
162 ID_BLOCK_NIDS(idl) = nids;
165 /* copy in all the ids from the component blocks */
166 for ( i = 0; tmp[i] != NULL; i++ ) {
167 if ( tmp[i] == NULL ) {
172 (char *) &ID_BLOCK_ID(idl, nids),
173 (char *) &ID_BLOCK_ID(tmp[i], 0),
174 ID_BLOCK_NIDS(tmp[i]) * sizeof(ID) );
175 nids += ID_BLOCK_NIDS(tmp[i]);
179 free( (char *) tmp );
181 Debug( LDAP_DEBUG_TRACE, "<= idl_fetch %lu ids (%lu max)\n",
182 ID_BLOCK_NIDS(idl), ID_BLOCK_NMAX(idl), 0 );
187 /* store a single block */
198 struct ldbminfo *li = (struct ldbminfo *) be->be_private;
200 ldbm_datum_init( data );
202 /* Debug( LDAP_DEBUG_TRACE, "=> idl_store\n", 0, 0, 0 ); */
204 data.dptr = (char *) idl;
205 data.dsize = (ID_BLOCK_IDS_OFFSET + ID_BLOCK_NMAX(idl)) * sizeof(ID);
208 Statslog( LDAP_DEBUG_STATS, "<= idl_store(): rc=%d\n",
212 flags = LDBM_REPLACE;
213 if( li->li_dbcachewsync ) flags |= LDBM_SYNC;
214 rc = ldbm_cache_store( db, key, data, flags );
216 /* Debug( LDAP_DEBUG_TRACE, "<= idl_store %d\n", rc, 0, 0 ); */
221 /* split the block at id
222 * locate ID greater than or equal to id.
234 /* find where to split the block *//* XXX linear search XXX */
235 for ( nr = 0; nr < ID_BLOCK_NIDS(b) && id > ID_BLOCK_ID(b, nr); nr++ )
238 nl = ID_BLOCK_NIDS(b) - nr;
240 *right = idl_alloc( nr == 0 ? 1 : nr );
241 *left = idl_alloc( nl + (nr == 0 ? 0 : 1));
244 * everything before the id being inserted in the first block
245 * unless there is nothing, in which case the id being inserted
249 ID_BLOCK_NIDS(*right) = 1;
250 ID_BLOCK_ID(*right, 0) = id;
253 (char *) &ID_BLOCK_ID(*right, 0),
254 (char *) &ID_BLOCK_ID(b, 0),
256 ID_BLOCK_NIDS(*right) = nr;
257 ID_BLOCK_ID(*left, 0) = id;
260 /* the id being inserted & everything after in the second block */
262 (char *) &ID_BLOCK_ID(*left, (nr == 0 ? 0 : 1)),
263 (char *) &ID_BLOCK_ID(b, nr),
265 ID_BLOCK_NIDS(*left) = nl + (nr == 0 ? 0 : 1);
270 * idl_change_first - called when an indirect block's first key has
271 * changed, meaning it needs to be stored under a new key, and the
272 * header block pointing to it needs updating.
278 Datum hkey, /* header block key */
279 ID_BLOCK *h, /* header block */
280 int pos, /* pos in h to update */
281 Datum bkey, /* data block key */
282 ID_BLOCK *b /* data block */
287 /* Debug( LDAP_DEBUG_TRACE, "=> idl_change_first\n", 0, 0, 0 ); */
289 /* delete old key block */
290 if ( (rc = ldbm_cache_delete( db, bkey )) != 0 ) {
291 Debug( LDAP_DEBUG_ANY,
292 "ldbm_delete of (%s) returns %d\n", bkey.dptr, rc,
297 /* write block with new key */
298 sprintf( bkey.dptr, "%c%s%ld", CONT_PREFIX, hkey.dptr, ID_BLOCK_ID(b, 0) );
299 bkey.dsize = strlen( bkey.dptr ) + 1;
300 if ( (rc = idl_store( be, db, bkey, b )) != 0 ) {
301 Debug( LDAP_DEBUG_ANY,
302 "idl_store of (%s) returns %d\n", bkey.dptr, rc, 0 );
306 /* update + write indirect header block */
307 ID_BLOCK_ID(h, pos) = ID_BLOCK_ID(b, 0);
308 if ( (rc = idl_store( be, db, hkey, h )) != 0 ) {
309 Debug( LDAP_DEBUG_ANY,
310 "idl_store of (%s) returns %d\n", hkey.dptr, rc, 0 );
327 ID_BLOCK *idl, *tmp, *tmp2, *tmp3;
331 ldbm_datum_init( k2 );
333 if ( (idl = idl_fetch_one( be, db, key )) == NULL ) {
335 Statslog( LDAP_DEBUG_STATS, "=> idl_insert_key(): no key yet\n",
339 idl = idl_alloc( 1 );
340 ID_BLOCK_ID(idl, ID_BLOCK_NIDS(idl)++) = id;
341 rc = idl_store( be, db, key, idl );
348 if ( ! ID_BLOCK_INDIRECT( idl ) ) {
349 switch ( idl_insert( &idl, id, db->dbc_maxids ) ) {
350 case 0: /* id inserted - store the updated block */
352 rc = idl_store( be, db, key, idl );
355 case 2: /* id already there - nothing to do */
359 case 3: /* id not inserted - block must be split */
360 /* check threshold for marking this an all-id block */
361 if ( db->dbc_maxindirect < 2 ) {
363 idl = idl_allids( be );
364 rc = idl_store( be, db, key, idl );
370 idl_split_block( idl, id, &tmp, &tmp2 );
373 /* create the header indirect block */
374 idl = idl_alloc( 3 );
375 ID_BLOCK_NMAX(idl) = 3;
376 ID_BLOCK_NIDS(idl) = ID_BLOCK_INDIRECT_VALUE;
377 ID_BLOCK_ID(idl, 0) = ID_BLOCK_ID(tmp, 0);
378 ID_BLOCK_ID(idl, 1) = ID_BLOCK_ID(tmp2, 0);
379 ID_BLOCK_ID(idl, 2) = NOID;
382 rc = idl_store( be, db, key, idl );
384 /* store the first id block */
385 kstr = (char *) ch_malloc( key.dsize + 20 );
386 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
387 ID_BLOCK_ID(tmp, 0) );
389 k2.dsize = strlen( kstr ) + 1;
390 rc = idl_store( be, db, k2, tmp );
392 /* store the second id block */
393 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
394 ID_BLOCK_ID(tmp2, 0) );
396 k2.dsize = strlen( kstr ) + 1;
397 rc = idl_store( be, db, k2, tmp2 );
410 * this is an indirect block which points to other blocks.
411 * we need to read in the block into which the id should be
412 * inserted, then insert the id and store the block. we might
413 * have to split the block if it is full, which means we also
414 * need to write a new "header" block.
417 /* select the block to try inserting into *//* XXX linear search XXX */
418 for ( i = 0; !ID_BLOCK_NOID(idl, i) && id > ID_BLOCK_ID(idl, i); i++ )
428 kstr = (char *) ch_malloc( key.dsize + 20 );
429 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, i) );
431 k2.dsize = strlen( kstr ) + 1;
432 if ( (tmp = idl_fetch_one( be, db, k2 )) == NULL ) {
433 Debug( LDAP_DEBUG_ANY, "nonexistent continuation block (%s)\n",
439 switch ( idl_insert( &tmp, id, db->dbc_maxids ) ) {
440 case 0: /* id inserted ok */
441 if ( (rc = idl_store( be, db, k2, tmp )) != 0 ) {
442 Debug( LDAP_DEBUG_ANY,
443 "idl_store of (%s) returns %d\n", k2.dptr, rc, 0 );
447 case 1: /* id inserted - first id in block has changed */
449 * key for this block has changed, so we have to
450 * write the block under the new key, delete the
451 * old key block + update and write the indirect
455 rc = idl_change_first( be, db, key, idl, i, k2, tmp );
458 case 2: /* id not inserted - already there */
461 case 3: /* id not inserted - block is full */
463 * first, see if it will fit in the next block,
464 * without splitting, unless we're trying to insert
465 * into the beginning of the first block.
468 /* is there a next block? */
469 if ( !first && !ID_BLOCK_NOID(idl, i + 1) ) {
471 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
472 ID_BLOCK_ID(idl, i + 1) );
474 k2.dsize = strlen( kstr ) + 1;
475 if ( (tmp2 = idl_fetch_one( be, db, k2 )) == NULL ) {
476 Debug( LDAP_DEBUG_ANY,
477 "idl_fetch_one (%s) returns NULL\n",
482 switch ( (rc = idl_insert( &tmp2, id,
483 db->dbc_maxids )) ) {
484 case 1: /* id inserted first in block */
485 rc = idl_change_first( be, db, key, idl,
489 case 2: /* id already there - how? */
490 case 0: /* id inserted */
492 Debug( LDAP_DEBUG_ANY,
493 "id %lu already in next block\n",
502 case 3: /* split the original block */
510 * must split the block, write both new blocks + update
511 * and write the indirect header block.
514 /* count how many indirect blocks *//* XXX linear count XXX */
515 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ )
518 /* check it against all-id thresholed */
519 if ( j + 1 > db->dbc_maxindirect ) {
521 * we've passed the all-id threshold, meaning
522 * that this set of blocks should be replaced
523 * by a single "all-id" block. our job: delete
524 * all the indirect blocks, and replace the header
525 * block by an all-id block.
528 /* delete all indirect blocks */
529 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ ) {
530 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
531 ID_BLOCK_ID(idl, j) );
533 k2.dsize = strlen( kstr ) + 1;
535 rc = ldbm_cache_delete( db, k2 );
538 /* store allid block in place of header block */
540 idl = idl_allids( be );
541 rc = idl_store( be, db, key, idl );
549 idl_split_block( tmp, id, &tmp2, &tmp3 );
552 /* create a new updated indirect header block */
553 tmp = idl_alloc( ID_BLOCK_NMAX(idl) + 1 );
554 ID_BLOCK_NIDS(tmp) = ID_BLOCK_INDIRECT_VALUE;
555 /* everything up to the split block */
557 (char *) &ID_BLOCK_ID(tmp, 0),
558 (char *) &ID_BLOCK_ID(idl, 0),
560 /* the two new blocks */
561 ID_BLOCK_ID(tmp, i) = ID_BLOCK_ID(tmp2, 0);
562 ID_BLOCK_ID(tmp, i + 1) = ID_BLOCK_ID(tmp3, 0);
563 /* everything after the split block */
565 (char *) &ID_BLOCK_ID(tmp, i + 2),
566 (char *) &ID_BLOCK_ID(idl, i + 1),
567 (ID_BLOCK_NMAX(idl) - i - 1) * sizeof(ID) );
569 /* store the header block */
570 rc = idl_store( be, db, key, tmp );
572 /* store the first id block */
573 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
574 ID_BLOCK_ID(tmp2, 0) );
576 k2.dsize = strlen( kstr ) + 1;
577 rc = idl_store( be, db, k2, tmp2 );
579 /* store the second id block */
580 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
581 ID_BLOCK_ID(tmp3, 0) );
583 k2.dsize = strlen( kstr ) + 1;
584 rc = idl_store( be, db, k2, tmp3 );
599 * idl_insert - insert an id into an id list.
603 * 1 id inserted, first id in block has changed
604 * 2 id not inserted, already there
605 * 3 id not inserted, block must be split
608 idl_insert( ID_BLOCK **idl, ID id, int maxids )
612 if ( ID_BLOCK_ALLIDS( *idl ) ) {
613 return( 2 ); /* already there */
616 /* is it already there? *//* XXX linear search XXX */
617 for ( i = 0; i < ID_BLOCK_NIDS(*idl) && id > ID_BLOCK_ID(*idl, i); i++ ) {
620 if ( i < ID_BLOCK_NIDS(*idl) && ID_BLOCK_ID(*idl, i) == id ) {
621 return( 2 ); /* already there */
624 /* do we need to make room for it? */
625 if ( ID_BLOCK_NIDS(*idl) == ID_BLOCK_NMAX(*idl) ) {
626 /* make room or indicate block needs splitting */
627 if ( ID_BLOCK_NMAX(*idl) >= maxids ) {
628 return( 3 ); /* block needs splitting */
631 ID_BLOCK_NMAX(*idl) *= 2;
632 if ( ID_BLOCK_NMAX(*idl) > maxids ) {
633 ID_BLOCK_NMAX(*idl) = maxids;
635 *idl = (ID_BLOCK *) ch_realloc( (char *) *idl,
636 (ID_BLOCK_NMAX(*idl) + ID_BLOCK_IDS_OFFSET) * sizeof(ID) );
639 /* make a slot for the new id *//* XXX bubble move XXX */
640 for ( j = ID_BLOCK_NIDS(*idl); j != i; j-- ) {
641 ID_BLOCK_ID(*idl, j) = ID_BLOCK_ID(*idl, j-1);
643 ID_BLOCK_ID(*idl, i) = id;
644 ID_BLOCK_NIDS(*idl)++;
646 (char *) &ID_BLOCK_ID((*idl), ID_BLOCK_NIDS(*idl)),
648 (ID_BLOCK_NMAX(*idl) - ID_BLOCK_NIDS(*idl)) * sizeof(ID) );
650 return( i == 0 ? 1 : 0 ); /* inserted - first id changed or not */
668 if ( (idl = idl_fetch_one( be, db, key ) ) == NULL )
670 /* It wasn't found. Hmm... */
674 if ( ! ID_BLOCK_INDIRECT( idl ) )
676 for ( i=0; i < ID_BLOCK_NIDS(idl); i++ )
678 if ( ID_BLOCK_ID(idl, i) == id )
681 &ID_BLOCK_ID(idl, i),
682 &ID_BLOCK_ID(idl, i+1),
683 (ID_BLOCK_NIDS(idl)-(i+1)) * sizeof(ID) );
685 ID_BLOCK_ID(idl, ID_BLOCK_NIDS(idl)-1) = NOID;
686 ID_BLOCK_NIDS(idl)--;
688 if ( ID_BLOCK_NIDS(idl) )
689 idl_store( be, db, key, idl );
691 ldbm_cache_delete( db, key );
694 /* We didn't find the ID. Hmmm... */
699 /* We have to go through an indirect block and find the ID
702 for ( nids = 0; !ID_BLOCK_NOID(idl, nids); nids++ )
704 kstr = (char *) ch_malloc( key.dsize + 20 );
706 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ )
708 ldbm_datum_init( k2 );
709 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, j) );
711 k2.dsize = strlen( kstr ) + 1;
713 if ( (tmp = idl_fetch_one( be, db, k2 )) == NULL ) {
714 Debug( LDAP_DEBUG_ANY,
715 "idl_fetch of (%s) returns NULL\n", k2.dptr, 0, 0 );
719 Now try to find the ID in tmp
721 for ( i=0; i < ID_BLOCK_NIDS(tmp); i++ )
723 if ( ID_BLOCK_ID(tmp, i) == id )
726 &ID_BLOCK_ID(tmp, i),
727 &ID_BLOCK_ID(tmp, i+1),
728 (ID_BLOCK_NIDS(tmp)-(i+1)) * sizeof(ID));
729 ID_BLOCK_ID(tmp, ID_BLOCK_NIDS(tmp)-1 ) = NOID;
730 ID_BLOCK_NIDS(tmp)--;
731 if ( ID_BLOCK_NIDS(tmp) )
732 idl_store ( be, db, k2, tmp );
735 ldbm_cache_delete( db, k2 );
737 &ID_BLOCK_ID(idl, j),
738 &ID_BLOCK_ID(idl, j+1),
739 (nids-(j+1)) * sizeof(ID));
740 ID_BLOCK_ID(idl, nids-1) = NOID;
743 ldbm_cache_delete( db, key );
745 idl_store( be, db, key, idl );
755 /* return a duplicate of a single ID_BLOCK */
757 idl_dup( ID_BLOCK *idl )
765 new = idl_alloc( ID_BLOCK_NMAX(idl) );
770 (ID_BLOCK_NMAX(idl) + ID_BLOCK_IDS_OFFSET) * sizeof(ID) );
776 /* return the smaller ID_BLOCK */
778 idl_min( ID_BLOCK *a, ID_BLOCK *b )
780 return( ID_BLOCK_NIDS(a) > ID_BLOCK_NIDS(b) ? b : a );
785 * idl_intersection - return a intersection b
794 unsigned int ai, bi, ni;
797 if ( a == NULL || b == NULL ) {
800 if ( ID_BLOCK_ALLIDS( a ) ) {
801 return( idl_dup( b ) );
803 if ( ID_BLOCK_ALLIDS( b ) ) {
804 return( idl_dup( a ) );
807 n = idl_dup( idl_min( a, b ) );
809 for ( ni = 0, ai = 0, bi = 0; ai < ID_BLOCK_NIDS(a); ai++ ) {
811 bi < ID_BLOCK_NIDS(b) && ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai);
817 if ( bi == ID_BLOCK_NIDS(b) ) {
821 if ( ID_BLOCK_ID(b, bi) == ID_BLOCK_ID(a, ai) ) {
822 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
830 ID_BLOCK_NIDS(n) = ni;
837 * idl_union - return a union b
846 unsigned int ai, bi, ni;
850 return( idl_dup( b ) );
853 return( idl_dup( a ) );
855 if ( ID_BLOCK_ALLIDS( a ) || ID_BLOCK_ALLIDS( b ) ) {
856 return( idl_allids( be ) );
859 if ( ID_BLOCK_NIDS(b) < ID_BLOCK_NIDS(a) ) {
865 n = idl_alloc( ID_BLOCK_NIDS(a) + ID_BLOCK_NIDS(b) );
867 for ( ni = 0, ai = 0, bi = 0;
868 ai < ID_BLOCK_NIDS(a) && bi < ID_BLOCK_NIDS(b);
871 if ( ID_BLOCK_ID(a, ai) < ID_BLOCK_ID(b, bi) ) {
872 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai++);
874 } else if ( ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai) ) {
875 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(b, bi++);
878 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
883 for ( ; ai < ID_BLOCK_NIDS(a); ai++ ) {
884 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
886 for ( ; bi < ID_BLOCK_NIDS(b); bi++ ) {
887 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(b, bi);
889 ID_BLOCK_NIDS(n) = ni;
896 * idl_notin - return a intersection ~b (or a minus b)
905 unsigned int ni, ai, bi;
911 if ( b == NULL || ID_BLOCK_ALLIDS( b )) {
912 return( idl_dup( a ) );
915 if ( ID_BLOCK_ALLIDS( a ) ) {
916 n = idl_alloc( SLAPD_LDBM_MIN_MAXIDS );
919 for ( ai = 1, bi = 0;
920 ai < ID_BLOCK_NIDS(a) && ni < ID_BLOCK_NMAX(n) && bi < ID_BLOCK_NMAX(b);
923 if ( ID_BLOCK_ID(b, bi) == ai ) {
926 ID_BLOCK_ID(n, ni++) = ai;
930 for ( ; ai < ID_BLOCK_NIDS(a) && ni < ID_BLOCK_NMAX(n); ai++ ) {
931 ID_BLOCK_ID(n, ni++) = ai;
934 if ( ni == ID_BLOCK_NMAX(n) ) {
936 return( idl_allids( be ) );
938 ID_BLOCK_NIDS(n) = ni;
946 for ( ai = 0, bi = 0; ai < ID_BLOCK_NIDS(a); ai++ ) {
948 bi < ID_BLOCK_NIDS(b) && ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai);
954 if ( bi == ID_BLOCK_NIDS(b) ) {
958 if ( ID_BLOCK_ID(b, bi) != ID_BLOCK_ID(a, ai) ) {
959 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
963 for ( ; ai < ID_BLOCK_NIDS(a); ai++ ) {
964 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
966 ID_BLOCK_NIDS(n) = ni;
971 /* return the first ID in the block
974 * otherwise return NOID
975 * otherwise return first ID
978 idl_firstid( ID_BLOCK *idl )
980 if ( idl == NULL || ID_BLOCK_NIDS(idl) == 0 ) {
984 if ( ID_BLOCK_ALLIDS( idl ) ) {
985 return( ID_BLOCK_NIDS(idl) > 1 ? 1 : NOID );
988 return( ID_BLOCK_ID(idl, 0) );
991 /* return next ID after id
992 * if ALLIDS block, increment id.
993 * if id < NIDS return id
995 * otherwise SEARCH for next id (ugh!)
998 idl_nextid( ID_BLOCK *idl, ID id )
1002 if ( ID_BLOCK_ALLIDS( idl ) ) {
1003 return( ++id < ID_BLOCK_NIDS(idl) ? id : NOID );
1006 for ( i = 0; i < ID_BLOCK_NIDS(idl) && ID_BLOCK_ID(idl, i) <= id; i++ ) {
1010 if ( i >= ID_BLOCK_NIDS(idl) ) {
1013 return( ID_BLOCK_ID(idl, i) );