From: Nick Mathewson <nickm@torproject.org>
Date: Mon, 17 Aug 2015 17:36:56 +0000 (-0400)
Subject: Add comments for thread-local storage functions
X-Git-Tag: tor-0.2.7.3-rc~97^2~2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e8fe77530ad6238dc16781b0032899f3affa778f;p=thirdparty%2Ftor.git

Add comments for thread-local storage functions
---

diff --git a/src/common/compat_threads.h b/src/common/compat_threads.h
index a1b5056a40..9f34054050 100644
--- a/src/common/compat_threads.h
+++ b/src/common/compat_threads.h
@@ -119,9 +119,26 @@ typedef struct tor_threadlocal_s {
 #endif
 } tor_threadlocal_t;
 
+/** Initialize a thread-local variable.
+ *
+ * After you call this function on a tor_threadlocal_t, you can call
+ * tor_threadlocal_set to change the current value of this variable for the
+ * current thread, and tor_threadlocal_get to retrieve the current value for
+ * the current thread.  Each thread has its own value.
+ **/
 int tor_threadlocal_init(tor_threadlocal_t *threadlocal);
+/**
+ * Release all resource associated with a thread-local variable.
+ */
 void tor_threadlocal_destroy(tor_threadlocal_t *threadlocal);
+/**
+ * Return the current value of a thread-local variable for this thread.
+ */
 void *tor_threadlocal_get(tor_threadlocal_t *threadlocal);
+/**
+ * Change the current value of a thread-local variable for this thread to
+ * <b>value</b>.
+ */
 void tor_threadlocal_set(tor_threadlocal_t *threadlocal, void *value);
 
 #endif