Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 1 | /* (C) 2008 by Harald Welte <laforge@gnumonks.org> |
Holger Hans Peter Freyther | acffb60 | 2010-10-18 18:22:31 +0200 | [diff] [blame] | 2 | * (C) 2010 by Holger Hans Peter Freyther <zecke@selfish.org> |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 3 | * All Rights Reserved |
| 4 | * |
Harald Welte | e08da97 | 2017-11-13 01:00:26 +0900 | [diff] [blame] | 5 | * SPDX-License-Identifier: GPL-2.0+ |
| 6 | * |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 7 | * This program is free software; you can redistribute it and/or modify |
| 8 | * it under the terms of the GNU General Public License as published by |
| 9 | * the Free Software Foundation; either version 2 of the License, or |
| 10 | * (at your option) any later version. |
| 11 | * |
| 12 | * This program is distributed in the hope that it will be useful, |
| 13 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 15 | * GNU General Public License for more details. |
| 16 | * |
| 17 | * You should have received a copy of the GNU General Public License along |
| 18 | * with this program; if not, write to the Free Software Foundation, Inc., |
| 19 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| 20 | * |
| 21 | */ |
| 22 | |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 23 | /*! \addtogroup msgb |
| 24 | * @{ |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 25 | * |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 26 | * libosmocore message buffers, inspired by Linux kernel skbuff |
Harald Welte | 96e2a00 | 2017-06-12 21:44:18 +0200 | [diff] [blame] | 27 | * |
| 28 | * Inspired by the 'struct skbuff' of the Linux kernel, we implement a |
| 29 | * 'struct msgb' which we use for handling network |
| 30 | * packets aka messages aka PDUs. |
| 31 | * |
| 32 | * A msgb consists of |
| 33 | * * a header with some metadata, such as |
| 34 | * * a linked list header for message queues or the like |
| 35 | * * pointers to the headers of various protocol layers inside |
| 36 | * the packet |
| 37 | * * a data section consisting of |
| 38 | * * headroom, i.e. space in front of the message, to allow |
| 39 | * for additional headers being pushed in front of the current |
| 40 | * data |
Vadim Yanitskiy | 8c8e6d7 | 2018-03-08 21:10:23 +0700 | [diff] [blame] | 41 | * * the currently occupied data for the message |
Harald Welte | 96e2a00 | 2017-06-12 21:44:18 +0200 | [diff] [blame] | 42 | * * tailroom, i.e. space at the end of the message, to |
| 43 | * allow more data to be added after the end of the current |
| 44 | * data |
| 45 | * |
| 46 | * We have plenty of utility functions around the \ref msgb: |
| 47 | * * allocation / release |
| 48 | * * enqueue / dequeue from/to message queues |
| 49 | * * prepending (pushing) and appending (putting) data |
| 50 | * * copying / resizing |
| 51 | * * hex-dumping to a string for debug purposes |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 52 | * |
| 53 | * \file msgb.c |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 54 | */ |
| 55 | |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 56 | #include <unistd.h> |
| 57 | #include <string.h> |
| 58 | #include <stdlib.h> |
Neels Hofmeyr | 42fff58 | 2015-12-23 15:12:40 +0100 | [diff] [blame] | 59 | #include <inttypes.h> |
Philipp Maier | c5b47cc | 2017-10-10 16:53:21 +0200 | [diff] [blame] | 60 | #include <stdarg.h> |
| 61 | #include <errno.h> |
| 62 | |
Pablo Neira Ayuso | 8341934 | 2011-03-22 16:36:13 +0100 | [diff] [blame] | 63 | #include <osmocom/core/msgb.h> |
Pablo Neira Ayuso | 8341934 | 2011-03-22 16:36:13 +0100 | [diff] [blame] | 64 | #include <osmocom/core/talloc.h> |
Vadim Yanitskiy | b423305 | 2018-03-08 21:35:48 +0700 | [diff] [blame] | 65 | #include <osmocom/core/logging.h> |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 66 | |
Neels Hofmeyr | f45334b | 2016-09-16 00:15:56 +0200 | [diff] [blame] | 67 | void *tall_msgb_ctx = NULL; |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 68 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 69 | /*! Allocate a new message buffer |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 70 | * \param[in] size Length in octets, including headroom |
| 71 | * \param[in] name Human-readable name to be associated with msgb |
Harald Welte | 2d2e2cc | 2016-04-25 12:11:20 +0200 | [diff] [blame] | 72 | * \returns dynamically-allocated \ref msgb |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 73 | * |
| 74 | * This function allocates a 'struct msgb' as well as the underlying |
| 75 | * memory buffer for the actual message data (size specified by \a size) |
| 76 | * using the talloc memory context previously set by \ref msgb_set_talloc_ctx |
| 77 | */ |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 78 | struct msgb *msgb_alloc(uint16_t size, const char *name) |
| 79 | { |
| 80 | struct msgb *msg; |
| 81 | |
Vadim Yanitskiy | 10959cd | 2018-03-08 21:57:42 +0700 | [diff] [blame] | 82 | msg = talloc_named_const(tall_msgb_ctx, sizeof(*msg) + size, name); |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 83 | if (!msg) { |
Vadim Yanitskiy | b423305 | 2018-03-08 21:35:48 +0700 | [diff] [blame] | 84 | LOGP(DLGLOBAL, LOGL_FATAL, "Unable to allocate a msgb: " |
| 85 | "name='%s', size=%u\n", name, size); |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 86 | return NULL; |
| 87 | } |
| 88 | |
Vadim Yanitskiy | 10959cd | 2018-03-08 21:57:42 +0700 | [diff] [blame] | 89 | /* Manually zero-initialize allocated memory */ |
| 90 | memset(msg, 0x00, sizeof(*msg) + size); |
| 91 | |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 92 | msg->data_len = size; |
| 93 | msg->len = 0; |
| 94 | msg->data = msg->_data; |
Sylvain Munaut | 17a5a28 | 2010-02-24 22:57:46 +0100 | [diff] [blame] | 95 | msg->head = msg->_data; |
| 96 | msg->tail = msg->_data; |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 97 | |
| 98 | return msg; |
| 99 | } |
| 100 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 101 | /*! Release given message buffer |
Vadim Yanitskiy | 8c8e6d7 | 2018-03-08 21:10:23 +0700 | [diff] [blame] | 102 | * \param[in] m Message buffer to be freed |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 103 | */ |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 104 | void msgb_free(struct msgb *m) |
| 105 | { |
| 106 | talloc_free(m); |
| 107 | } |
| 108 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 109 | /*! Enqueue message buffer to tail of a queue |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 110 | * \param[in] queue linked list header of queue |
Katerina Barone-Adesi | c28c6a0 | 2013-02-15 13:27:59 +0100 | [diff] [blame] | 111 | * \param[in] msg message buffer to be added to the queue |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 112 | * |
| 113 | * The function will append the specified message buffer \a msg to the |
| 114 | * queue implemented by \ref llist_head \a queue |
| 115 | */ |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 116 | void msgb_enqueue(struct llist_head *queue, struct msgb *msg) |
| 117 | { |
| 118 | llist_add_tail(&msg->list, queue); |
| 119 | } |
| 120 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 121 | /*! Dequeue message buffer from head of queue |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 122 | * \param[in] queue linked list header of queue |
| 123 | * \returns message buffer (if any) or NULL if queue empty |
| 124 | * |
| 125 | * The function will remove the first message buffer from the queue |
Katerina Barone-Adesi | c28c6a0 | 2013-02-15 13:27:59 +0100 | [diff] [blame] | 126 | * implemented by \ref llist_head \a queue. |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 127 | */ |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 128 | struct msgb *msgb_dequeue(struct llist_head *queue) |
| 129 | { |
| 130 | struct llist_head *lh; |
| 131 | |
| 132 | if (llist_empty(queue)) |
| 133 | return NULL; |
| 134 | |
| 135 | lh = queue->next; |
Max | d826f17 | 2016-06-23 13:14:02 +0200 | [diff] [blame] | 136 | |
| 137 | if (lh) { |
| 138 | llist_del(lh); |
| 139 | return llist_entry(lh, struct msgb, list); |
| 140 | } else |
| 141 | return NULL; |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 142 | } |
| 143 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 144 | /*! Re-set all message buffer pointers |
Katerina Barone-Adesi | c28c6a0 | 2013-02-15 13:27:59 +0100 | [diff] [blame] | 145 | * \param[in] msg message buffer that is to be resetted |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 146 | * |
| 147 | * This will re-set the various internal pointers into the underlying |
Vadim Yanitskiy | 8c8e6d7 | 2018-03-08 21:10:23 +0700 | [diff] [blame] | 148 | * message buffer, i.e. remove all headroom and treat the msgb as |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 149 | * completely empty. It also initializes the control buffer to zero. |
| 150 | */ |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 151 | void msgb_reset(struct msgb *msg) |
| 152 | { |
| 153 | msg->len = 0; |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 154 | msg->data = msg->_data; |
Sylvain Munaut | 17a5a28 | 2010-02-24 22:57:46 +0100 | [diff] [blame] | 155 | msg->head = msg->_data; |
| 156 | msg->tail = msg->_data; |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 157 | |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 158 | msg->trx = NULL; |
| 159 | msg->lchan = NULL; |
| 160 | msg->l2h = NULL; |
| 161 | msg->l3h = NULL; |
Harald Welte | bb77c9d | 2010-04-30 14:26:12 +0200 | [diff] [blame] | 162 | msg->l4h = NULL; |
Harald Welte | 95df5c0 | 2010-05-01 23:53:26 +0200 | [diff] [blame] | 163 | |
| 164 | memset(&msg->cb, 0, sizeof(msg->cb)); |
Harald Welte | ec8b450 | 2010-02-20 20:34:29 +0100 | [diff] [blame] | 165 | } |
Holger Hans Peter Freyther | acffb60 | 2010-10-18 18:22:31 +0200 | [diff] [blame] | 166 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 167 | /*! get pointer to data section of message buffer |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 168 | * \param[in] msg message buffer |
| 169 | * \returns pointer to data section of message buffer |
| 170 | */ |
Holger Hans Peter Freyther | acffb60 | 2010-10-18 18:22:31 +0200 | [diff] [blame] | 171 | uint8_t *msgb_data(const struct msgb *msg) |
| 172 | { |
| 173 | return msg->data; |
| 174 | } |
| 175 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 176 | /*! get length of message buffer |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 177 | * \param[in] msg message buffer |
| 178 | * \returns length of data section in message buffer |
| 179 | */ |
Holger Hans Peter Freyther | acffb60 | 2010-10-18 18:22:31 +0200 | [diff] [blame] | 180 | uint16_t msgb_length(const struct msgb *msg) |
| 181 | { |
| 182 | return msg->len; |
| 183 | } |
Harald Welte | 9e1f060 | 2011-06-29 18:46:10 +0200 | [diff] [blame] | 184 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 185 | /*! Set the talloc context for \ref msgb_alloc |
Neels Hofmeyr | f45334b | 2016-09-16 00:15:56 +0200 | [diff] [blame] | 186 | * Deprecated, use msgb_talloc_ctx_init() instead. |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 187 | * \param[in] ctx talloc context to be used as root for msgb allocations |
| 188 | */ |
Harald Welte | 9e1f060 | 2011-06-29 18:46:10 +0200 | [diff] [blame] | 189 | void msgb_set_talloc_ctx(void *ctx) |
| 190 | { |
| 191 | tall_msgb_ctx = ctx; |
| 192 | } |
Harald Welte | ba6988b | 2011-08-17 12:46:48 +0200 | [diff] [blame] | 193 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 194 | /*! Initialize a msgb talloc context for \ref msgb_alloc. |
Neels Hofmeyr | f45334b | 2016-09-16 00:15:56 +0200 | [diff] [blame] | 195 | * Create a talloc context called "msgb". If \a pool_size is 0, create a named |
| 196 | * const as msgb talloc context. If \a pool_size is nonzero, create a talloc |
| 197 | * pool, possibly for faster msgb allocations (see talloc_pool()). |
| 198 | * \param[in] root_ctx talloc context used as parent for the new "msgb" ctx. |
| 199 | * \param[in] pool_size if nonzero, create a talloc pool of this size. |
| 200 | * \returns the new msgb talloc context, e.g. for reporting |
| 201 | */ |
| 202 | void *msgb_talloc_ctx_init(void *root_ctx, unsigned int pool_size) |
| 203 | { |
| 204 | if (!pool_size) |
| 205 | tall_msgb_ctx = talloc_size(root_ctx, 0); |
| 206 | else |
| 207 | tall_msgb_ctx = talloc_pool(root_ctx, pool_size); |
| 208 | talloc_set_name_const(tall_msgb_ctx, "msgb"); |
| 209 | return tall_msgb_ctx; |
| 210 | } |
| 211 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 212 | /*! Copy an msgb. |
Jacob Erlbeck | cdd05f0 | 2015-11-27 13:26:13 +0100 | [diff] [blame] | 213 | * |
| 214 | * This function allocates a new msgb, copies the data buffer of msg, |
| 215 | * and adjusts the pointers (incl l1h-l4h) accordingly. The cb part |
| 216 | * is not copied. |
| 217 | * \param[in] msg The old msgb object |
| 218 | * \param[in] name Human-readable name to be associated with msgb |
| 219 | */ |
| 220 | struct msgb *msgb_copy(const struct msgb *msg, const char *name) |
| 221 | { |
| 222 | struct msgb *new_msg; |
| 223 | |
| 224 | new_msg = msgb_alloc(msg->data_len, name); |
| 225 | if (!new_msg) |
| 226 | return NULL; |
| 227 | |
| 228 | /* copy data */ |
| 229 | memcpy(new_msg->_data, msg->_data, new_msg->data_len); |
| 230 | |
| 231 | /* copy header */ |
| 232 | new_msg->len = msg->len; |
| 233 | new_msg->data += msg->data - msg->_data; |
| 234 | new_msg->head += msg->head - msg->_data; |
| 235 | new_msg->tail += msg->tail - msg->_data; |
| 236 | |
| 237 | if (msg->l1h) |
| 238 | new_msg->l1h = new_msg->_data + (msg->l1h - msg->_data); |
| 239 | if (msg->l2h) |
| 240 | new_msg->l2h = new_msg->_data + (msg->l2h - msg->_data); |
| 241 | if (msg->l3h) |
| 242 | new_msg->l3h = new_msg->_data + (msg->l3h - msg->_data); |
| 243 | if (msg->l4h) |
| 244 | new_msg->l4h = new_msg->_data + (msg->l4h - msg->_data); |
| 245 | |
| 246 | return new_msg; |
| 247 | } |
| 248 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 249 | /*! Resize an area within an msgb |
Jacob Erlbeck | cdd05f0 | 2015-11-27 13:26:13 +0100 | [diff] [blame] | 250 | * |
| 251 | * This resizes a sub area of the msgb data and adjusts the pointers (incl |
| 252 | * l1h-l4h) accordingly. The cb part is not updated. If the area is extended, |
| 253 | * the contents of the extension is undefined. The complete sub area must be a |
| 254 | * part of [data,tail]. |
| 255 | * |
| 256 | * \param[inout] msg The msgb object |
| 257 | * \param[in] area A pointer to the sub-area |
| 258 | * \param[in] old_size The old size of the sub-area |
| 259 | * \param[in] new_size The new size of the sub-area |
| 260 | * \returns 0 on success, -1 if there is not enough space to extend the area |
| 261 | */ |
| 262 | int msgb_resize_area(struct msgb *msg, uint8_t *area, |
| 263 | int old_size, int new_size) |
| 264 | { |
| 265 | int rc; |
| 266 | uint8_t *post_start = area + old_size; |
| 267 | int pre_len = area - msg->data; |
| 268 | int post_len = msg->len - old_size - pre_len; |
| 269 | int delta_size = new_size - old_size; |
| 270 | |
| 271 | if (old_size < 0 || new_size < 0) |
| 272 | MSGB_ABORT(msg, "Negative sizes are not allowed\n"); |
| 273 | if (area < msg->data || post_start > msg->tail) |
| 274 | MSGB_ABORT(msg, "Sub area is not fully contained in the msg data\n"); |
| 275 | |
| 276 | if (delta_size == 0) |
| 277 | return 0; |
| 278 | |
| 279 | if (delta_size > 0) { |
| 280 | rc = msgb_trim(msg, msg->len + delta_size); |
| 281 | if (rc < 0) |
| 282 | return rc; |
| 283 | } |
| 284 | |
| 285 | memmove(area + new_size, area + old_size, post_len); |
| 286 | |
| 287 | if (msg->l1h >= post_start) |
| 288 | msg->l1h += delta_size; |
| 289 | if (msg->l2h >= post_start) |
| 290 | msg->l2h += delta_size; |
| 291 | if (msg->l3h >= post_start) |
| 292 | msg->l3h += delta_size; |
| 293 | if (msg->l4h >= post_start) |
| 294 | msg->l4h += delta_size; |
| 295 | |
| 296 | if (delta_size < 0) |
| 297 | msgb_trim(msg, msg->len + delta_size); |
| 298 | |
| 299 | return 0; |
| 300 | } |
| 301 | |
| 302 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 303 | /*! Return a (static) buffer containing a hexdump of the msg |
Jacob Erlbeck | baa225e | 2014-02-28 15:14:40 +0100 | [diff] [blame] | 304 | * \param[in] msg message buffer |
| 305 | * \returns a pointer to a static char array |
| 306 | */ |
| 307 | const char *msgb_hexdump(const struct msgb *msg) |
| 308 | { |
| 309 | static char buf[4100]; |
| 310 | int buf_offs = 0; |
| 311 | int nchars; |
| 312 | const unsigned char *start = msg->data; |
| 313 | const unsigned char *lxhs[4]; |
| 314 | int i; |
| 315 | |
| 316 | lxhs[0] = msg->l1h; |
| 317 | lxhs[1] = msg->l2h; |
| 318 | lxhs[2] = msg->l3h; |
| 319 | lxhs[3] = msg->l4h; |
| 320 | |
| 321 | for (i = 0; i < ARRAY_SIZE(lxhs); i++) { |
| 322 | if (!lxhs[i]) |
| 323 | continue; |
| 324 | |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 325 | if (lxhs[i] < msg->head) |
| 326 | continue; |
| 327 | if (lxhs[i] > msg->head + msg->data_len) |
| 328 | continue; |
Jacob Erlbeck | baa225e | 2014-02-28 15:14:40 +0100 | [diff] [blame] | 329 | if (lxhs[i] > msg->tail) |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 330 | continue; |
| 331 | if (lxhs[i] < msg->data || lxhs[i] > msg->tail) { |
| 332 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
Neels Hofmeyr | 42fff58 | 2015-12-23 15:12:40 +0100 | [diff] [blame] | 333 | "(L%d=data%+" PRIdPTR ") ", |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 334 | i+1, lxhs[i] - msg->data); |
| 335 | buf_offs += nchars; |
| 336 | continue; |
| 337 | } |
| 338 | if (lxhs[i] < start) { |
| 339 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
Neels Hofmeyr | 42fff58 | 2015-12-23 15:12:40 +0100 | [diff] [blame] | 340 | "(L%d%+" PRIdPTR ") ", i+1, |
| 341 | start - lxhs[i]); |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 342 | buf_offs += nchars; |
| 343 | continue; |
| 344 | } |
Jacob Erlbeck | baa225e | 2014-02-28 15:14:40 +0100 | [diff] [blame] | 345 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
| 346 | "%s[L%d]> ", |
| 347 | osmo_hexdump(start, lxhs[i] - start), |
| 348 | i+1); |
| 349 | if (nchars < 0 || nchars + buf_offs >= sizeof(buf)) |
| 350 | return "ERROR"; |
| 351 | |
| 352 | buf_offs += nchars; |
| 353 | start = lxhs[i]; |
| 354 | } |
| 355 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
| 356 | "%s", osmo_hexdump(start, msg->tail - start)); |
| 357 | if (nchars < 0 || nchars + buf_offs >= sizeof(buf)) |
| 358 | return "ERROR"; |
| 359 | |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 360 | buf_offs += nchars; |
Jacob Erlbeck | baa225e | 2014-02-28 15:14:40 +0100 | [diff] [blame] | 361 | |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 362 | for (i = 0; i < ARRAY_SIZE(lxhs); i++) { |
| 363 | if (!lxhs[i]) |
| 364 | continue; |
| 365 | |
| 366 | if (lxhs[i] < msg->head || lxhs[i] > msg->head + msg->data_len) { |
| 367 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
| 368 | "(L%d out of range) ", i+1); |
| 369 | } else if (lxhs[i] <= msg->data + msg->data_len && |
| 370 | lxhs[i] > msg->tail) { |
| 371 | nchars = snprintf(buf + buf_offs, sizeof(buf) - buf_offs, |
Neels Hofmeyr | 42fff58 | 2015-12-23 15:12:40 +0100 | [diff] [blame] | 372 | "(L%d=tail%+" PRIdPTR ") ", |
Jacob Erlbeck | 86ec311 | 2015-11-27 13:26:14 +0100 | [diff] [blame] | 373 | i+1, lxhs[i] - msg->tail); |
| 374 | } else |
| 375 | continue; |
| 376 | |
| 377 | if (nchars < 0 || nchars + buf_offs >= sizeof(buf)) |
| 378 | return "ERROR"; |
| 379 | buf_offs += nchars; |
| 380 | } |
| 381 | |
Jacob Erlbeck | baa225e | 2014-02-28 15:14:40 +0100 | [diff] [blame] | 382 | return buf; |
| 383 | } |
| 384 | |
Philipp Maier | c5b47cc | 2017-10-10 16:53:21 +0200 | [diff] [blame] | 385 | |
| 386 | /*! Print a string to the end of message buffer. |
| 387 | * \param[in] msg message buffer |
| 388 | * \returns 0 on success, -EINVAL on error |
| 389 | * |
| 390 | * The resulting string is printed to the msgb without a trailing nul |
| 391 | * character. A nul following the data tail may be written as an implementation |
| 392 | * detail, but a trailing nul is never part of the msgb data in terms of |
| 393 | * msgb_length(). |
| 394 | * |
| 395 | * Note: the tailroom must always be one byte longer than the string to be |
| 396 | * written. The msgb is filled only up to tailroom=1. This is an implementation |
| 397 | * detail that allows leaving a nul character behind the valid data. |
| 398 | * |
| 399 | * In case of error, the msgb remains unchanged, though data may have been |
| 400 | * written to the (unused) memory after the tail pointer. |
| 401 | */ |
| 402 | int msgb_printf(struct msgb *msgb, const char *format, ...) |
| 403 | { |
| 404 | va_list args; |
| 405 | int str_len; |
| 406 | int rc = 0; |
| 407 | |
| 408 | OSMO_ASSERT(msgb); |
| 409 | OSMO_ASSERT(format); |
| 410 | |
| 411 | /* Regardless of what we plan to add to the buffer, we must at least |
| 412 | * be able to store a string terminator (nullstring) */ |
| 413 | if (msgb_tailroom(msgb) < 1) |
| 414 | return -EINVAL; |
| 415 | |
| 416 | va_start(args, format); |
| 417 | |
| 418 | str_len = |
| 419 | vsnprintf((char *)msgb->tail, msgb_tailroom(msgb), format, args); |
| 420 | |
| 421 | if (str_len >= msgb_tailroom(msgb) || str_len < 0) { |
| 422 | rc = -EINVAL; |
| 423 | } else |
| 424 | msgb_put(msgb, str_len); |
| 425 | |
| 426 | va_end(args); |
| 427 | return rc; |
| 428 | } |
| 429 | |
Sylvain Munaut | dca7d2c | 2012-04-18 21:53:23 +0200 | [diff] [blame] | 430 | /*! @} */ |