aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_mq_lib.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/include/gnunet_mq_lib.h')
-rw-r--r--src/include/gnunet_mq_lib.h56
1 files changed, 46 insertions, 10 deletions
diff --git a/src/include/gnunet_mq_lib.h b/src/include/gnunet_mq_lib.h
index ecee1b223..226b3389f 100644
--- a/src/include/gnunet_mq_lib.h
+++ b/src/include/gnunet_mq_lib.h
@@ -2,20 +2,18 @@
2 This file is part of GNUnet. 2 This file is part of GNUnet.
3 Copyright (C) 2012-2016 GNUnet e.V. 3 Copyright (C) 2012-2016 GNUnet e.V.
4 4
5 GNUnet is free software; you can redistribute it and/or modify 5 GNUnet is free software: you can redistribute it and/or modify it
6 it under the terms of the GNU General Public License as published 6 under the terms of the GNU Affero General Public License as published
7 by the Free Software Foundation; either version 3, or (at your 7 by the Free Software Foundation, either version 3 of the License,
8 option) any later version. 8 or (at your option) any later version.
9 9
10 GNUnet is distributed in the hope that it will be useful, but 10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of 11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details. 13 Affero General Public License for more details.
14 14
15 You should have received a copy of the GNU General Public License 15 You should have received a copy of the GNU Affero General Public License
16 along with GNUnet; see the file COPYING. If not, write to the 16 along with this program. If not, see <http://www.gnu.org/licenses/>.
17 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
19*/ 17*/
20 18
21/** 19/**
@@ -135,6 +133,26 @@ struct GNUNET_MQ_Envelope;
135 133
136 134
137/** 135/**
136 * Obtain message contained in envelope.
137 *
138 * @param env the envelope
139 * @return message contained in the envelope
140 */
141const struct GNUNET_MessageHeader *
142GNUNET_MQ_env_get_msg (const struct GNUNET_MQ_Envelope *env);
143
144
145/**
146 * Return next envelope in queue.
147 *
148 * @param env a queued envelope
149 * @return next one, or NULL
150 */
151const struct GNUNET_MQ_Envelope *
152GNUNET_MQ_env_next (const struct GNUNET_MQ_Envelope *env);
153
154
155/**
138 * Implementation of the #GNUNET_MQ_msg_nested_mh macro. 156 * Implementation of the #GNUNET_MQ_msg_nested_mh macro.
139 * 157 *
140 * @param mhp pointer to the message header pointer that will be changed to allocate at 158 * @param mhp pointer to the message header pointer that will be changed to allocate at
@@ -320,6 +338,24 @@ GNUNET_MQ_copy_handlers (const struct GNUNET_MQ_MessageHandler *handlers);
320 338
321 339
322/** 340/**
341 * Copy an array of handlers, appending AGPL handler.
342 *
343 * Useful if the array has been delared in local memory and needs to be
344 * persisted for future use.
345 *
346 * @param handlers Array of handlers to be copied. Can be NULL (nothing done).
347 * @param agpl_handler function to call for AGPL handling
348 * @param agpl_cls closure for @a agpl_handler
349 * @return A newly allocated array of handlers.
350 * Needs to be freed with #GNUNET_free.
351 */
352struct GNUNET_MQ_MessageHandler *
353GNUNET_MQ_copy_handlers2 (const struct GNUNET_MQ_MessageHandler *handlers,
354 GNUNET_MQ_MessageCallback agpl_handler,
355 void *agpl_cls);
356
357
358/**
323 * Count the handlers in a handler array. 359 * Count the handlers in a handler array.
324 * 360 *
325 * @param handlers Array of handlers to be counted. 361 * @param handlers Array of handlers to be counted.