X-Git-Url: http://git.silcnet.org/gitweb/?a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilclist.h;h=66efd22fa7dd8667df1280a8ccff30a06e0464bc;hb=30b8fb532138b2d9b523d3c069724e78fb72f8e3;hp=50213491f0b361239d015a5cd08606752499b777;hpb=0f0340b9fbce9704cc7171f8f0104ce9103d2de6;p=silc.git

diff --git a/lib/silcutil/silclist.h b/lib/silcutil/silclist.h
index 50213491..66efd22f 100644
--- a/lib/silcutil/silclist.h
+++ b/lib/silcutil/silclist.h
@@ -4,7 +4,7 @@
 
   Author: Pekka Riikonen <priikone@silcnet.org>
 
-  Copyright (C) 2002 - 2005 Pekka Riikonen
+  Copyright (C) 2002 - 2007 Pekka Riikonen
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
@@ -21,8 +21,24 @@
  *
  * DESCRIPTION
  *
- * Implementation of the SilcList interface.  This interface provides
- * simple linked list.
+ * Generic list interface that can turn any structure with list pointers
+ * into a SilcList.  The interface can provide both singly and doubly linked
+ * lists.  The interface does not allocate any memory.
+ *
+ * SILC List is not thread-safe.  If the same list context must be used
+ * in multithreaded environment concurrency control must be employed.
+ *
+ * EXAMPLE
+ *
+ * struct EntryStruct {
+ *   char *dummy;
+ *   struct EntryStruct *next;        // The list member pointer
+ * };
+ *
+ * SilcList list;
+ *
+ * // Initialize list
+ * silc_list_init(list, struct EntryStruct, next);
  *
  ***/
 
@@ -41,12 +57,12 @@
  *    function silc_list_init.
  *
  ***/
-typedef struct {
+typedef struct SilcListStruct {
   void *head;			     /* Start of the list */
   void *tail;			     /* End of the list */
   void *current;		     /* Current pointer in list */
-  unsigned int next_offset : 16;     /* Offset to 'next' pointer */
-  unsigned int prev_offset : 16;     /* Offset to 'prev' pointer */
+  SilcUInt16 next_offset;	     /* Offset to 'next' pointer */
+  SilcUInt16 prev_offset;	     /* Offset to 'prev' pointer */
   unsigned int prev_set    : 1;	     /* Set if 'prev' exists */
   unsigned int end_set     : 1;	     /* Set if silc_list_end was called */
   unsigned int count       : 30;     /* Number of entries in the list */
@@ -101,6 +117,7 @@ do {							\
   (list).next_offset = silc_offsetof(type, nextfield);	\
   (list).prev_set = 0;					\
   (list).prev_offset = 0;				\
+  (list).end_set = 0;					\
   (list).head = (list).tail = (list).current = NULL;	\
 } while(0)
 
@@ -140,6 +157,7 @@ do {								\
   (list).next_offset = silc_offsetof(type, nextfield);		\
   (list).prev_offset = silc_offsetof(type, prevfield);		\
   (list).prev_set = 1;						\
+  (list).end_set = 0;						\
   (list).head = (list).tail = (list).current = NULL;		\
 } while(0)