diff options
Diffstat (limited to 'src/include/gnunet_mq_lib.h')
-rw-r--r-- | src/include/gnunet_mq_lib.h | 56 |
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 | */ | ||
141 | const struct GNUNET_MessageHeader * | ||
142 | GNUNET_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 | */ | ||
151 | const struct GNUNET_MQ_Envelope * | ||
152 | GNUNET_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 | */ | ||
352 | struct GNUNET_MQ_MessageHandler * | ||
353 | GNUNET_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. |