From: Alan T. DeKok <aland@freeradius.org>
Date: Mon, 31 Oct 2016 16:23:32 +0000 (-0400)
Subject: doxygen for atomic queue
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b276248e8cc8155f868766ebe8d234870ef90cd6;p=thirdparty%2Ffreeradius-server.git

doxygen for atomic queue
---

diff --git a/src/util/atomic_queue.c b/src/util/atomic_queue.c
index db642ab75c3..88b9ae899ab 100644
--- a/src/util/atomic_queue.c
+++ b/src/util/atomic_queue.c
@@ -112,7 +112,14 @@ fr_atomic_queue_t *fr_atomic_queue_create(TALLOC_CTX *ctx, int size)
 }
 
 
-
+/** Push a pointer into the atomic queue
+ *
+ * @param[in] aq the queue
+ * @param[in] data the data to push
+ * @return
+ *	true on successful push
+ *	false on queue full
+ */
 bool fr_atomic_queue_push(fr_atomic_queue_t *aq, void *data)
 {
 	int64_t head;
@@ -168,6 +175,15 @@ bool fr_atomic_queue_push(fr_atomic_queue_t *aq, void *data)
 	return true;
 }
 
+
+/** Pop a pointer from the atomic queue
+ *
+ * @param[in] aq the queue
+ * @param[in] p_data where to write the data
+ * @return
+ *	true on successful pop
+ *	false on queue empty
+ */
 bool fr_atomic_queue_pop(fr_atomic_queue_t *aq, void **p_data)
 {
 	int64_t tail, seq;
@@ -222,6 +238,9 @@ bool fr_atomic_queue_pop(fr_atomic_queue_t *aq, void **p_data)
 /**  Dump an atomic queue.
  *
  *  Absolutely NOT thread-safe.
+ *
+ * @param[in] aq the queue
+ * @param[in] fp where the debugging information will be printed.
  */
 void fr_atomic_queue_debug(fr_atomic_queue_t *aq, FILE *fp)
 {