/*---------------------------------------------------------------------------
    ipr_bucket_list.c - ipr_bucket_list component

    Defines a bucket list.  You can use bucket lists to manage large
    amounts of data in memory without needing to pre-allocate the
    entire amount.
    Generated from ipr_bucket_list.icl by icl_gen using GSL/4.
    
    Copyright (c) 1996-2009 iMatix Corporation
    All rights reserved.
    
    This file is licensed under the BSD license as follows:
    
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions
    are met:
    
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in
      the documentation and/or other materials provided with the
      distribution.
    * Neither the name of iMatix Corporation nor the names of its
      contributors may be used to endorse or promote products derived
      from this software without specific prior written permission.
    
    THIS SOFTWARE IS PROVIDED BY IMATIX CORPORATION "AS IS" AND ANY
    EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL IMATIX CORPORATION BE
    LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
    BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
    LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
    SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *---------------------------------------------------------------------------*/

#include "icl.h"                        //  iCL base classes
#include "ipr_bucket_list.h"            //  Definitions for our class

//  Shorthand for class type                                                   

#define self_t              ipr_bucket_list_t

//  Shorthands for class methods                                               

#define self_clear          ipr_bucket_list_clear
#define self_load           ipr_bucket_list_load
#define self_save           ipr_bucket_list_save
#define self_selftest       ipr_bucket_list_selftest
#define self_iter_new       ipr_bucket_list_iter_new
#define self_iter_object    ipr_bucket_list_iter_object
#define self_iter_destroy   ipr_bucket_list_iter_destroy
#define self_new            ipr_bucket_list_new
#define self_annihilate     ipr_bucket_list_annihilate
#define self_isempty        ipr_bucket_list_isempty
#define self_push           ipr_bucket_list_push
#define self_pop            ipr_bucket_list_pop
#define self_queue          ipr_bucket_list_queue
#define self_relink_before  ipr_bucket_list_relink_before
#define self_remove         ipr_bucket_list_remove
#define self_first          ipr_bucket_list_first
#define self_last           ipr_bucket_list_last
#define self_next           ipr_bucket_list_next
#define self_prev           ipr_bucket_list_prev
#define self_rehook         ipr_bucket_list_rehook
#define self_unhook         ipr_bucket_list_unhook
#define self_cache_initialise  ipr_bucket_list_cache_initialise
#define self_cache_purge    ipr_bucket_list_cache_purge
#define self_terminate      ipr_bucket_list_terminate
#define self_show           ipr_bucket_list_show
#define self_destroy        ipr_bucket_list_destroy
#define self_alloc          ipr_bucket_list_alloc
#define self_free           ipr_bucket_list_free
#define self_cache_terminate  ipr_bucket_list_cache_terminate
#define self_show_animation  ipr_bucket_list_show_animation
#define self_new_in_scope   ipr_bucket_list_new_in_scope

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CLEAR))
static icl_stats_t *s_ipr_bucket_list_clear_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_LOAD))
static icl_stats_t *s_ipr_bucket_list_load_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SAVE))
static icl_stats_t *s_ipr_bucket_list_save_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SELFTEST))
static icl_stats_t *s_ipr_bucket_list_selftest_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_NEW))
static icl_stats_t *s_ipr_bucket_list_iter_new_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_OBJECT))
static icl_stats_t *s_ipr_bucket_list_iter_object_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_DESTROY))
static icl_stats_t *s_ipr_bucket_list_iter_destroy_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEW))
static icl_stats_t *s_ipr_bucket_list_new_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_DESTROY))
static icl_stats_t *s_ipr_bucket_list_annihilate_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ISEMPTY))
static icl_stats_t *s_ipr_bucket_list_isempty_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_PUSH))
static icl_stats_t *s_ipr_bucket_list_push_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_POP))
static icl_stats_t *s_ipr_bucket_list_pop_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_QUEUE))
static icl_stats_t *s_ipr_bucket_list_queue_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_RELINK_BEFORE))
static icl_stats_t *s_ipr_bucket_list_relink_before_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_REMOVE))
static icl_stats_t *s_ipr_bucket_list_remove_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_FIRST))
static icl_stats_t *s_ipr_bucket_list_first_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_LAST))
static icl_stats_t *s_ipr_bucket_list_last_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEXT))
static icl_stats_t *s_ipr_bucket_list_next_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_PREV))
static icl_stats_t *s_ipr_bucket_list_prev_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_REHOOK))
static icl_stats_t *s_ipr_bucket_list_rehook_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_UNHOOK))
static icl_stats_t *s_ipr_bucket_list_unhook_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_INITIALISE))
static icl_stats_t *s_ipr_bucket_list_cache_initialise_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_PURGE))
static icl_stats_t *s_ipr_bucket_list_cache_purge_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_TERMINATE))
static icl_stats_t *s_ipr_bucket_list_terminate_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SHOW))
static icl_stats_t *s_ipr_bucket_list_show_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_DESTROY_PUBLIC))
static icl_stats_t *s_ipr_bucket_list_destroy_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ALLOC))
static icl_stats_t *s_ipr_bucket_list_alloc_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_FREE))
static icl_stats_t *s_ipr_bucket_list_free_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_TERMINATE))
static icl_stats_t *s_ipr_bucket_list_cache_terminate_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SHOW_ANIMATION))
static icl_stats_t *s_ipr_bucket_list_show_animation_stats = NULL;
#endif
#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEW_IN_SCOPE))
static icl_stats_t *s_ipr_bucket_list_new_in_scope_stats = NULL;
#endif
static void
    ipr_bucket_list_annihilate (
ipr_bucket_list_t * ( * self_p )        //  Reference to object reference
);

static inline void
    ipr_bucket_list_rehook (
ipr_bucket_list_iter_t * item,          //  Not documented
ipr_bucket_list_iter_t * left,          //  Not documented
ipr_bucket_list_iter_t * right          //  Not documented
);

static inline ipr_bucket_list_iter_t *
    ipr_bucket_list_unhook (
ipr_bucket_list_iter_t * item           //  Not documented
);

static void
    ipr_bucket_list_cache_initialise (
void);

static void
    ipr_bucket_list_cache_purge (
void);

#define ipr_bucket_list_alloc()         ipr_bucket_list_alloc_ (__FILE__, __LINE__)
static ipr_bucket_list_t *
    ipr_bucket_list_alloc_ (
char * file,                            //  Source file for call
size_t line                             //  Line number for call
);

static void
    ipr_bucket_list_free (
ipr_bucket_list_t * self                //  Object reference
);

static void
    ipr_bucket_list_cache_terminate (
void);

Bool
    ipr_bucket_list_animating = TRUE;   //  Animation enabled by default
static icl_cache_t
    *s_cache = NULL;


static icl_cache_t
    *s_iter_cache = NULL;
/*  -------------------------------------------------------------------------
    ipr_bucket_list_clear

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Removes all the buckets from the list.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_clear (
    ipr_bucket_list_t * self            //  Reference to object
)
{
ipr_bucket_list_iter_t
    *item;
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_CLEAR))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_clear_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CLEAR))
    icl_trace_record (NULL, ipr_bucket_list_dump, 1);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CLEAR))
    icl_stats_inc ("ipr_bucket_list_clear", &s_ipr_bucket_list_clear_stats);
#endif

IPR_BUCKET_LIST_ASSERT_SANE (self);

//
item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next;
while (item != &self->ipr_bucket_list_iter) {
    ipr_bucket_list_unhook (item);
    ipr_bucket_list_iter_destroy (&item);
    item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next;
}
self->max_size = 0;
self->cur_size = 0;

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CLEAR))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 1);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_CLEAR))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_clear_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_load

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Reads an entire file into the bucket list.  Extends the list if it
    is not empty.  If you want to empty the bucket list first, use the
    ipr_bucket_list_clear method.  The file is read as binary data on
    systems that make such distinctions.  Returns an error if the file
    cannot be found.  If the chunking argument is zero, uses a suitable
    default.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_load (
    ipr_bucket_list_t * self,           //  Reference to object
    char * filename,                    //  File to read
    size_t chunking                     //  Size of buckets
)
{
FILE
    *file_stream;                   //  Handle to opened file
ipr_bucket_t
    *bucket;                        //  Allocated bucket
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_LOAD))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_load_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" filename=\"%s\""
" chunking=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, filename, chunking);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LOAD))
    icl_trace_record (NULL, ipr_bucket_list_dump, 2);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_LOAD))
    icl_stats_inc ("ipr_bucket_list_load", &s_ipr_bucket_list_load_stats);
#endif

IPR_BUCKET_LIST_ASSERT_SANE (self);

//
assert (filename);
if (chunking == 0)
    chunking = IRP_BUCKET_DEFAULT_CHUNK;

file_stream = fopen (filename, "rb");
if (file_stream) {
    bucket = ipr_bucket_new (chunking);
    ipr_bucket_load (bucket, file_stream);
    while (bucket->cur_size) {
        self->max_size += bucket->max_size;
        self->cur_size += bucket->cur_size;
        ipr_bucket_list_queue (self, bucket);
        ipr_bucket_unlink (&bucket);
        bucket = ipr_bucket_new (chunking);
        ipr_bucket_load (bucket, file_stream);
    }
    ipr_bucket_unlink (&bucket);
    fclose (file_stream);
}
else
    rc = -1;                        //  Failed, cannot read file

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LOAD))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 2);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_LOAD))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_load_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" filename=\"%s\""
" chunking=\"%u\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, filename, chunking, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_save

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Writes a bucket list to a specified file.  The file is written as
    binary data on systems that make such distinctions.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_save (
    ipr_bucket_list_t * self,           //  Reference to object
    char * filename                     //  File to create
)
{
FILE
    *file_stream;                   //  Handle to opened file
ipr_bucket_list_iter_t
    *iterator;
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_SAVE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_save_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" filename=\"%s\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, filename);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SAVE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 3);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SAVE))
    icl_stats_inc ("ipr_bucket_list_save", &s_ipr_bucket_list_save_stats);
#endif

IPR_BUCKET_LIST_ASSERT_SANE (self);

//
assert (filename);
file_stream = fopen (filename, "wb");
if (file_stream) {
    iterator = ipr_bucket_list_first (self);
    while (iterator) {
        ipr_bucket_save (iterator->item, file_stream);
        iterator = ipr_bucket_list_next (&iterator);
    }
    fclose (file_stream);
}
else
    rc = -1;                        //  Failed, cannot write file

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SAVE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 3);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_SAVE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_save_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" filename=\"%s\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, filename, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_selftest

    Type: Component method
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_selftest (
void)
{
ipr_bucket_list_t
    *bucket_list_1,
    *bucket_list_2;

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_SELFTEST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_selftest_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SELFTEST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 4);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SELFTEST))
    icl_stats_inc ("ipr_bucket_list_selftest", &s_ipr_bucket_list_selftest_stats);
#endif

//
bucket_list_1 = ipr_bucket_list_new ();
bucket_list_2 = ipr_bucket_list_new ();

ipr_bucket_list_load (bucket_list_1, "ipr_bucket_list.c", 1111);
ipr_bucket_list_save (bucket_list_1, "ipr_bucket_list.tmp");

ipr_bucket_list_load (bucket_list_2, "ipr_bucket_list.tmp", 3333);
assert (bucket_list_1->cur_size == bucket_list_2->cur_size);

ipr_file_delete ("ipr_bucket_list.tmp");
ipr_bucket_list_destroy (&bucket_list_1);
ipr_bucket_list_destroy (&bucket_list_2);
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SELFTEST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 4);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_SELFTEST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_selftest_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_iter_new

    Type: Component method
    -------------------------------------------------------------------------
 */

ipr_bucket_list_iter_t *
    ipr_bucket_list_iter_new (
    ipr_bucket_t * item                 //  Not documented
)
{
    ipr_bucket_list_iter_t *
        iter;                           //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_NEW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_new_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_NEW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 5);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_NEW))
    icl_stats_inc ("ipr_bucket_list_iter_new", &s_ipr_bucket_list_iter_new_stats);
#endif

iter = icl_mem_cache_alloc (s_iter_cache);
iter->next = iter;
iter->prev = iter;
iter->head = NULL;
iter->item = ipr_bucket_link (item);

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_NEW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 5);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_NEW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_new_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" iter=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, iter);
#endif


    return (iter);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_iter_object

    Type: Component method
    -------------------------------------------------------------------------
 */

ipr_bucket_t *
    ipr_bucket_list_iter_object (
    ipr_bucket_list_iter_t * iter       //  Not documented
)
{
    ipr_bucket_t *
        item;                           //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_OBJECT))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_object_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" iter=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, iter);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_OBJECT))
    icl_trace_record (NULL, ipr_bucket_list_dump, 6);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_OBJECT))
    icl_stats_inc ("ipr_bucket_list_iter_object", &s_ipr_bucket_list_iter_object_stats);
#endif

item = ipr_bucket_link (iter->item);

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_OBJECT))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 6);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_OBJECT))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_object_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" iter=\"%pp\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, iter, item);
#endif


    return (item);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_iter_destroy

    Type: Component method
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_iter_destroy (
    ipr_bucket_list_iter_t * ( * iter_p )  //  Not documented
)
{
    ipr_bucket_list_iter_t *
        iter = *iter_p;                 //  Dereferenced iter

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_DESTROY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_destroy_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" iter=\"%pp\""
" iter=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, iter, iter);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_DESTROY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 7);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ITER_DESTROY))
    icl_stats_inc ("ipr_bucket_list_iter_destroy", &s_ipr_bucket_list_iter_destroy_stats);
#endif

if (iter) {
    ipr_bucket_list_remove (iter);
    ipr_bucket_unlink (&iter->item);
    icl_mem_free (iter);
    *iter_p = NULL;
}
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_DESTROY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 7);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_ITER_DESTROY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_iter_destroy_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" iter=\"%pp\""
" iter=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, iter, iter);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_new

    Type: Component method
    Creates and initialises a new ipr_bucket_list_t object, returns a
    reference to the created object.
    -------------------------------------------------------------------------
 */

ipr_bucket_list_t *
    ipr_bucket_list_new_ (
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{
    ipr_bucket_list_t *
        self = NULL;                    //  Object reference

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_new_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 8);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEW))
    icl_stats_inc ("ipr_bucket_list_new", &s_ipr_bucket_list_new_stats);
#endif

    self = ipr_bucket_list_alloc_ (file, line);
    if (self) {
        self->object_tag   = IPR_BUCKET_LIST_ALIVE;
#if defined (DEBUG)
        icl_mem_set_callback (self, ipr_bucket_list_show_);
#endif

self->ipr_bucket_list_iter.next = &self->ipr_bucket_list_iter;
self->ipr_bucket_list_iter.prev = &self->ipr_bucket_list_iter;
self->ipr_bucket_list_iter.head = self;
self->ipr_bucket_list_iter.item = NULL;

}
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 8);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_new_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" file=\"%s\""
" line=\"%u\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, file, line, self);
#endif


    return (self);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_annihilate

    Type: Component method
    Destroys the list and unlinks all attached items.
    -------------------------------------------------------------------------
 */

static void
    ipr_bucket_list_annihilate (
    ipr_bucket_list_t * ( * self_p )    //  Reference to object reference
)
{

ipr_bucket_list_iter_t
    *item;
    ipr_bucket_list_t *
        self = *self_p;                 //  Dereferenced Reference to object reference

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_DESTROY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_destroy_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, self);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 9);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_DESTROY))
    icl_stats_inc ("ipr_bucket_list_annihilate", &s_ipr_bucket_list_annihilate_stats);
#endif

IPR_BUCKET_LIST_ASSERT_SANE (self);

item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next;
while (item != &self->ipr_bucket_list_iter) {
    //  Unlink child without lock (we already have the lock)
    ipr_bucket_list_unhook (item);

    ipr_bucket_list_iter_destroy (&item);
    item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next;
}

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 9);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_DESTROY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_destroy_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, self);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_isempty

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Returns true if the list is empty, else returns false.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_isempty (
    ipr_bucket_list_t * self            //  Reference to object
)
{
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_ISEMPTY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_isempty_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ISEMPTY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 10);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ISEMPTY))
    icl_stats_inc ("ipr_bucket_list_isempty", &s_ipr_bucket_list_isempty_stats);
#endif

IPR_BUCKET_LIST_ASSERT_SANE (self);

rc = (self->ipr_bucket_list_iter.next == &self->ipr_bucket_list_iter);

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ISEMPTY))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 10);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_ISEMPTY))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_isempty_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_push

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Attaches the item to the start of the specified list. If the item
    was on another list, it is first detached.  After this method,
    list->next points to the item.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_push (
    ipr_bucket_list_t * self,           //  Reference to object
    ipr_bucket_t * item                 //  Not documented
)
{


ipr_bucket_list_iter_t
    *iter;
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_PUSH))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_push_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PUSH))
    icl_trace_record (NULL, ipr_bucket_list_dump, 11);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_PUSH))
    icl_stats_inc ("ipr_bucket_list_push", &s_ipr_bucket_list_push_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

iter = ipr_bucket_list_iter_new (item);
ipr_bucket_list_rehook (iter, &self->ipr_bucket_list_iter, (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next);



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PUSH))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 11);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_PUSH))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_push_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" item=\"%pp\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, item, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_pop

    Type: Component method
    Removes the next item in the list, if any, and returns it.  If
    the list was empty, returns NULL.

    The number of links is unchanged; removing from the list and returning
    the value cancel each other out.
    -------------------------------------------------------------------------
 */

ipr_bucket_t *
    ipr_bucket_list_pop (
    ipr_bucket_list_t * self            //  The list
)
{


ipr_bucket_list_iter_t
    *iter = NULL;
    ipr_bucket_t *
        item = NULL;                    //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_POP))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_pop_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_POP))
    icl_trace_record (NULL, ipr_bucket_list_dump, 12);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_POP))
    icl_stats_inc ("ipr_bucket_list_pop", &s_ipr_bucket_list_pop_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

if (self->ipr_bucket_list_iter.next != &self->ipr_bucket_list_iter) {
    iter = ipr_bucket_list_unhook ((ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next);
    item = iter->item;
    iter->item = NULL;          //  So don't destroy item
    ipr_bucket_list_iter_destroy (&iter);
}



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_POP))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 12);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_POP))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_pop_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, item);
#endif


    return (item);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_queue

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Attaches the item to the end of the specified list. If the item
    was on another list, it is first detached.

    The number of links is automatically adjusted - if the item was previously
    in a list, it remains unchanged; otherwise it is incremented.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_queue (
    ipr_bucket_list_t * self,           //  Reference to object
    ipr_bucket_t * item                 //  Not documented
)
{


ipr_bucket_list_iter_t
    *iter;
    int
        rc = 0;                         //  Return code

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_QUEUE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_queue_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_QUEUE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 13);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_QUEUE))
    icl_stats_inc ("ipr_bucket_list_queue", &s_ipr_bucket_list_queue_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

iter = ipr_bucket_list_iter_new (item);
ipr_bucket_list_rehook (iter, (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.prev, &self->ipr_bucket_list_iter);



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_QUEUE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 13);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_QUEUE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_queue_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" item=\"%pp\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, item, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_relink_before

    Type: Component method
    Accepts a ipr_bucket_list_t reference and returns zero in case of success,
    1 in case of errors.
    Attaches the item before a specified item. If the item was on another list,
    it is first detached.

    The number of links is automatically adjusted - if the item was previously
    in a list, it remains unchanged; otherwise it is incremented.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_relink_before (
    ipr_bucket_list_iter_t * item,      //  Not documented
    ipr_bucket_list_iter_t * where      //  Not documented
)
{


    int
        rc = 0;                         //  Return code
    ipr_bucket_list_t *
        self = (ipr_bucket_list_t *) where->head;  //  The list

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_RELINK_BEFORE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_relink_before_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" where=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, where);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_RELINK_BEFORE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 14);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_RELINK_BEFORE))
    icl_stats_inc ("ipr_bucket_list_relink_before", &s_ipr_bucket_list_relink_before_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

//  If head is non-null then we are moving within the
//  list to another so don't need to adjust links. Otherwise it
//  is illegitimate to move from one list to another in one step,
//  because we don't have a lock on the other list.
if (! item->head) {
}
else
if (item->head != self) {
    icl_console_print ("E: ipr_bucket_list_iter item inserted into multiple list containers");
    assert (item->head == self);
}
ipr_bucket_list_unhook (item);
ipr_bucket_list_rehook (item, (ipr_bucket_list_iter_t *) where->prev, where);



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_RELINK_BEFORE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 14);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_RELINK_BEFORE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_relink_before_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" where=\"%pp\""
" rc=\"%i\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, where, rc, self);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_remove

    Type: Component method
    Removes the ipr_bucket_list_iter item from any list it is in.

    If it was in a list, the number of links is decremented.
    -------------------------------------------------------------------------
 */

int
    ipr_bucket_list_remove (
    ipr_bucket_list_iter_t * item       //  Not documented
)
{


    ipr_bucket_list_t *
        self = (ipr_bucket_list_t *) item->head;  //  The list
    int
        rc = 0;                         //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_REMOVE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_remove_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REMOVE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 15);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_REMOVE))
    icl_stats_inc ("ipr_bucket_list_remove", &s_ipr_bucket_list_remove_stats);
#endif



if (self
&&  self == item->head) { //  Catch case where item moved
    ipr_bucket_list_unhook (item);
}


#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REMOVE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 15);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_REMOVE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_remove_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" self=\"%pp\""
" rc=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, self, rc);
#endif


    return (rc);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_first

    Type: Component method
    Returns the first ipr_bucket_list_iter item on the list.  If the list is empty,
    returns null.
    -------------------------------------------------------------------------
 */

ipr_bucket_list_iter_t *
    ipr_bucket_list_first_ (
    ipr_bucket_list_t * self,           //  The list
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{


    ipr_bucket_list_iter_t *
        item = NULL;                    //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_FIRST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_first_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FIRST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 16);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_FIRST))
    icl_stats_inc ("ipr_bucket_list_first", &s_ipr_bucket_list_first_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.next;
if (item == &self->ipr_bucket_list_iter)
    item = NULL;



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FIRST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 16);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_FIRST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_first_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, file, line, item);
#endif


    return (item);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_last

    Type: Component method
    Returns the last ipr_bucket_list_iter item on the list.  If the list is empty,
    returns null.
    -------------------------------------------------------------------------
 */

ipr_bucket_list_iter_t *
    ipr_bucket_list_last_ (
    ipr_bucket_list_t * self,           //  The list
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{


    ipr_bucket_list_iter_t *
        item = NULL;                    //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_LAST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_last_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LAST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 17);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_LAST))
    icl_stats_inc ("ipr_bucket_list_last", &s_ipr_bucket_list_last_stats);
#endif



IPR_BUCKET_LIST_ASSERT_SANE (self);

item = (ipr_bucket_list_iter_t *) self->ipr_bucket_list_iter.prev;
if (item == &self->ipr_bucket_list_iter)
    item = NULL;



#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LAST))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 17);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_LAST))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_last_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, file, line, item);
#endif


    return (item);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_next

    Type: Component method
    Returns the following item on the ipr_bucket_list_iter list. If the provided item
    is null, returns the first item.  If there were no (more) items, returns
    null.
    -------------------------------------------------------------------------
 */

ipr_bucket_list_iter_t *
    ipr_bucket_list_next_ (
    ipr_bucket_list_iter_t * ( * item_p ),   //  Not documented
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{


    ipr_bucket_list_iter_t *
        item = *item_p;                 //  Dereferenced item
    ipr_bucket_list_iter_t *
        next = NULL;                    //  The item to return
    ipr_bucket_list_t *
        self = (ipr_bucket_list_t *) item->head;  //  The list

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEXT))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_next_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, file, line, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEXT))
    icl_trace_record (NULL, ipr_bucket_list_dump, 18);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEXT))
    icl_stats_inc ("ipr_bucket_list_next", &s_ipr_bucket_list_next_stats);
#endif



if (self
&&  self == item->head) { //  Catch case where item moved
    next = (ipr_bucket_list_iter_t *) item->next;
    if (next == &self->ipr_bucket_list_iter)
        next = NULL;
}


#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEXT))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 18);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEXT))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_next_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
" next=\"%pp\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, file, line, item, next, self);
#endif


    return (next);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_prev

    Type: Component method
    Returns the preceding item on the ipr_bucket_list_iter list. If the provided item
    is null, returns the last item.  If there were no (more) items, returns
    null.
    -------------------------------------------------------------------------
 */

ipr_bucket_list_iter_t *
    ipr_bucket_list_prev_ (
    ipr_bucket_list_iter_t * ( * item_p ),   //  Not documented
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{


    ipr_bucket_list_iter_t *
        item = *item_p;                 //  Dereferenced item
    ipr_bucket_list_iter_t *
        prev = NULL;                    //  The item to return
    ipr_bucket_list_t *
        self = (ipr_bucket_list_t *) item->head;  //  The list

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_PREV))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_prev_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, file, line, item);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PREV))
    icl_trace_record (NULL, ipr_bucket_list_dump, 19);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_PREV))
    icl_stats_inc ("ipr_bucket_list_prev", &s_ipr_bucket_list_prev_stats);
#endif



if (self
&&  self == item->head) { //  Catch case where item moved
    prev = (ipr_bucket_list_iter_t *) item->prev;
    if (prev == &self->ipr_bucket_list_iter)
        prev = NULL;
}


#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PREV))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 19);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_PREV))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_prev_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" item=\"%pp\""
" prev=\"%pp\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, file, line, item, prev, self);
#endif


    return (prev);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_rehook

    Type: Component method
    -------------------------------------------------------------------------
 */

static inline void
    ipr_bucket_list_rehook (
    ipr_bucket_list_iter_t * item,      //  Not documented
    ipr_bucket_list_iter_t * left,      //  Not documented
    ipr_bucket_list_iter_t * right      //  Not documented
)
{
ipr_bucket_list_iter_t
    *swap;

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_REHOOK))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_rehook_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" left=\"%pp\""
" right=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, left, right);
#endif

#if (defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REHOOK))
    icl_trace_record (NULL, ipr_bucket_list_dump, 20);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_REHOOK))
    icl_stats_inc ("ipr_bucket_list_rehook", &s_ipr_bucket_list_rehook_stats);
#endif

swap = (ipr_bucket_list_iter_t *) left->next;
left->next = item->next;
item->next = swap;

swap = (ipr_bucket_list_iter_t *) item->prev;
item->prev = right->prev;
right->prev = swap;

item->head = left->head;
#if (defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REHOOK))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 20);
#endif

#if (defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_REHOOK))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_rehook_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" left=\"%pp\""
" right=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, left, right);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_unhook

    Type: Component method
    -------------------------------------------------------------------------
 */

static inline ipr_bucket_list_iter_t *
    ipr_bucket_list_unhook (
    ipr_bucket_list_iter_t * item       //  Not documented
)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_UNHOOK))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_unhook_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item);
#endif

#if (defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_UNHOOK))
    icl_trace_record (NULL, ipr_bucket_list_dump, 21);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_UNHOOK))
    icl_stats_inc ("ipr_bucket_list_unhook", &s_ipr_bucket_list_unhook_stats);
#endif

ipr_bucket_list_rehook (item, (ipr_bucket_list_iter_t *) item->prev, (ipr_bucket_list_iter_t *) item->next);
item->head = NULL;
#if (defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_UNHOOK))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 21);
#endif

#if (defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_UNHOOK))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_unhook_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item);
#endif


    return (item);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_cache_initialise

    Type: Component method
    Initialise the cache and register purge method with the meta-cache.
    Initialise the cache and register purge method with the meta-cache.
    -------------------------------------------------------------------------
 */

static void
    ipr_bucket_list_cache_initialise (
void)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_INITIALISE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_initialise_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_INITIALISE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 22);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_INITIALISE))
    icl_stats_inc ("ipr_bucket_list_cache_initialise", &s_ipr_bucket_list_cache_initialise_stats);
#endif

s_cache = icl_cache_get (sizeof (ipr_bucket_list_t));
icl_system_register (ipr_bucket_list_cache_purge, ipr_bucket_list_cache_terminate);

s_iter_cache = icl_cache_get (sizeof (ipr_bucket_list_iter_t));
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_INITIALISE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 22);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_INITIALISE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_initialise_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_cache_purge

    Type: Component method
    -------------------------------------------------------------------------
 */

static void
    ipr_bucket_list_cache_purge (
void)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_PURGE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_purge_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_PURGE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 23);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_PURGE))
    icl_stats_inc ("ipr_bucket_list_cache_purge", &s_ipr_bucket_list_cache_purge_stats);
#endif

icl_mem_cache_purge (s_cache);

icl_mem_cache_purge (s_iter_cache);
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_PURGE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 23);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_PURGE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_purge_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_terminate

    Type: Component method
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_terminate (
void)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_TERMINATE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_terminate_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_TERMINATE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 24);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_TERMINATE))
    icl_stats_inc ("ipr_bucket_list_terminate", &s_ipr_bucket_list_terminate_stats);
#endif


#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_TERMINATE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 24);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_TERMINATE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_terminate_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_show

    Type: Component method
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_show_ (
    void * item,                        //  The opaque pointer
    int opcode,                         //  The callback opcode
    FILE * trace_file,                  //  File to print to
    char * file,                        //  Source file
    size_t line                         //  Line number
)
{
ipr_bucket_list_t
    *self;
int
    container_links;


#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_SHOW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_show_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" opcode=\"%i\""
" trace_file=\"%pp\""
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, opcode, trace_file, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 25);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SHOW))
    icl_stats_inc ("ipr_bucket_list_show", &s_ipr_bucket_list_show_stats);
#endif

self = item;
container_links = 0;
assert (opcode == ICL_CALLBACK_DUMP);

fprintf (trace_file, "    <ipr_bucket_list file = \"%s\" line = \"%lu\"  pointer = \"%p\" />\n", file, (unsigned long) line, self);

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 25);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_SHOW))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_show_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" item=\"%pp\""
" opcode=\"%i\""
" trace_file=\"%pp\""
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, item, opcode, trace_file, file, line);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_destroy

    Type: Component method
    Destroys a ipr_bucket_list_t object. Takes the address of a
    ipr_bucket_list_t reference (a pointer to a pointer) and nullifies the
    reference after use.  Does nothing if the reference is already
    null.
    Performs an agressive destroy of an object.  This involves:
    1. Removing the object from any containers it is in.
    2. Making the object an zombie
    3. Decrementing the object's link count
    4. If the link count is zero then freeing the object.
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_destroy_ (
    ipr_bucket_list_t * ( * self_p ),   //  Reference to object reference
    char * file,                        //  Source fileSource file
    size_t line                         //  Line numberLine number
)
{
    ipr_bucket_list_t *
        self = *self_p;                 //  Dereferenced Reference to object reference

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_DESTROY_PUBLIC))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_destroy_public_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" self=\"%pp\""
" file=\"%s\""
" line=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, self, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY_PUBLIC))
    icl_trace_record (NULL, ipr_bucket_list_dump, 26);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_DESTROY_PUBLIC))
    icl_stats_inc ("ipr_bucket_list_destroy", &s_ipr_bucket_list_destroy_stats);
#endif

if (self) {
    ipr_bucket_list_annihilate (self_p);
    ipr_bucket_list_free ((ipr_bucket_list_t *) self);
    *self_p = NULL;
}
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY_PUBLIC))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 26);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_DESTROY_PUBLIC))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_destroy_public_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
" self=\"%pp\""
" file=\"%s\""
" line=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self, self, file, line);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_alloc

    Type: Component method
    -------------------------------------------------------------------------
 */

static ipr_bucket_list_t *
    ipr_bucket_list_alloc_ (
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{

    ipr_bucket_list_t *
        self = NULL;                    //  Object reference

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_ALLOC))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_alloc_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ALLOC))
    icl_trace_record (NULL, ipr_bucket_list_dump, 27);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_ALLOC))
    icl_stats_inc ("ipr_bucket_list_alloc", &s_ipr_bucket_list_alloc_stats);
#endif

//  Initialise cache if necessary
if (!s_cache)
    ipr_bucket_list_cache_initialise ();

self = (ipr_bucket_list_t *) icl_mem_cache_alloc_ (s_cache, file, line);
if (self)
    memset (self, 0, sizeof (ipr_bucket_list_t));


#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ALLOC))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 27);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_ALLOC))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_alloc_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" file=\"%s\""
" line=\"%u\""
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, file, line, self);
#endif


    return (self);
}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_free

    Type: Component method
    Freess a ipr_bucket_list_t object.
    -------------------------------------------------------------------------
 */

static void
    ipr_bucket_list_free (
    ipr_bucket_list_t * self            //  Object reference
)
{


#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_FREE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_free_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FREE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 28);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_FREE))
    icl_stats_inc ("ipr_bucket_list_free", &s_ipr_bucket_list_free_stats);
#endif

if (self) {

        memset (&self->object_tag, 0, sizeof (ipr_bucket_list_t) - ((byte *) &self->object_tag - (byte *) self));
//        memset (self, 0, sizeof (ipr_bucket_list_t));
        self->object_tag = IPR_BUCKET_LIST_DEAD;
        icl_mem_free (self);
    }
    self = NULL;
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FREE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 28);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_FREE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_free_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_cache_terminate

    Type: Component method
    -------------------------------------------------------------------------
 */

static void
    ipr_bucket_list_cache_terminate (
void)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_TERMINATE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_terminate_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_TERMINATE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 29);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_CACHE_TERMINATE))
    icl_stats_inc ("ipr_bucket_list_cache_terminate", &s_ipr_bucket_list_cache_terminate_stats);
#endif

s_cache = NULL;

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_TERMINATE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 29);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_CACHE_TERMINATE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_cache_terminate_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_show_animation

    Type: Component method
    Enables animation of the component. Animation is sent to stdout.
    To enable animation you must generate using the option -animate:1.
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_show_animation (
    Bool enabled                        //  Are we enabling or disabling animation?
)
{

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_SHOW_ANIMATION))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_show_animation_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" enabled=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, enabled);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW_ANIMATION))
    icl_trace_record (NULL, ipr_bucket_list_dump, 30);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_SHOW_ANIMATION))
    icl_stats_inc ("ipr_bucket_list_show_animation", &s_ipr_bucket_list_show_animation_stats);
#endif

ipr_bucket_list_animating = enabled;
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW_ANIMATION))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 30);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_SHOW_ANIMATION))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_show_animation_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" enabled=\"%i\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, enabled);
#endif

}
/*  -------------------------------------------------------------------------
    ipr_bucket_list_new_in_scope

    Type: Component method
    -------------------------------------------------------------------------
 */

void
    ipr_bucket_list_new_in_scope_ (
    ipr_bucket_list_t * * self_p,       //  Not documented
    icl_scope_t * _scope,               //  Not documented
    char * file,                        //  Source file for call
    size_t line                         //  Line number for call
)
{
    icl_destroy_t *
        _destroy;                       //  Not documented

#if (defined (BASE_ANIMATE)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST)  ||  defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEW_IN_SCOPE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_new_in_scope_start"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self_p=\"%pp\""
" _scope=\"%pp\""
" file=\"%s\""
" line=\"%u\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self_p, _scope, file, line);
#endif

#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW_IN_SCOPE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 31);
#endif

#if (defined (BASE_STATS)  ||  defined (BASE_STATS_IPR_BUCKET_LIST)  ||  defined (BASE_STATS_IPR_BUCKET_LIST_NEW_IN_SCOPE))
    icl_stats_inc ("ipr_bucket_list_new_in_scope", &s_ipr_bucket_list_new_in_scope_stats);
#endif

*self_p = ipr_bucket_list_new_ (file,line);

if (*self_p) {
    _destroy = icl_destroy_new   ((void * *) self_p, (icl_destructor_fn *) ipr_bucket_list_destroy_);
    icl_destroy_list_queue (_scope, _destroy);
    icl_destroy_unlink (&_destroy);
}
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW_IN_SCOPE))
    icl_trace_record (NULL, ipr_bucket_list_dump, 0x10000 + 31);
#endif

#if (defined (BASE_ANIMATE)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST)   || defined (BASE_ANIMATE_IPR_BUCKET_LIST_NEW_IN_SCOPE))
    if (ipr_bucket_list_animating)
        icl_console_print ("<ipr_bucket_list_new_in_scope_finish"
#if (defined (BASE_THREADSAFE))
" thread=\"%pp\""
#endif
" self_p=\"%pp\""
" _scope=\"%pp\""
" file=\"%s\""
" line=\"%u\""
" _destroy=\"%pp\""
"/>"
#if (defined (BASE_THREADSAFE))
, apr_os_thread_current ()
#endif
, self_p, _scope, file, line, _destroy);
#endif

}
#if (defined (BASE_TRACE)   || defined (BASE_TRACE_IPR_BUCKET_LIST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CLEAR)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LOAD)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SAVE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SELFTEST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_NEW)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_OBJECT)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ITER_DESTROY)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ISEMPTY)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PUSH)   || defined (BASE_TRACE_IPR_BUCKET_LIST_POP)   || defined (BASE_TRACE_IPR_BUCKET_LIST_QUEUE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_RELINK_BEFORE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REMOVE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FIRST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_LAST)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEXT)   || defined (BASE_TRACE_IPR_BUCKET_LIST_PREV)   || defined (BASE_TRACE_IPR_BUCKET_LIST_REHOOK)   || defined (BASE_TRACE_IPR_BUCKET_LIST_UNHOOK)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_INITIALISE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_PURGE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_TERMINATE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW)   || defined (BASE_TRACE_IPR_BUCKET_LIST_DESTROY_PUBLIC)   || defined (BASE_TRACE_IPR_BUCKET_LIST_ALLOC)   || defined (BASE_TRACE_IPR_BUCKET_LIST_FREE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_CACHE_TERMINATE)   || defined (BASE_TRACE_IPR_BUCKET_LIST_SHOW_ANIMATION)   || defined (BASE_TRACE_IPR_BUCKET_LIST_NEW_IN_SCOPE) )
void
ipr_bucket_list_dump (icl_os_thread_t thread, apr_time_t time, qbyte info)
{
    dbyte
        method = info & 0xFFFF;
    char
        *method_name = NULL;
        
    switch (method) {
        case 1: method_name = "clear"; break;
        case 2: method_name = "load"; break;
        case 3: method_name = "save"; break;
        case 4: method_name = "selftest"; break;
        case 5: method_name = "iter new"; break;
        case 6: method_name = "iter object"; break;
        case 7: method_name = "iter destroy"; break;
        case 8: method_name = "new"; break;
        case 9: method_name = "destroy"; break;
        case 10: method_name = "isempty"; break;
        case 11: method_name = "push"; break;
        case 12: method_name = "pop"; break;
        case 13: method_name = "queue"; break;
        case 14: method_name = "relink before"; break;
        case 15: method_name = "remove"; break;
        case 16: method_name = "first"; break;
        case 17: method_name = "last"; break;
        case 18: method_name = "next"; break;
        case 19: method_name = "prev"; break;
        case 20: method_name = "rehook"; break;
        case 21: method_name = "unhook"; break;
        case 22: method_name = "cache initialise"; break;
        case 23: method_name = "cache purge"; break;
        case 24: method_name = "terminate"; break;
        case 25: method_name = "show"; break;
        case 26: method_name = "destroy public"; break;
        case 27: method_name = "alloc"; break;
        case 28: method_name = "free"; break;
        case 29: method_name = "cache terminate"; break;
        case 30: method_name = "show animation"; break;
        case 31: method_name = "new in scope"; break;
    }
    icl_console_print_thread_time (thread, time,
                                   "ipr_bucket_list %s%s",
                                   (info > 0xFFFF) ? "/" : "",
                                   method_name);
}
#endif

//  Embed the version information in the resulting binary                      

char *ipr_bucket_list_version_start  = "VeRsIoNsTaRt:ipc";
char *ipr_bucket_list_component    = "ipr_bucket_list ";
char *ipr_bucket_list_version      = "1.0 ";
char *ipr_bucket_list_copyright    = "Copyright (c) 1996-2009 iMatix Corporation";
char *ipr_bucket_list_filename     = "ipr_bucket_list.icl ";
char *ipr_bucket_list_builddate    = "2009/02/19 ";
char *ipr_bucket_list_version_end  = "VeRsIoNeNd:ipc";

