2 ** Copyright (C) 2002 by Kevin L. Mitchell <klmitch@mit.edu>
4 ** This library is free software; you can redistribute it and/or
5 ** modify it under the terms of the GNU Library General Public
6 ** License as published by the Free Software Foundation; either
7 ** version 2 of the License, or (at your option) any later version.
9 ** This library is distributed in the hope that it will be useful,
10 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
11 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 ** Library General Public License for more details.
14 ** You should have received a copy of the GNU Library General Public
15 ** License along with this library; if not, write to the Free
16 ** Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
22 #include "dbprim_int.h"
26 /** \ingroup dbprim_link
27 * \brief Dynamically initialize a linked list head.
29 * This function dynamically initializes a linked list head.
31 * \param list A pointer to a #link_head_t to be initialized.
32 * \param extra A pointer to \c void containing extra pointer data
33 * associated with the linked list.
35 * \retval DB_ERR_BADARGS A \c NULL pointer was passed for \p
39 ll_init(link_head_t *list, void *extra)
41 initialize_dbpr_error_table(); /* set up error tables */
43 if (!list) /* must have a list head */
44 return DB_ERR_BADARGS;
46 list->lh_count = 0; /* initialize the list head */
49 list->lh_extra = extra;
51 list->lh_magic = LINK_HEAD_MAGIC; /* set the magic number */