aboutsummaryrefslogtreecommitdiffstats
path: root/Source/charon/queues/job_queue.h
diff options
context:
space:
mode:
authorMartin Willi <martin@strongswan.org>2005-11-29 08:08:03 +0000
committerMartin Willi <martin@strongswan.org>2005-11-29 08:08:03 +0000
commitdf3c59d0889a337eff9f994e92a5dc165ba1729f (patch)
tree7973747444155ea669e3f2dc1177b9b2eb3fc8a1 /Source/charon/queues/job_queue.h
parented37dee61daf5bb272c04b79787da282abaa9447 (diff)
downloadstrongswan-df3c59d0889a337eff9f994e92a5dc165ba1729f.tar.bz2
strongswan-df3c59d0889a337eff9f994e92a5dc165ba1729f.tar.xz
- changed allocation behavior
Diffstat (limited to 'Source/charon/queues/job_queue.h')
-rw-r--r--Source/charon/queues/job_queue.h18
1 files changed, 11 insertions, 7 deletions
diff --git a/Source/charon/queues/job_queue.h b/Source/charon/queues/job_queue.h
index b0a3066db..48b6f07c1 100644
--- a/Source/charon/queues/job_queue.h
+++ b/Source/charon/queues/job_queue.h
@@ -1,7 +1,7 @@
/**
* @file job_queue.h
*
- * @brief Interface of job_queue_t-
+ * @brief Interface of job_queue_t.
*
*/
@@ -32,7 +32,9 @@ typedef struct job_queue_t job_queue_t;
* @brief Job-Queue
*
* Although the job-queue is based on a linked_list_t
- * all access functions are thread-save implemented
+ * all access functions are thread-save implemented.
+ *
+ * @ingroup queues
*/
struct job_queue_t {
@@ -52,7 +54,7 @@ struct job_queue_t {
*
* @param job_queue_t calling object
* @param[out] job pointer to a job pointer where to job is returned to
- * @return job
+ * @return next job
*/
job_t *(*get) (job_queue_t *job_queue);
@@ -63,8 +65,8 @@ struct job_queue_t {
* The specific job object has to get destroyed by the thread which
* removes the job.
*
- * @param job_queue_t calling object
- * @param[in] job job to add to the queue (job is not copied)
+ * @param job_queue_t calling object
+ * @param job job to add to the queue (job is not copied)
*/
void (*add) (job_queue_t *job_queue, job_t *job);
@@ -75,15 +77,17 @@ struct job_queue_t {
* that no thread is going to add or get a job from the job_queue
* after calling this function.
*
- * @param job_queue_t calling object
+ * @param job_queue_t calling object
*/
void (*destroy) (job_queue_t *job_queue);
};
/**
- * @brief Creates an empty job_queue
+ * @brief Creates an empty job_queue.
*
* @return job_queue_t empty job_queue
+ *
+ * @ingroup queues
*/
job_queue_t *job_queue_create();