From 2777ecd9875c395d2db6debba1de8006ecfd47b0 Mon Sep 17 00:00:00 2001 From: Harald Welte Date: Wed, 17 Aug 2011 14:23:42 +0200 Subject: doxygen: Add 'write_queue' module --- include/osmocom/core/write_queue.h | 30 ++++++------------------------ 1 file changed, 6 insertions(+), 24 deletions(-) (limited to 'include/osmocom') diff --git a/include/osmocom/core/write_queue.h b/include/osmocom/core/write_queue.h index 373b64ff..8b896d15 100644 --- a/include/osmocom/core/write_queue.h +++ b/include/osmocom/core/write_queue.h @@ -23,8 +23,11 @@ #ifndef OSMO_WQUEUE_H #define OSMO_WQUEUE_H +/*! \defgroup write_queue Osmocom msgb write queues + * @{ + */ + /*! \file write_queue.h - * \brief Osmocom write queues */ #include @@ -50,32 +53,11 @@ struct osmo_wqueue { int (*except_cb)(struct osmo_fd *fd); }; -/*! \brief Initialize a \ref osmo_wqueue structure - * \param[in] queue Write queue to operate on - * \param[in] max_length Maximum length of write queue - */ void osmo_wqueue_init(struct osmo_wqueue *queue, int max_length); - -/*! \brief Clear a \ref osmo_wqueue - * \param[in] queue Write queue to be cleared - * - * This function will clear (remove/release) all messages in it. - */ void osmo_wqueue_clear(struct osmo_wqueue *queue); - -/*! \brief Enqueue a new \ref msgb into a write queue - * \param[in] queue Write queue to be used - * \param[in] data to-be-enqueued message buffer - */ int osmo_wqueue_enqueue(struct osmo_wqueue *queue, struct msgb *data); - -/*! \brief Select loop function for write queue handling - * \param[in] fd osmocom file descriptor - * \param[in] what bit-mask of events that have happened - * - * This function is provided so that it can be registered with the - * select loop abstraction code (\ref osmo_fd::cb). - */ int osmo_wqueue_bfd_cb(struct osmo_fd *fd, unsigned int what); +/*! }@ */ + #endif -- cgit v1.2.3