From 291aa51d0524634dee7b7c92f7bf73df06c6ebdc Mon Sep 17 00:00:00 2001
From: Pekka Riikonen <priikone@silcnet.org>
Date: Fri, 15 Sep 2006 12:05:22 +0000
Subject: [PATCH] 	Header changes.

---
 lib/silcutil/silcbuffer.h  |  3 +++
 lib/silcutil/silcdlist.h   | 10 ++++------
 lib/silcutil/silcidcache.h |  3 +++
 lib/silcutil/silclist.h    |  3 +++
 lib/silcutil/silcmime.h    |  3 +++
 lib/silcutil/silcstack.h   |  3 +++
 lib/silcutil/silcvcard.h   |  6 +++---
 7 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/lib/silcutil/silcbuffer.h b/lib/silcutil/silcbuffer.h
index f70c020d..b88af80e 100644
--- a/lib/silcutil/silcbuffer.h
+++ b/lib/silcutil/silcbuffer.h
@@ -105,6 +105,9 @@
  *     section. Tail section can be pulled towards end, and thus the data
  *     section becomes larger.
  *
+ * SILC Buffer is not thread-safe.  If the same buffer context must be used
+ * in multithreaded environment concurrency control must be employed.
+ *
  * SOURCE
  */
 typedef struct {
diff --git a/lib/silcutil/silcdlist.h b/lib/silcutil/silcdlist.h
index d205ede0..cb46c82f 100644
--- a/lib/silcutil/silcdlist.h
+++ b/lib/silcutil/silcdlist.h
@@ -30,13 +30,11 @@
  * will automatically allocate list entries.  Normal SILC List API cannot
  * be used for this purpose because in that case the context passed to the
  * list must be defined as list structure already.  This is not the case in
- * SilcDList.
+ * SilcDList.  But SilcDList is a bit slower than SilcList because it 
+ * requires memory allocation when adding new entries to the list.
  *
- * This is slower than SilcList because this requires one extra memory
- * allocation when adding new entries to the list.  The context is probably
- * allocated already and the new list entry requires one additional memory
- * allocation.  The memory allocation and freeing is done automatically in
- * the API and does not show to the caller.
+ * SILC Dynamic List is not thread-safe.  If the same list context must be 
+ * used in multithreaded environment concurrency control must be employed.
  *
  ***/
 
diff --git a/lib/silcutil/silcidcache.h b/lib/silcutil/silcidcache.h
index 7b84e7bc..402c1715 100644
--- a/lib/silcutil/silcidcache.h
+++ b/lib/silcutil/silcidcache.h
@@ -25,6 +25,9 @@
  * protocol.  Application can save here the ID's it uses and the interface
  * provides fast retrieval of the ID's from the cache.
  *
+ * SILC ID Cache is not thread-safe.  If the same cache context must be 
+ * used in multithreaded environment concurrency control must be employed.
+ *
  ***/
 
 #ifndef SILCIDCACHE_H
diff --git a/lib/silcutil/silclist.h b/lib/silcutil/silclist.h
index 1cd19770..e7d9c53b 100644
--- a/lib/silcutil/silclist.h
+++ b/lib/silcutil/silclist.h
@@ -24,6 +24,9 @@
  * Implementation of the SilcList interface.  This interface provides
  * simple linked list.
  *
+ * SILC List is not thread-safe.  If the same list context must be used
+ * in multithreaded environment concurrency control must be employed.
+ *
  ***/
 
 #ifndef SILCLIST_H
diff --git a/lib/silcutil/silcmime.h b/lib/silcutil/silcmime.h
index 653a6625..8bc221cd 100644
--- a/lib/silcutil/silcmime.h
+++ b/lib/silcutil/silcmime.h
@@ -25,6 +25,9 @@
  * MIME messages, multipart MIME messages, including nested multiparts, and
  * MIME fragmentation and defragmentation.
  *
+ * SILC Mime API is not thread-safe.  If the same MIME context must be
+ * used in multithreaded environment concurrency control must be employed.
+ *
  ***/
 
 #ifndef SILCMIME_H
diff --git a/lib/silcutil/silcstack.h b/lib/silcutil/silcstack.h
index c8ce3be5..e5d59af3 100644
--- a/lib/silcutil/silcstack.h
+++ b/lib/silcutil/silcstack.h
@@ -46,6 +46,9 @@
  * silc_buffer_sclone, silc_buffer_sformat, silc_buffer_sformat_vp,
  * silc_buffer_sstrformat, silc_mp_sinit
  *
+ * The data stack is not thread-safe.  If the same stack context must be 
+ * used in multithreaded environment concurrency control must be employed.
+ *
  ***/
 
 #ifndef SILCSTACK_H
diff --git a/lib/silcutil/silcvcard.h b/lib/silcutil/silcvcard.h
index e0ee3a83..e0572cdb 100644
--- a/lib/silcutil/silcvcard.h
+++ b/lib/silcutil/silcvcard.h
@@ -122,8 +122,8 @@ unsigned char *silc_vcard_encode(SilcVCard vcard, SilcUInt32 *vcard_len);
  *
  * SYNOPSIS
  *
- *    SilcBool silc_vcard_decode(const unsigned char *data, SilcUInt32 data_len,
- *                           SilcVCard vcard);
+ *    SilcBool silc_vcard_decode(const unsigned char *data,
+ *                               SilcUInt32 data_len, SilcVCard vcard);
  *
  * DESCRIPTION
  *
@@ -135,7 +135,7 @@ unsigned char *silc_vcard_encode(SilcVCard vcard, SilcUInt32 *vcard_len);
  *
  ***/
 SilcBool silc_vcard_decode(const unsigned char *data, SilcUInt32 data_len,
-		       SilcVCard vcard);
+			   SilcVCard vcard);
 
 /****f* silcutil/SilcVCard/silc_vcard_alloc
  *
-- 
2.24.0