1 /* idl.c - ldap id list handling routines */
10 #include "ldapconfig.h"
12 #include "back-ldbm.h"
19 /* nmax + nids + space for the ids */
20 new = (ID_BLOCK *) ch_calloc( (ID_BLOCK_IDS_OFFSET + nids), sizeof(ID) );
21 ID_BLOCK_NMAX(new) = nids;
22 ID_BLOCK_NIDS(new) = 0;
28 idl_allids( Backend *be )
33 ID_BLOCK_NMAX(idl) = ID_BLOCK_ALLIDS_VALUE;
34 ID_BLOCK_NIDS(idl) = next_id_get( be );
40 idl_free( ID_BLOCK *idl )
59 ldbm_datum_init( data );
61 /* Debug( LDAP_DEBUG_TRACE, "=> idl_fetch_one\n", 0, 0, 0 ); */
63 data = ldbm_cache_fetch( db, key );
65 idl = (ID_BLOCK *) data.dptr;
83 ldbm_datum_init( k2 );
84 ldbm_datum_init( data );
86 /* Debug( LDAP_DEBUG_TRACE, "=> idl_fetch\n", 0, 0, 0 ); */
88 data = ldbm_cache_fetch( db, key );
90 if ( (idl = (ID_BLOCK *) data.dptr) == NULL ) {
95 if ( ! ID_BLOCK_INDIRECT( idl ) ) {
97 Debug( LDAP_DEBUG_TRACE, "<= idl_fetch %d ids (%d max)\n",
98 ID_BLOCK_NIDS(idl), ID_BLOCK_NMAX(idl), 0 );
101 /* make sure we have the current value of highest id */
102 if ( ID_BLOCK_ALLIDS(idl) ) {
104 idl = idl_allids( be );
110 * this is an indirect block which points to other blocks.
111 * we need to read in all the blocks it points to and construct
112 * a big id list containing all the ids, which we will return.
115 /* count the number of blocks & allocate space for pointers to them */
116 for ( i = 0; !ID_BLOCK_NOID(idl, i); i++ )
118 tmp = (ID_BLOCK **) ch_malloc( (i + 1) * sizeof(ID_BLOCK *) );
120 /* read in all the blocks */
121 kstr = (char *) ch_malloc( key.dsize + 20 );
123 for ( i = 0; !ID_BLOCK_NOID(idl, i); i++ ) {
124 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, i) );
126 k2.dsize = strlen( kstr ) + 1;
128 if ( (tmp[i] = idl_fetch_one( be, db, k2 )) == NULL ) {
129 Debug( LDAP_DEBUG_ANY,
130 "idl_fetch of (%s) returns NULL\n", k2.dptr, 0, 0 );
134 nids += ID_BLOCK_NIDS(tmp[i]);
139 /* allocate space for the big block */
140 idl = idl_alloc( nids );
141 ID_BLOCK_NIDS(idl) = nids;
144 /* copy in all the ids from the component blocks */
145 for ( i = 0; tmp[i] != NULL; i++ ) {
146 if ( tmp[i] == NULL ) {
151 (char *) &ID_BLOCK_ID(idl, nids),
152 (char *) &ID_BLOCK_ID(tmp[i], 0),
153 ID_BLOCK_NIDS(tmp[i]) * sizeof(ID) );
154 nids += ID_BLOCK_NIDS(tmp[i]);
158 free( (char *) tmp );
160 Debug( LDAP_DEBUG_TRACE, "<= idl_fetch %lu ids (%lu max)\n",
161 ID_BLOCK_NIDS(idl), ID_BLOCK_NMAX(idl), 0 );
175 struct ldbminfo *li = (struct ldbminfo *) be->be_private;
177 ldbm_datum_init( data );
179 /* Debug( LDAP_DEBUG_TRACE, "=> idl_store\n", 0, 0, 0 ); */
181 data.dptr = (char *) idl;
182 data.dsize = (ID_BLOCK_IDS_OFFSET + ID_BLOCK_NMAX(idl)) * sizeof(ID);
185 Statslog( LDAP_DEBUG_STATS, "<= idl_store(): rc=%d\n",
189 flags = LDBM_REPLACE;
190 if( li->li_dbcachewsync ) flags |= LDBM_SYNC;
191 rc = ldbm_cache_store( db, key, data, flags );
193 /* Debug( LDAP_DEBUG_TRACE, "<= idl_store %d\n", rc, 0, 0 ); */
207 /* find where to split the block */
208 for ( i = 0; i < ID_BLOCK_NIDS(b) && id > ID_BLOCK_ID(b, i); i++ )
211 *n1 = idl_alloc( i == 0 ? 1 : i );
212 *n2 = idl_alloc( ID_BLOCK_NIDS(b) - i + (i == 0 ? 0 : 1));
215 * everything before the id being inserted in the first block
216 * unless there is nothing, in which case the id being inserted
220 (char *) &ID_BLOCK_ID(*n1, 0),
221 (char *) &ID_BLOCK_ID(b, 0),
223 ID_BLOCK_NIDS(*n1) = (i == 0 ? 1 : i);
226 ID_BLOCK_ID(*n1, 0) = id;
228 ID_BLOCK_ID(*n2, 0) = id;
231 /* the id being inserted & everything after in the second block */
233 (char *) &ID_BLOCK_ID(*n2, (i == 0 ? 0 : 1)),
234 (char *) &ID_BLOCK_ID(b, i),
235 (ID_BLOCK_NIDS(b) - i) * sizeof(ID) );
236 ID_BLOCK_NIDS(*n2) = ID_BLOCK_NIDS(b) - i + (i == 0 ? 0 : 1);
240 * idl_change_first - called when an indirect block's first key has
241 * changed, meaning it needs to be stored under a new key, and the
242 * header block pointing to it needs updating.
249 Datum hkey, /* header block key */
250 ID_BLOCK *h, /* header block */
251 int pos, /* pos in h to update */
252 Datum bkey, /* data block key */
253 ID_BLOCK *b /* data block */
258 /* Debug( LDAP_DEBUG_TRACE, "=> idl_change_first\n", 0, 0, 0 ); */
260 /* delete old key block */
261 if ( (rc = ldbm_cache_delete( db, bkey )) != 0 ) {
262 Debug( LDAP_DEBUG_ANY,
263 "ldbm_delete of (%s) returns %d\n", bkey.dptr, rc,
268 /* write block with new key */
269 sprintf( bkey.dptr, "%c%s%ld", CONT_PREFIX, hkey.dptr, ID_BLOCK_ID(b, 0) );
270 bkey.dsize = strlen( bkey.dptr ) + 1;
271 if ( (rc = idl_store( be, db, bkey, b )) != 0 ) {
272 Debug( LDAP_DEBUG_ANY,
273 "idl_store of (%s) returns %d\n", bkey.dptr, rc, 0 );
277 /* update + write indirect header block */
278 ID_BLOCK_ID(h, pos) = ID_BLOCK_ID(b, 0);
279 if ( (rc = idl_store( be, db, hkey, h )) != 0 ) {
280 Debug( LDAP_DEBUG_ANY,
281 "idl_store of (%s) returns %d\n", hkey.dptr, rc, 0 );
297 ID_BLOCK *idl, *tmp, *tmp2, *tmp3;
301 ldbm_datum_init( k2 );
303 if ( (idl = idl_fetch_one( be, db, key )) == NULL ) {
305 Statslog( LDAP_DEBUG_STATS, "=> idl_insert_key(): no key yet\n",
309 idl = idl_alloc( 1 );
310 ID_BLOCK_ID(idl, ID_BLOCK_NIDS(idl)++) = id;
311 rc = idl_store( be, db, key, idl );
318 if ( ! ID_BLOCK_INDIRECT( idl ) ) {
319 switch ( idl_insert( &idl, id, db->dbc_maxids ) ) {
320 case 0: /* id inserted - store the updated block */
322 rc = idl_store( be, db, key, idl );
325 case 2: /* id already there - nothing to do */
329 case 3: /* id not inserted - block must be split */
330 /* check threshold for marking this an all-id block */
331 if ( db->dbc_maxindirect < 2 ) {
333 idl = idl_allids( be );
334 rc = idl_store( be, db, key, idl );
340 idl_split_block( idl, id, &tmp, &tmp2 );
343 /* create the header indirect block */
344 idl = idl_alloc( 3 );
345 ID_BLOCK_NMAX(idl) = 3;
346 ID_BLOCK_NIDS(idl) = ID_BLOCK_INDIRECT_VALUE;
347 ID_BLOCK_ID(idl, 0) = ID_BLOCK_ID(tmp, 0);
348 ID_BLOCK_ID(idl, 1) = ID_BLOCK_ID(tmp2, 0);
349 ID_BLOCK_ID(idl, 2) = NOID;
352 rc = idl_store( be, db, key, idl );
354 /* store the first id block */
355 kstr = (char *) ch_malloc( key.dsize + 20 );
356 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
357 ID_BLOCK_ID(tmp, 0) );
359 k2.dsize = strlen( kstr ) + 1;
360 rc = idl_store( be, db, k2, tmp );
362 /* store the second id block */
363 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
364 ID_BLOCK_ID(tmp2, 0) );
366 k2.dsize = strlen( kstr ) + 1;
367 rc = idl_store( be, db, k2, tmp2 );
380 * this is an indirect block which points to other blocks.
381 * we need to read in the block into which the id should be
382 * inserted, then insert the id and store the block. we might
383 * have to split the block if it is full, which means we also
384 * need to write a new "header" block.
387 /* select the block to try inserting into */
388 for ( i = 0; !ID_BLOCK_NOID(idl, i) && id > ID_BLOCK_ID(idl, i); i++ )
398 kstr = (char *) ch_malloc( key.dsize + 20 );
399 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, i) );
401 k2.dsize = strlen( kstr ) + 1;
402 if ( (tmp = idl_fetch_one( be, db, k2 )) == NULL ) {
403 Debug( LDAP_DEBUG_ANY, "nonexistent continuation block (%s)\n",
409 switch ( idl_insert( &tmp, id, db->dbc_maxids ) ) {
410 case 0: /* id inserted ok */
411 if ( (rc = idl_store( be, db, k2, tmp )) != 0 ) {
412 Debug( LDAP_DEBUG_ANY,
413 "idl_store of (%s) returns %d\n", k2.dptr, rc, 0 );
417 case 1: /* id inserted - first id in block has changed */
419 * key for this block has changed, so we have to
420 * write the block under the new key, delete the
421 * old key block + update and write the indirect
425 rc = idl_change_first( be, db, key, idl, i, k2, tmp );
428 case 2: /* id not inserted - already there */
431 case 3: /* id not inserted - block is full */
433 * first, see if it will fit in the next block,
434 * without splitting, unless we're trying to insert
435 * into the beginning of the first block.
438 /* is there a next block? */
439 if ( !first && !ID_BLOCK_NOID(idl, i + 1) ) {
441 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
442 ID_BLOCK_ID(idl, i + 1) );
444 k2.dsize = strlen( kstr ) + 1;
445 if ( (tmp2 = idl_fetch_one( be, db, k2 )) == NULL ) {
446 Debug( LDAP_DEBUG_ANY,
447 "idl_fetch_one (%s) returns NULL\n",
452 switch ( (rc = idl_insert( &tmp2, id,
453 db->dbc_maxids )) ) {
454 case 1: /* id inserted first in block */
455 rc = idl_change_first( be, db, key, idl,
459 case 2: /* id already there - how? */
460 case 0: /* id inserted */
462 Debug( LDAP_DEBUG_ANY,
463 "id %lu already in next block\n",
472 case 3: /* split the original block */
480 * must split the block, write both new blocks + update
481 * and write the indirect header block.
484 /* count how many indirect blocks */
485 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ )
488 /* check it against all-id thresholed */
489 if ( j + 1 > db->dbc_maxindirect ) {
491 * we've passed the all-id threshold, meaning
492 * that this set of blocks should be replaced
493 * by a single "all-id" block. our job: delete
494 * all the indirect blocks, and replace the header
495 * block by an all-id block.
498 /* delete all indirect blocks */
499 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ ) {
500 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
501 ID_BLOCK_ID(idl, j) );
503 k2.dsize = strlen( kstr ) + 1;
505 rc = ldbm_cache_delete( db, k2 );
508 /* store allid block in place of header block */
510 idl = idl_allids( be );
511 rc = idl_store( be, db, key, idl );
519 idl_split_block( tmp, id, &tmp2, &tmp3 );
522 /* create a new updated indirect header block */
523 tmp = idl_alloc( ID_BLOCK_NMAX(idl) + 1 );
524 ID_BLOCK_NIDS(tmp) = ID_BLOCK_INDIRECT_VALUE;
525 /* everything up to the split block */
527 (char *) &ID_BLOCK_ID(tmp, 0),
528 (char *) &ID_BLOCK_ID(idl, 0),
530 /* the two new blocks */
531 ID_BLOCK_ID(tmp, i) = ID_BLOCK_ID(tmp2, 0);
532 ID_BLOCK_ID(tmp, i + 1) = ID_BLOCK_ID(tmp3, 0);
533 /* everything after the split block */
535 (char *) &ID_BLOCK_ID(tmp, i + 2),
536 (char *) &ID_BLOCK_ID(idl, i + 1),
537 (ID_BLOCK_NMAX(idl) - i - 1) * sizeof(ID) );
539 /* store the header block */
540 rc = idl_store( be, db, key, tmp );
542 /* store the first id block */
543 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
544 ID_BLOCK_ID(tmp2, 0) );
546 k2.dsize = strlen( kstr ) + 1;
547 rc = idl_store( be, db, k2, tmp2 );
549 /* store the second id block */
550 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr,
551 ID_BLOCK_ID(tmp3, 0) );
553 k2.dsize = strlen( kstr ) + 1;
554 rc = idl_store( be, db, k2, tmp3 );
568 * idl_insert - insert an id into an id list.
569 * returns 0 id inserted
570 * 1 id inserted, first id in block has changed
571 * 2 id not inserted, already there
572 * 3 id not inserted, block must be split
576 idl_insert( ID_BLOCK **idl, ID id, int maxids )
580 if ( ID_BLOCK_ALLIDS( *idl ) ) {
581 return( 2 ); /* already there */
584 /* is it already there? XXX bin search XXX */
585 for ( i = 0; i < ID_BLOCK_NIDS(*idl) && id > ID_BLOCK_ID(*idl, i); i++ ) {
588 if ( i < ID_BLOCK_NIDS(*idl) && ID_BLOCK_ID(*idl, i) == id ) {
589 return( 2 ); /* already there */
592 /* do we need to make room for it? */
593 if ( ID_BLOCK_NIDS(*idl) == ID_BLOCK_NMAX(*idl) ) {
594 /* make room or indicate block needs splitting */
595 if ( ID_BLOCK_NMAX(*idl) >= maxids ) {
596 return( 3 ); /* block needs splitting */
599 ID_BLOCK_NMAX(*idl) *= 2;
600 if ( ID_BLOCK_NMAX(*idl) > maxids ) {
601 ID_BLOCK_NMAX(*idl) = maxids;
603 *idl = (ID_BLOCK *) ch_realloc( (char *) *idl,
604 (ID_BLOCK_NMAX(*idl) + ID_BLOCK_IDS_OFFSET) * sizeof(ID) );
607 /* make a slot for the new id */
608 for ( j = ID_BLOCK_NIDS(*idl); j != i; j-- ) {
609 ID_BLOCK_ID(*idl, j) = ID_BLOCK_ID(*idl, j-1);
611 ID_BLOCK_ID(*idl, i) = id;
612 ID_BLOCK_NIDS(*idl)++;
614 (char *) &ID_BLOCK_ID((*idl), ID_BLOCK_NIDS(*idl)),
616 (ID_BLOCK_NMAX(*idl) - ID_BLOCK_NIDS(*idl)) * sizeof(ID) );
618 return( i == 0 ? 1 : 0 ); /* inserted - first id changed or not */
635 if ( (idl = idl_fetch_one( be, db, key ) ) == NULL )
637 /* It wasn't found. Hmm... */
641 if ( ! ID_BLOCK_INDIRECT( idl ) )
643 for ( i=0; i < ID_BLOCK_NIDS(idl); i++ )
645 if ( ID_BLOCK_ID(idl, i) == id )
648 &ID_BLOCK_ID(idl, i),
649 &ID_BLOCK_ID(idl, i+1),
650 (ID_BLOCK_NIDS(idl)-(i+1)) * sizeof(ID) );
652 ID_BLOCK_ID(idl, ID_BLOCK_NIDS(idl)-1) = NOID;
653 ID_BLOCK_NIDS(idl)--;
655 if ( ID_BLOCK_NIDS(idl) )
656 idl_store( be, db, key, idl );
658 ldbm_cache_delete( db, key );
661 /* We didn't find the ID. Hmmm... */
666 /* We have to go through an indirect block and find the ID
669 for ( nids = 0; !ID_BLOCK_NOID(idl, nids); nids++ )
671 kstr = (char *) ch_malloc( key.dsize + 20 );
673 for ( j = 0; !ID_BLOCK_NOID(idl, j); j++ )
675 ldbm_datum_init( k2 );
676 sprintf( kstr, "%c%s%ld", CONT_PREFIX, key.dptr, ID_BLOCK_ID(idl, j) );
678 k2.dsize = strlen( kstr ) + 1;
680 if ( (tmp = idl_fetch_one( be, db, k2 )) == NULL ) {
681 Debug( LDAP_DEBUG_ANY,
682 "idl_fetch of (%s) returns NULL\n", k2.dptr, 0, 0 );
686 Now try to find the ID in tmp
688 for ( i=0; i < ID_BLOCK_NIDS(tmp); i++ )
690 if ( ID_BLOCK_ID(tmp, i) == id )
693 &ID_BLOCK_ID(tmp, i),
694 &ID_BLOCK_ID(tmp, i+1),
695 (ID_BLOCK_NIDS(tmp)-(i+1)) * sizeof(ID));
696 ID_BLOCK_ID(tmp, ID_BLOCK_NIDS(tmp)-1 ) = NOID;
697 ID_BLOCK_NIDS(tmp)--;
698 if ( ID_BLOCK_NIDS(tmp) )
699 idl_store ( be, db, k2, tmp );
702 ldbm_cache_delete( db, k2 );
704 &ID_BLOCK_ID(idl, j),
705 &ID_BLOCK_ID(idl, j+1),
706 (nids-(j+1)) * sizeof(ID));
707 ID_BLOCK_ID(idl, nids-1) = NOID;
710 ldbm_cache_delete( db, key );
712 idl_store( be, db, key, idl );
722 idl_dup( ID_BLOCK *idl )
730 new = idl_alloc( ID_BLOCK_NMAX(idl) );
735 (ID_BLOCK_NMAX(idl) + ID_BLOCK_IDS_OFFSET) * sizeof(ID) );
741 idl_min( ID_BLOCK *a, ID_BLOCK *b )
743 return( ID_BLOCK_NIDS(a) > ID_BLOCK_NIDS(b) ? b : a );
747 * idl_intersection - return a intersection b
757 unsigned int ai, bi, ni;
760 if ( a == NULL || b == NULL ) {
763 if ( ID_BLOCK_ALLIDS( a ) ) {
764 return( idl_dup( b ) );
766 if ( ID_BLOCK_ALLIDS( b ) ) {
767 return( idl_dup( a ) );
770 n = idl_dup( idl_min( a, b ) );
772 for ( ni = 0, ai = 0, bi = 0; ai < ID_BLOCK_NIDS(a); ai++ ) {
773 for ( ; bi < ID_BLOCK_NIDS(b) && ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai); bi++ )
776 if ( bi == ID_BLOCK_NIDS(b) ) {
780 if ( ID_BLOCK_ID(b, bi) == ID_BLOCK_ID(a, ai) ) {
781 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
789 ID_BLOCK_NIDS(n) = ni;
795 * idl_union - return a union b
805 unsigned int ai, bi, ni;
809 return( idl_dup( b ) );
812 return( idl_dup( a ) );
814 if ( ID_BLOCK_ALLIDS( a ) || ID_BLOCK_ALLIDS( b ) ) {
815 return( idl_allids( be ) );
818 if ( ID_BLOCK_NIDS(b) < ID_BLOCK_NIDS(a) ) {
824 n = idl_alloc( ID_BLOCK_NIDS(a) + ID_BLOCK_NIDS(b) );
826 for ( ni = 0, ai = 0, bi = 0; ai < ID_BLOCK_NIDS(a) && bi < ID_BLOCK_NIDS(b); ) {
827 if ( ID_BLOCK_ID(a, ai) < ID_BLOCK_ID(b, bi) ) {
828 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai++);
830 } else if ( ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai) ) {
831 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(b, bi++);
834 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
839 for ( ; ai < ID_BLOCK_NIDS(a); ai++ ) {
840 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
842 for ( ; bi < ID_BLOCK_NIDS(b); bi++ ) {
843 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(b, bi);
845 ID_BLOCK_NIDS(n) = ni;
851 * idl_notin - return a intersection ~b (or a minus b)
861 unsigned int ni, ai, bi;
867 if ( b == NULL || ID_BLOCK_ALLIDS( b )) {
868 return( idl_dup( a ) );
871 if ( ID_BLOCK_ALLIDS( a ) ) {
872 n = idl_alloc( SLAPD_LDBM_MIN_MAXIDS );
875 for ( ai = 1, bi = 0;
876 ai < ID_BLOCK_NIDS(a) && ni < ID_BLOCK_NMAX(n) && bi < ID_BLOCK_NMAX(b);
879 if ( ID_BLOCK_ID(b, bi) == ai ) {
882 ID_BLOCK_ID(n, ni++) = ai;
886 for ( ; ai < ID_BLOCK_NIDS(a) && ni < ID_BLOCK_NMAX(n); ai++ ) {
887 ID_BLOCK_ID(n, ni++) = ai;
890 if ( ni == ID_BLOCK_NMAX(n) ) {
892 return( idl_allids( be ) );
894 ID_BLOCK_NIDS(n) = ni;
902 for ( ai = 0, bi = 0; ai < ID_BLOCK_NIDS(a); ai++ ) {
904 bi < ID_BLOCK_NIDS(b) && ID_BLOCK_ID(b, bi) < ID_BLOCK_ID(a, ai);
910 if ( bi == ID_BLOCK_NIDS(b) ) {
914 if ( ID_BLOCK_ID(b, bi) != ID_BLOCK_ID(a, ai) ) {
915 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
919 for ( ; ai < ID_BLOCK_NIDS(a); ai++ ) {
920 ID_BLOCK_ID(n, ni++) = ID_BLOCK_ID(a, ai);
922 ID_BLOCK_NIDS(n) = ni;
928 idl_firstid( ID_BLOCK *idl )
930 if ( idl == NULL || ID_BLOCK_NIDS(idl) == 0 ) {
934 if ( ID_BLOCK_ALLIDS( idl ) ) {
935 return( ID_BLOCK_NIDS(idl) == 1 ? NOID : 1 );
938 return( ID_BLOCK_ID(idl, 0) );
942 idl_nextid( ID_BLOCK *idl, ID id )
946 if ( ID_BLOCK_ALLIDS( idl ) ) {
947 return( ++id < ID_BLOCK_NIDS(idl) ? id : NOID );
950 for ( i = 0; i < ID_BLOCK_NIDS(idl) && ID_BLOCK_ID(idl, i) < id; i++ ) {
955 if ( i >= ID_BLOCK_NIDS(idl) ) {
958 return( ID_BLOCK_ID(idl, i) );