libosmocore  1.7.0
Osmocom core library
msgb.h
Go to the documentation of this file.
1 #pragma once
2 
3 /* (C) 2008 by Harald Welte <laforge@gnumonks.org>
4  * All Rights Reserved
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  */
17 
18 #include <stdint.h>
19 #include <osmocom/core/linuxlist.h>
20 #include <osmocom/core/utils.h>
21 #include <osmocom/core/bits.h>
22 #include <osmocom/core/defs.h>
23 
28 #define MSGB_DEBUG
29 
31 struct msgb {
32  struct llist_head list;
35  /* Part of which TRX logical channel we were received / transmitted */
36  /* FIXME: move them into the control buffer */
37  union {
38  void *dst;
39  struct gsm_bts_trx *trx;
40  };
41  struct gsm_lchan *lchan;
43  unsigned char *l1h;
44  unsigned char *l2h;
45  unsigned char *l3h;
46  unsigned char *l4h;
48  unsigned long cb[5];
50  uint16_t data_len;
51  uint16_t len;
53  unsigned char *head;
54  unsigned char *tail;
55  unsigned char *data;
56  unsigned char _data[0];
57 };
58 
59 extern struct msgb *msgb_alloc_c(const void *ctx, uint16_t size, const char *name);
60 extern struct msgb *msgb_alloc(uint16_t size, const char *name);
61 extern void msgb_free(struct msgb *m);
62 extern void msgb_enqueue(struct llist_head *queue, struct msgb *msg);
63 extern struct msgb *msgb_dequeue(struct llist_head *queue);
64 extern void msgb_reset(struct msgb *m);
65 uint16_t msgb_length(const struct msgb *msg);
66 extern const char *msgb_hexdump(const struct msgb *msg);
67 char *msgb_hexdump_buf(char *buf, size_t buf_len, const struct msgb *msg);
68 char *msgb_hexdump_c(const void *ctx, const struct msgb *msg);
69 extern int msgb_resize_area(struct msgb *msg, uint8_t *area,
70  int old_size, int new_size);
71 extern struct msgb *msgb_copy(const struct msgb *msg, const char *name);
72 extern struct msgb *msgb_copy_c(const void *ctx, const struct msgb *msg, const char *name);
73 static int msgb_test_invariant(const struct msgb *msg) __attribute__((pure));
74 
78 static inline void msgb_queue_free(struct llist_head *queue)
79 {
80  struct msgb *msg;
81  while ((msg = msgb_dequeue(queue))) msgb_free(msg);
82 }
83 
93 static inline void msgb_enqueue_count(struct llist_head *queue, struct msgb *msg,
94  unsigned int *count)
95 {
96  msgb_enqueue(queue, msg);
97  (*count)++;
98 }
99 
109 static inline struct msgb *msgb_dequeue_count(struct llist_head *queue,
110  unsigned int *count)
111 {
112  struct msgb *msg = msgb_dequeue(queue);
113  if (msg)
114  (*count)--;
115  return msg;
116 }
117 
118 #ifdef MSGB_DEBUG
119 #include <osmocom/core/panic.h>
120 #define MSGB_ABORT(msg, fmt, args ...) do { \
121  osmo_panic("msgb(%p): " fmt, msg, ## args); \
122  } while(0)
123 #else
124 #define MSGB_ABORT(msg, fmt, args ...)
125 #endif
126 
128 #define msgb_l1(m) ((void *)(m->l1h))
129 
130 #define msgb_l2(m) ((void *)(m->l2h))
131 
132 #define msgb_l3(m) ((void *)(m->l3h))
133 
134 #define msgb_l4(m) ((void *)(m->l4h))
135 
136 #define msgb_sms(m) msgb_l4(m)
137 
145 static inline unsigned int msgb_l1len(const struct msgb *msgb)
146 {
147  return msgb->tail - (uint8_t *)msgb_l1(msgb);
148 }
149 
157 static inline unsigned int msgb_l2len(const struct msgb *msgb)
158 {
159  return msgb->tail - (uint8_t *)msgb_l2(msgb);
160 }
161 
169 static inline unsigned int msgb_l3len(const struct msgb *msgb)
170 {
171  return msgb->tail - (uint8_t *)msgb_l3(msgb);
172 }
173 
181 static inline unsigned int msgb_l4len(const struct msgb *msgb)
182 {
183  return msgb->tail - (uint8_t *)msgb_sms(msgb);
184 }
185 
193 static inline unsigned int msgb_headlen(const struct msgb *msgb)
194 {
195  return msgb->len - msgb->data_len;
196 }
197 
205 static inline int msgb_tailroom(const struct msgb *msgb)
206 {
207  return (msgb->head + msgb->data_len) - msgb->tail;
208 }
209 
217 static inline int msgb_headroom(const struct msgb *msgb)
218 {
219  return (msgb->data - msgb->head);
220 }
221 
234 static inline unsigned char *msgb_put(struct msgb *msgb, unsigned int len)
235 {
236  unsigned char *tmp = msgb->tail;
237  if (OSMO_UNLIKELY(msgb_tailroom(msgb) < (int) len))
238  MSGB_ABORT(msgb, "Not enough tailroom msgb_put"
239  " (allocated %u, head at %u, len %u, tailroom %u < want tailroom %u)\n",
240  msgb->data_len - sizeof(struct msgb),
241  msgb->head - msgb->_data,
242  msgb->len,
243  msgb_tailroom(msgb), len);
244  msgb->tail += len;
245  msgb->len += len;
246  return tmp;
247 }
248 
253 static inline void msgb_put_u8(struct msgb *msgb, uint8_t word)
254 {
255  uint8_t *space = msgb_put(msgb, 1);
256  space[0] = word & 0xFF;
257 }
258 
263 static inline void msgb_put_u16(struct msgb *msgb, uint16_t word)
264 {
265  uint8_t *space = msgb_put(msgb, 2);
266  osmo_store16be(word, space);
267 }
268 
273 static inline void msgb_put_u32(struct msgb *msgb, uint32_t word)
274 {
275  uint8_t *space = msgb_put(msgb, 4);
276  osmo_store32be(word, space);
277 }
278 
283 static inline unsigned char *msgb_get(struct msgb *msgb, unsigned int len)
284 {
285  if (OSMO_UNLIKELY(msgb_length(msgb) < len))
286  MSGB_ABORT(msgb, "msgb too small to get %u (len %u)\n",
287  len, msgb_length(msgb));
288  msgb->tail -= len;
289  msgb->len -= len;
290  return msgb->tail;
291 }
292 
297 static inline uint8_t msgb_get_u8(struct msgb *msgb)
298 {
299  uint8_t *space = msgb_get(msgb, 1);
300  return space[0];
301 }
302 
307 static inline uint16_t msgb_get_u16(struct msgb *msgb)
308 {
309  uint8_t *space = msgb_get(msgb, 2);
310  return osmo_load16be(space);
311 }
312 
317 static inline uint32_t msgb_get_u32(struct msgb *msgb)
318 {
319  uint8_t *space = msgb_get(msgb, 4);
320  return osmo_load32be(space);
321 }
322 
335 static inline unsigned char *msgb_push(struct msgb *msgb, unsigned int len)
336 {
337  if (OSMO_UNLIKELY(msgb_headroom(msgb) < (int) len))
338  MSGB_ABORT(msgb, "Not enough headroom msgb_push"
339  " (allocated %u, head at %u < want headroom %u, len %u, tailroom %u)\n",
340  msgb->data_len - sizeof(struct msgb),
341  msgb->head - msgb->_data,
342  len,
343  msgb->len,
344  msgb_tailroom(msgb));
345  msgb->data -= len;
346  msgb->len += len;
347  return msgb->data;
348 }
349 
354 static inline void msgb_push_u8(struct msgb *msg, uint8_t word)
355 {
356  uint8_t *space = msgb_push(msg, 1);
357  space[0] = word;
358 }
359 
364 static inline void msgb_push_u16(struct msgb *msg, uint16_t word)
365 {
366  uint16_t *space = (uint16_t *) msgb_push(msg, 2);
367  osmo_store16be(word, space);
368 }
369 
374 static inline void msgb_push_u32(struct msgb *msg, uint32_t word)
375 {
376  uint32_t *space = (uint32_t *) msgb_push(msg, 4);
377  osmo_store32be(word, space);
378 }
379 
380 static inline unsigned char *msgb_push_tl(struct msgb *msgb, uint8_t tag)
381 {
382  uint8_t *data = msgb_push(msgb, 2);
383 
384  data[0] = tag;
385  data[1] = msgb->len - 2;
386  return data;
387 }
388 
398 static inline unsigned char *msgb_pull(struct msgb *msgb, unsigned int len)
399 {
400  if (OSMO_UNLIKELY(msgb_length(msgb) < len))
401  MSGB_ABORT(msgb, "msgb too small to pull %u (len %u)\n",
402  len, msgb_length(msgb));
403  msgb->len -= len;
404  return msgb->data += len;
405 }
406 
415 static inline unsigned char *msgb_pull_to_l3(struct msgb *msg)
416 {
417  unsigned char *ret = msgb_pull(msg, msg->l3h - msg->data);
418  msg->l1h = msg->l2h = NULL;
419  return ret;
420 }
421 
430 static inline unsigned char *msgb_pull_to_l2(struct msgb *msg)
431 {
432  unsigned char *ret = msgb_pull(msg, msg->l2h - msg->data);
433  msg->l1h = NULL;
434  return ret;
435 }
436 
441 static inline uint8_t msgb_pull_u8(struct msgb *msgb)
442 {
443  uint8_t *space = msgb_pull(msgb, 1) - 1;
444  return space[0];
445 }
446 
451 static inline uint16_t msgb_pull_u16(struct msgb *msgb)
452 {
453  uint8_t *space = msgb_pull(msgb, 2) - 2;
454  return osmo_load16be(space);
455 }
456 
461 static inline uint32_t msgb_pull_u32(struct msgb *msgb)
462 {
463  uint8_t *space = msgb_pull(msgb, 4) - 4;
464  return osmo_load32be(space);
465 }
466 
478 static inline void msgb_reserve(struct msgb *msg, int len)
479 {
480  msg->data += len;
481  msg->tail += len;
482 }
483 
489 static inline int msgb_trim(struct msgb *msg, int len)
490 {
491  if (OSMO_UNLIKELY(len < 0))
492  MSGB_ABORT(msg, "Negative length is not allowed\n");
493  if (OSMO_UNLIKELY(len > msg->data_len))
494  return -1;
495 
496  msg->len = len;
497  msg->tail = msg->data + len;
498 
499  return 0;
500 }
501 
507 static inline int msgb_l3trim(struct msgb *msg, int l3len)
508 {
509  return msgb_trim(msg, (msg->l3h - msg->data) + l3len);
510 }
511 
523 static inline struct msgb *msgb_alloc_headroom_c(const void *ctx, uint16_t size, uint16_t headroom,
524  const char *name)
525 {
526  osmo_static_assert(size >= headroom, headroom_bigger);
527 
528  struct msgb *msg = msgb_alloc_c(ctx, size, name);
529  if (OSMO_LIKELY(msg))
530  msgb_reserve(msg, headroom);
531  return msg;
532 }
533 
534 
545 static inline struct msgb *msgb_alloc_headroom(uint16_t size, uint16_t headroom,
546  const char *name)
547 {
548  osmo_static_assert(size >= headroom, headroom_bigger);
549 
550  struct msgb *msg = msgb_alloc(size, name);
551  if (OSMO_LIKELY(msg))
552  msgb_reserve(msg, headroom);
553  return msg;
554 }
555 
560 static inline int msgb_test_invariant(const struct msgb *msg)
561 {
562  const unsigned char *lbound;
563  if (!msg || !msg->data || !msg->tail ||
564  (msg->data + msg->len != msg->tail) ||
565  (msg->data < msg->head) ||
566  (msg->tail > msg->head + msg->data_len))
567  return 0;
568 
569  lbound = msg->head;
570 
571  if (msg->l1h) {
572  if (msg->l1h < lbound)
573  return 0;
574  lbound = msg->l1h;
575  }
576  if (msg->l2h) {
577  if (msg->l2h < lbound)
578  return 0;
579  lbound = msg->l2h;
580  }
581  if (msg->l3h) {
582  if (msg->l3h < lbound)
583  return 0;
584  lbound = msg->l3h;
585  }
586  if (msg->l4h) {
587  if (msg->l4h < lbound)
588  return 0;
589  lbound = msg->l4h;
590  }
591 
592  return lbound <= msg->head + msg->data_len;
593 }
594 
595 
596 /* msgb data comparison helpers */
597 
604 #define msgb_eq_data(msg, data, len) \
605  _msgb_eq(__FILE__, __LINE__, __func__, 0, msg, data, len, false)
606 
613 #define msgb_eq_l1_data(msg, data, len) \
614  _msgb_eq(__FILE__, __LINE__, __func__, 1, msg, data, len, false)
615 
622 #define msgb_eq_l2_data(msg, data, len) \
623  _msgb_eq(__FILE__, __LINE__, __func__, 2, msg, data, len, false)
624 
631 #define msgb_eq_l3_data(msg, data, len) \
632  _msgb_eq(__FILE__, __LINE__, __func__, 3, msg, data, len, false)
633 
640 #define msgb_eq_l4_data(msg, data, len) \
641  _msgb_eq(__FILE__, __LINE__, __func__, 4, msg, data, len, false)
642 
643 
644 /* msgb test/debug helpers */
645 
652 #define msgb_eq_data_print(msg, data, len) \
653  _msgb_eq(__FILE__, __LINE__, __func__, 0, msg, data, len, true)
654 
661 #define msgb_eq_l1_data_print(msg, data, len) \
662  _msgb_eq(__FILE__, __LINE__, __func__, 1, msg, data, len, true)
663 
670 #define msgb_eq_l2_data_print(msg, data, len) \
671  _msgb_eq(__FILE__, __LINE__, __func__, 2, msg, data, len, true)
672 
679 #define msgb_eq_l3_data_print(msg, data, len) \
680  _msgb_eq(__FILE__, __LINE__, __func__, 3, msg, data, len, true)
681 
682 
689 #define msgb_eq_l4_data_print(msg, data, len) \
690  _msgb_eq(__FILE__, __LINE__, __func__, 4, msg, data, len, true)
691 
692 bool _msgb_eq(const char *file, size_t line, const char *func, uint8_t level,
693  const struct msgb *msg, const uint8_t *data, size_t len, bool print);
694 
695 
696 /* msgb data comparison */
697 
703 #define msgb_eq(msg1, msg2) msgb_eq_data(msg1, msgb_data(msg2), msgb_length(msg2))
704 
710 #define msgb_eq_l1(msg1, msg2) msgb_eq_l1_data(msg1, msgb_l1(msg2), msgb_l1len(msg2))
711 
717 #define msgb_eq_l2(msg1, msg2) msgb_eq_l2_data(msg1, msgb_l2(msg2), msgb_l2len(msg2))
718 
724 #define msgb_eq_l3(msg1, msg2) msgb_eq_l3_data(msg1, msgb_l3(msg2), msgb_l3len(msg2))
725 
731 #define msgb_eq_l4(msg1, msg2) msgb_eq_l4_data(msg1, msgb_l4(msg2), msgb_l4len(msg2))
732 
733 
734 /* non inline functions to ease binding */
735 
736 uint8_t *msgb_data(const struct msgb *msg);
737 
738 void *msgb_talloc_ctx_init(void *root_ctx, unsigned int pool_size);
739 void msgb_set_talloc_ctx(void *ctx) OSMO_DEPRECATED("Use msgb_talloc_ctx_init() instead");
740 int msgb_printf(struct msgb *msgb, const char *format, ...);
741 
742 static inline const char *msgb_hexdump_l1(const struct msgb *msg)
743 {
744  if (!msgb_l1(msg) || !(msgb_l1len(msg)))
745  return "[]";
746  return osmo_hexdump((const unsigned char *) msgb_l1(msg), msgb_l1len(msg));
747 }
748 
749 static inline const char *msgb_hexdump_l2(const struct msgb *msg)
750 {
751  if (!msgb_l2(msg) || !(msgb_l2len(msg)))
752  return "[]";
753  return osmo_hexdump((const unsigned char *) msgb_l2(msg), msgb_l2len(msg));
754 }
755 
756 static inline const char *msgb_hexdump_l3(const struct msgb *msg)
757 {
758  if (!msgb_l3(msg) || !(msgb_l3len(msg)))
759  return "[]";
760  return osmo_hexdump((const unsigned char*) msgb_l3(msg), msgb_l3len(msg));
761 }
762 
763 static inline const char *msgb_hexdump_l4(const struct msgb *msg)
764 {
765  if (!msgb_l4(msg) || !(msgb_l4len(msg)))
766  return "[]";
767  return osmo_hexdump((const unsigned char*) msgb_l4(msg), msgb_l4len(msg));
768 }
769 
#define msgb_l4(m)
obtain L4 header of msgb
Definition: msgb.h:134
static unsigned char * msgb_put(struct msgb *msgb, unsigned int len)
append data to end of message buffer
Definition: msgb.h:234
static const char * msgb_hexdump_l4(const struct msgb *msg)
Definition: msgb.h:763
static uint16_t msgb_pull_u16(struct msgb *msgb)
remove uint16 from front of message
Definition: msgb.h:451
static unsigned int msgb_l3len(const struct msgb *msgb)
determine length of L3 message
Definition: msgb.h:169
unsigned long cb[5]
control buffer
Definition: msgb.h:48
#define OSMO_DEPRECATED(text)
Set the deprecated attribute with a message.
Definition: defs.h:41
unsigned char * l3h
pointer to Layer 3 header.
Definition: msgb.h:45
struct gsm48_classmark3 __attribute__
fls64 - find last set bit in a 64-bit word : the word to search
Definition: log2.h:61
#define msgb_l3(m)
obtain L3 header of msgb
Definition: msgb.h:132
#define msgb_l1(m)
obtain L1 header of msgb
Definition: msgb.h:128
struct msgb * msgb_alloc(uint16_t size, const char *name)
Allocate a new message buffer from tall_msgb_ctx.
Definition: msgb.c:108
struct msgb * msgb_copy_c(const void *ctx, const struct msgb *msg, const char *name)
Copy an msgb.
Definition: msgb.c:325
struct msgb * msgb_alloc_c(const void *ctx, uint16_t size, const char *name)
Allocate a new message buffer from given talloc context.
Definition: msgb.c:73
unsigned char * data
start of message in buffer
Definition: msgb.h:55
static const char * msgb_hexdump_l2(const struct msgb *msg)
Definition: msgb.h:749
Osmocom message buffer.
Definition: msgb.h:31
static const char * msgb_hexdump_l1(const struct msgb *msg)
Definition: msgb.h:742
void msgb_set_talloc_ctx(void *ctx) OSMO_DEPRECATED("Use msgb_talloc_ctx_init() instead")
Set the talloc context for msgb_alloc Deprecated, use msgb_talloc_ctx_init() instead.
Definition: msgb.c:294
static const char * msgb_hexdump_l3(const struct msgb *msg)
Definition: msgb.h:756
#define msgb_sms(m)
obtain SMS header of msgb
Definition: msgb.h:136
static int msgb_l3trim(struct msgb *msg, int l3len)
Trim the msgb to a given layer3 length.
Definition: msgb.h:507
General definitions that are meant to be included from header files.
static unsigned char * msgb_push_tl(struct msgb *msgb, uint8_t tag)
Definition: msgb.h:380
static int msgb_trim(struct msgb *msg, int len)
Trim the msgb to a given absolute length.
Definition: msgb.h:489
write Write running configuration to or terminal n Write configuration to the file(same as write file)\n") ALIAS(config_write_file
static unsigned int msgb_l4len(const struct msgb *msgb)
determine length of L4 message
Definition: msgb.h:181
uint16_t len
length of bytes used in msgb
Definition: msgb.h:51
char name[32]
source file name
Definition: gsmtap.h:131
static unsigned char * msgb_pull_to_l3(struct msgb *msg)
remove (pull) all headers in front of l3h from the message buffer.
Definition: msgb.h:415
#define osmo_static_assert(exp, name)
Definition: utils.h:82
void msgb_free(struct msgb *m)
Release given message buffer.
Definition: msgb.c:117
static int msgb_tailroom(const struct msgb *msgb)
determine how much tail room is left in msgb
Definition: msgb.h:205
uint8_t level
logging level
Definition: gsmtap.h:126
unsigned char * l4h
pointer to layer 4 header
Definition: msgb.h:46
static struct msgb * msgb_dequeue_count(struct llist_head *queue, unsigned int *count)
Dequeue message buffer from head of queue and decrement queue size counter.
Definition: msgb.h:109
static uint16_t osmo_load16be(const void *p)
load unaligned 16-bit integer (big-endian encoding)
Definition: bit16gen.h:108
static unsigned int msgb_l1len(const struct msgb *msgb)
determine length of L1 message
Definition: msgb.h:145
static unsigned char * msgb_get(struct msgb *msgb, unsigned int len)
remove data from end of message
Definition: msgb.h:283
const char * msgb_hexdump(const struct msgb *msg)
Return a (static) buffer containing a hexdump of the msg.
Definition: msgb.c:508
static void msgb_push_u8(struct msgb *msg, uint8_t word)
prepend a uint8 value to the head of the message
Definition: msgb.h:354
struct msgb * msgb_dequeue(struct llist_head *queue)
Dequeue message buffer from head of queue.
Definition: msgb.c:141
static void msgb_queue_free(struct llist_head *queue)
Free all msgbs from a queue built with msgb_enqueue().
Definition: msgb.h:78
void * msgb_talloc_ctx_init(void *root_ctx, unsigned int pool_size)
Initialize a msgb talloc context for msgb_alloc.
Definition: msgb.c:307
int msgb_resize_area(struct msgb *msg, uint8_t *area, int old_size, int new_size)
Resize an area within an msgb.
Definition: msgb.c:380
static uint32_t msgb_pull_u32(struct msgb *msgb)
remove uint32 from front of message
Definition: msgb.h:461
static unsigned int msgb_l2len(const struct msgb *msgb)
determine length of L2 message
Definition: msgb.h:157
char * msgb_hexdump_c(const void *ctx, const struct msgb *msg)
Return a dynamically allocated buffer containing a hexdump of the msg.
Definition: msgb.c:519
static unsigned char * msgb_push(struct msgb *msgb, unsigned int len)
prepend (push) some data to start of message
Definition: msgb.h:335
static struct msgb * msgb_alloc_headroom_c(const void *ctx, uint16_t size, uint16_t headroom, const char *name)
Allocate message buffer with specified headroom from specified talloc context.
Definition: msgb.h:523
Simple doubly linked list implementation.
char * msgb_hexdump_buf(char *buf, size_t buf_len, const struct msgb *msg)
fill user-provided buffer with hexdump of the msg.
Definition: msgb.c:427
struct gsm_bts_trx * trx
Definition: msgb.h:39
bool _msgb_eq(const char *file, size_t line, const char *func, uint8_t level, const struct msgb *msg, const uint8_t *data, size_t len, bool print)
Compare and print: check data in msgb against given data and print errors if any. ...
Definition: msgb.c:202
(double) linked list header structure
Definition: linuxlist.h:46
unsigned char * l1h
pointer to Layer1 header (if any)
Definition: msgb.h:43
#define OSMO_LIKELY(exp)
Branch prediction optimizations.
Definition: utils.h:46
static struct msgb * msgb_alloc_headroom(uint16_t size, uint16_t headroom, const char *name)
Allocate message buffer with specified headroom.
Definition: msgb.h:545
static uint8_t msgb_pull_u8(struct msgb *msgb)
remove uint8 from front of message
Definition: msgb.h:441
void msgb_enqueue(struct llist_head *queue, struct msgb *msg)
Enqueue message buffer to tail of a queue.
Definition: msgb.c:129
struct gsm_lchan * lchan
logical channel
Definition: msgb.h:41
void msgb_reset(struct msgb *m)
Re-set all message buffer pointers.
Definition: msgb.c:164
static void msgb_push_u32(struct msgb *msg, uint32_t word)
prepend a uint32 value to the head of the message
Definition: msgb.h:374
static void msgb_reserve(struct msgb *msg, int len)
Increase headroom of empty msgb, reducing the tailroom.
Definition: msgb.h:478
unsigned char * tail
end of message in buffer
Definition: msgb.h:54
uint8_t msg[0]
int msgb_printf(struct msgb *msgb, const char *format,...)
Print a string to the end of message buffer.
Definition: msgb.c:545
static void msgb_put_u16(struct msgb *msgb, uint16_t word)
append a uint16 value to the end of the message
Definition: msgb.h:263
static uint8_t msgb_get_u8(struct msgb *msgb)
remove uint8 from end of message
Definition: msgb.h:297
#define OSMO_UNLIKELY(exp)
Definition: utils.h:47
unsigned char * l2h
pointer to A-bis layer 2 header: OML, RSL(RLL), NS
Definition: msgb.h:44
struct msgb * msgb_copy(const struct msgb *msg, const char *name)
Copy an msgb.
Definition: msgb.c:362
unsigned char * head
start of underlying memory buffer
Definition: msgb.h:53
static uint32_t msgb_get_u32(struct msgb *msgb)
remove uint32 from end of message
Definition: msgb.h:317
static int msgb_headroom(const struct msgb *msgb)
determine the amount of headroom in msgb
Definition: msgb.h:217
Osmocom bit level support code.
static uint32_t osmo_load32be(const void *p)
load unaligned 32-bit integer (big-endian encoding)
Definition: bit32gen.h:108
uint16_t data_len
length of underlying data array
Definition: msgb.h:50
static void osmo_store16be(uint16_t x, void *p)
store unaligned 16-bit integer (big-endian encoding)
Definition: bit16gen.h:121
unsigned char _data[0]
optional immediate data array
Definition: msgb.h:56
struct llist_head list
linked list header
Definition: msgb.h:32
uint8_t * msgb_data(const struct msgb *msg)
get pointer to data section of message buffer
Definition: msgb.c:184
#define msgb_l2(m)
obtain L2 header of msgb
Definition: msgb.h:130
static void msgb_enqueue_count(struct llist_head *queue, struct msgb *msg, unsigned int *count)
Enqueue message buffer to tail of a queue and increment queue size counter.
Definition: msgb.h:93
static uint16_t msgb_get_u16(struct msgb *msgb)
remove uint16 from end of message
Definition: msgb.h:307
char * osmo_hexdump(const unsigned char *buf, int len)
Convert binary sequence to hexadecimal ASCII string.
Definition: utils.c:392
void * dst
reference of origin/destination
Definition: msgb.h:38
static unsigned int msgb_headlen(const struct msgb *msgb)
determine the length of the header
Definition: msgb.h:193
uint16_t msgb_length(const struct msgb *msg)
get length of message buffer
Definition: msgb.c:285
static int msgb_test_invariant(const struct msgb *msg) __attribute__((pure))
Check a message buffer for consistency.
Definition: msgb.h:560
static void msgb_put_u32(struct msgb *msgb, uint32_t word)
append a uint32 value to the end of the message
Definition: msgb.h:273
#define MSGB_ABORT(msg, fmt, args ...)
Definition: msgb.h:120
static unsigned char * msgb_pull(struct msgb *msgb, unsigned int len)
remove (pull) a header from the front of the message buffer
Definition: msgb.h:398
static void osmo_store32be(uint32_t x, void *p)
store unaligned 32-bit integer (big-endian encoding)
Definition: bit32gen.h:121
static unsigned char * msgb_pull_to_l2(struct msgb *msg)
remove (pull) all headers in front of l2h from the message buffer.
Definition: msgb.h:430
static void msgb_push_u16(struct msgb *msg, uint16_t word)
prepend a uint16 value to the head of the message
Definition: msgb.h:364
static void msgb_put_u8(struct msgb *msgb, uint8_t word)
append a uint8 value to the end of the message
Definition: msgb.h:253