libosmogsm
0.12.0
Osmocom GSM library
|
Go to the documentation of this file.
6 #include <osmocom/core/msgb.h>
7 #include <osmocom/core/bit16gen.h>
8 #include <osmocom/core/bit32gen.h>
28 #define LV_GROSS_LEN(x) (x+1)
30 #define TLV_GROSS_LEN(x) (x+2)
32 #define TLV16_GROSS_LEN(x) ((2*x)+2)
34 #define TL16V_GROSS_LEN(x) (x+3)
36 #define L16TV_GROSS_LEN(x) (x+3)
38 #define T16LV_GROSS_LEN(x) (x+3)
41 #define TVLV_MAX_ONEBYTE 0x7f
85 static inline uint8_t *
lv_put(uint8_t *buf, uint8_t
len,
89 memcpy(buf, val,
len);
100 static inline uint8_t *
tlv_put(uint8_t *buf, uint8_t tag, uint8_t
len,
107 memcpy(buf, val,
len);
115 static inline uint8_t *
tlv16_put(uint8_t *buf, uint8_t tag, uint8_t
len,
120 memcpy(buf, val,
len*2);
125 static inline uint8_t *
tl16v_put(uint8_t *buf, uint8_t tag, uint16_t
len,
131 memcpy(buf, val,
len);
136 static inline uint8_t *
t16lv_put(uint8_t *buf, uint16_t tag, uint8_t
len,
142 memcpy(buf, val,
len);
143 return buf +
len + 2;
147 static inline uint8_t *
tvlv_put(uint8_t *buf, uint8_t tag, uint16_t
len,
162 static inline uint8_t *
vt_gan_put(uint8_t *buf, uint16_t tag)
166 *buf++ = 0x80 | (tag >> 8);
167 *buf++ = (tag & 0xff);
191 memcpy(ret, val,
len);
198 static inline uint8_t *
msgb_tlv16_put(
struct msgb *msg, uint8_t tag, uint8_t
len,
const uint16_t *val)
212 static inline uint8_t *
msgb_t16lv_put(
struct msgb *msg, uint16_t tag, uint8_t
len,
const uint8_t *val)
228 uint16_t
len,
const uint8_t *val)
243 memcpy(buf, val,
len);
248 static inline uint8_t *
v_put(uint8_t *buf, uint8_t val)
255 static inline uint8_t *
tv_put(uint8_t *buf, uint8_t tag,
265 unsigned int len,
const uint8_t *val)
268 memcpy(buf, val,
len);
277 static inline uint8_t *
tv16_put(uint8_t *buf, uint8_t tag,
288 static inline uint8_t *
msgb_lv_put(
struct msgb *msg, uint8_t
len,
const uint8_t *val)
296 static inline uint8_t *
msgb_tlv_put(
struct msgb *msg, uint8_t tag, uint8_t
len,
const uint8_t *val)
304 static inline uint8_t *
msgb_tv_put(
struct msgb *msg, uint8_t tag, uint8_t val)
306 uint8_t *buf = msgb_put(msg, 2);
307 return tv_put(buf, tag, val);
313 unsigned int len,
const uint8_t *val)
315 uint8_t *buf = msgb_put(msg, 1+
len);
321 static inline uint8_t *
msgb_v_put(
struct msgb *msg, uint8_t val)
323 uint8_t *buf = msgb_put(msg, 1);
324 return v_put(buf, val);
329 static inline uint8_t *
msgb_tv16_put(
struct msgb *msg, uint8_t tag, uint16_t val)
331 uint8_t *buf = msgb_put(msg, 3);
337 static inline uint8_t *
msgb_tlv_push(
struct msgb *msg, uint8_t tag, uint8_t
len,
const uint8_t *val)
346 static inline uint8_t *
msgb_tv_push(
struct msgb *msg, uint8_t tag, uint8_t val)
348 uint8_t *buf = msgb_push(msg, 2);
355 static inline uint8_t *
msgb_tv16_push(
struct msgb *msg, uint8_t tag, uint16_t val)
357 uint8_t *buf = msgb_push(msg, 3);
384 uint16_t
len,
const uint8_t *val)
431 int tlv_parse_one(uint8_t *o_tag, uint16_t *o_len,
const uint8_t **o_val,
433 const uint8_t *buf,
int buf_len);
435 const uint8_t *buf,
int buf_len, uint8_t lv_tag, uint8_t lv_tag2);
438 uint8_t lv_tag, uint8_t lv_tag2);
442 #define TLVP_PRESENT(x, y) ((x)->lv[y].val)
443 #define TLVP_LEN(x, y) (x)->lv[y].len
444 #define TLVP_VAL(x, y) (x)->lv[y].val
446 #define TLVP_PRES_LEN(tp, tag, min_len) \
447 (TLVP_PRESENT(tp, tag) && TLVP_LEN(tp, tag) >= min_len)
459 #define TLVP_GET(_tp, tag) (TLVP_PRESENT(_tp, tag)? &(_tp)->lv[tag] : NULL)
467 #define TLVP_GET_MINLEN(_tp, tag, min_len) \
468 (TLVP_PRES_LEN(_tp, tag, min_len)? &(_tp)->lv[tag] : NULL)
476 #define TLVP_VAL_MINLEN(_tp, tag, min_len) \
477 (TLVP_PRES_LEN(_tp, tag, min_len)? (_tp)->lv[tag].val : NULL)
488 memcpy(&res,
TLVP_VAL(tp, pos),
sizeof(res));
500 memcpy(&res,
TLVP_VAL(tp, pos),
sizeof(res));
511 return osmo_load16be(
TLVP_VAL(tp, pos));
521 return osmo_load32be(
TLVP_VAL(tp, pos));
528 size_t len, uint8_t **value);
530 uint8_t tag,
size_t len, uint8_t **value);
532 uint8_t *tag, uint8_t **value,
size_t *value_len);
534 uint8_t tag, uint8_t **value,
size_t *value_len);
536 uint8_t **value,
size_t *value_len);
int tlv_parse_one(uint8_t *o_tag, uint16_t *o_len, const uint8_t **o_val, const struct tlv_definition *def, const uint8_t *buf, int buf_len)
Parse a single TLV encoded IE.
Definition: tlv_parser.c:132
static uint8_t * msgb_l16tv_put(struct msgb *msg, uint16_t len, uint8_t tag, const uint8_t *val)
put (append) a L16TV field to msgb
Definition: tlv.h:235
uint8_t len
Definition: gsm_04_11.h:2
uint8_t data[0]
message payload data
Definition: gsm_03_41.h:34
static uint16_t tlvp_val16be(const struct tlv_parsed *tp, int pos)
Retrieve (possibly unaligned) TLV element and convert to host byte order.
Definition: tlv.h:509
struct tlv_parsed * osmo_tlvp_copy(const struct tlv_parsed *tp_orig, void *ctx)
Copy tlv_parsed using given talloc context.
Definition: tlv_parser.c:69
const uint8_t * val
pointer to value
Definition: tlv.h:396
int osmo_tlvp_merge(struct tlv_parsed *dst, const struct tlv_parsed *src)
Merge all tlv_parsed attributes of 'src' into 'dst'.
Definition: tlv_parser.c:104
void tlv_def_patch(struct tlv_definition *dst, const struct tlv_definition *src)
take a master (src) tlvdev and fill up all empty slots in 'dst'
Definition: tlv_parser.c:340
#define TLV16_GROSS_LEN(x)
gross length of a TLV16 type field
Definition: tlv.h:32
int tlv_parse(struct tlv_parsed *dec, const struct tlv_definition *def, const uint8_t *buf, int buf_len, uint8_t lv_tag, uint8_t lv_tag2)
Parse an entire buffer of TLV encoded Information Elements.
Definition: tlv_parser.c:237
struct tlv_definition tvlv_att_def
Definition: tlv_parser.c:48
int osmo_shift_tlv(uint8_t **data, size_t *data_len, uint8_t *tag, uint8_t **value, size_t *value_len)
Extract TLV and advance data pointer + subtract length.
Definition: tlv_parser.c:463
@ TLV_TYPE_FIXED
fixed-length value-only
Definition: tlv.h:402
uint16_t len
length
Definition: tlv.h:395
static uint8_t * msgb_v_put(struct msgb *msg, uint8_t val)
put (append) a V field to a msgb
Definition: tlv.h:321
static uint8_t * msgb_tv16_put(struct msgb *msg, uint8_t tag, uint16_t val)
put (append) a TV16 field to a msgb
Definition: tlv.h:329
#define LV_GROSS_LEN(x)
gross length of a LV type field
Definition: tlv.h:28
@ TLV_TYPE_T
tag-only
Definition: tlv.h:403
int tlv_parse2(struct tlv_parsed *dec, int dec_multiples, const struct tlv_definition *def, const uint8_t *buf, int buf_len, uint8_t lv_tag, uint8_t lv_tag2)
Like tlv_parse(), but capable of decoding multiple occurences of the same IE.
Definition: tlv_parser.c:260
static uint8_t * msgb_vtvl_gan_push(struct msgb *msg, uint16_t tag, uint16_t len)
Definition: tlv.h:374
static uint8_t * vt_gan_put(uint8_t *buf, uint16_t tag)
put (append) a variable-length tag or variable-length length *
Definition: tlv.h:162
static uint16_t VTVLV_GAN_GROSS_LEN(uint16_t tag, uint16_t len)
gross length of vTvLV (tag+len+val)
Definition: tlv.h:67
static uint8_t * msgb_tv16_push(struct msgb *msg, uint8_t tag, uint16_t val)
push (prepend) a TV16 field to a msgb
Definition: tlv.h:355
#define TL16V_GROSS_LEN(x)
gross length of a TL16V type field
Definition: tlv.h:34
static uint8_t * msgb_lv_put(struct msgb *msg, uint8_t len, const uint8_t *val)
put (append) a LV field to a msgb
Definition: tlv.h:288
Entry in a TLV parser array.
Definition: tlv.h:394
struct tlv_p_entry lv[256]
Definition: tlv.h:425
static uint32_t tlvp_val32be(const struct tlv_parsed *tp, int pos)
Retrieve (possibly unaligned) TLV element and convert to host byte order.
Definition: tlv.h:519
@ TLV_TYPE_TLV
tag-length-value
Definition: tlv.h:405
static uint8_t * tv_fixed_put(uint8_t *buf, uint8_t tag, unsigned int len, const uint8_t *val)
put (append) a TVfixed field
Definition: tlv.h:264
static uint16_t TVLV_GROSS_LEN(uint16_t len)
gross length of a TVLV type field
Definition: tlv.h:44
@ TLV_TYPE_TvLV
tag, variable length, value
Definition: tlv.h:407
static uint16_t tlvp_val16_unal(const struct tlv_parsed *tp, int pos)
Align given TLV element with 16 bit value to an even address.
Definition: tlv.h:485
Definition of All 256 IE / TLV.
Definition: tlv.h:419
static uint8_t * t16lv_put(uint8_t *buf, uint16_t tag, uint8_t len, const uint8_t *val)
put (append) a TL16V field
Definition: tlv.h:136
static uint8_t * tlv_put(uint8_t *buf, uint8_t tag, uint8_t len, const uint8_t *val)
Append a TLV field, a Tag-Length-Value field.
Definition: tlv.h:100
enum tlv_type type
TLV type.
Definition: tlv.h:414
static uint8_t * msgb_vtvlv_gan_put(struct msgb *msg, uint16_t tag, uint16_t len, const uint8_t *val)
put (append) a vTvLV field to msgb
Definition: tlv.h:227
static uint8_t * v_put(uint8_t *buf, uint8_t val)
put (append) a V field
Definition: tlv.h:248
Definition of a single IE (Information Element)
Definition: tlv.h:413
static uint16_t VTVL_GAN_GROSS_LEN(uint16_t tag, uint16_t len)
gross length of vTvL header (tag+len)
Definition: tlv.h:53
tlv_type
TLV type.
Definition: tlv.h:400
@ TLV_TYPE_TL16V
tag, 16 bit length, value
Definition: tlv.h:406
static uint8_t * msgb_tlv16_put(struct msgb *msg, uint8_t tag, uint8_t len, const uint16_t *val)
put (append) a TLV16 field to msgb
Definition: tlv.h:198
#define L16TV_GROSS_LEN(x)
gross length of a L16TV type field
Definition: tlv.h:36
struct tlv_def def[256]
Definition: tlv.h:420
#define TVLV_MAX_ONEBYTE
maximum length of TLV of one byte length
Definition: tlv.h:41
static uint32_t tlvp_val32_unal(const struct tlv_parsed *tp, int pos)
Align given TLV element with 32 bit value to an address that is a multiple of 4.
Definition: tlv.h:497
int osmo_match_shift_tv_fixed(uint8_t **data, size_t *data_len, uint8_t tag, size_t len, uint8_t **value)
Match tag, check length and assign value pointer.
Definition: tlv_parser.c:397
static uint8_t * msgb_tlv_put(struct msgb *msg, uint8_t tag, uint8_t len, const uint8_t *val)
put (append) a TLV field to a msgb
Definition: tlv.h:296
@ TLV_TYPE_SINGLE_TV
tag and value (both 4 bit) in 1 byte
Definition: tlv.h:408
static uint8_t * vtvl_gan_put(uint8_t *buf, uint16_t tag, uint16_t len)
Definition: tlv.h:175
static uint8_t * msgb_vtvlv_gan_push(struct msgb *msg, uint16_t tag, uint16_t len, const uint8_t *val)
Definition: tlv.h:383
static uint8_t * msgb_tl16v_put(struct msgb *msg, uint8_t tag, uint16_t len, const uint8_t *val)
put (append) a TL16V field to msgb
Definition: tlv.h:205
uint8_t fixed_len
length in case of TLV_TYPE_FIXED
Definition: tlv.h:415
static uint8_t * msgb_tlv_push(struct msgb *msg, uint8_t tag, uint8_t len, const uint8_t *val)
push (prepend) a TLV field to a msgb
Definition: tlv.h:337
static uint8_t * tl16v_put(uint8_t *buf, uint8_t tag, uint16_t len, const uint8_t *val)
put (append) a TL16V field
Definition: tlv.h:125
static uint8_t * tlv16_put(uint8_t *buf, uint8_t tag, uint8_t len, const uint16_t *val)
put (append) a TLV16 field
Definition: tlv.h:115
static uint8_t * tv16_put(uint8_t *buf, uint8_t tag, uint16_t val)
put (append) a TV16 field
Definition: tlv.h:277
@ TLV_TYPE_NONE
no type
Definition: tlv.h:401
int osmo_shift_v_fixed(uint8_t **data, size_t *data_len, size_t len, uint8_t **value)
Advance the data pointer, subtract length and assign value pointer.
Definition: tlv_parser.c:369
struct tlv_definition vtvlv_gan_att_def
Definition: tlv_parser.c:49
static uint8_t * msgb_tvlv_put(struct msgb *msg, uint8_t tag, uint16_t len, const uint8_t *val)
put (append) a TvLV field to msgb
Definition: tlv.h:219
static uint8_t * msgb_tv_push(struct msgb *msg, uint8_t tag, uint8_t val)
push (prepend) a TV field to a msgb
Definition: tlv.h:346
#define T16LV_GROSS_LEN(x)
gross length of a T16LV type field
Definition: tlv.h:38
int osmo_match_shift_tlv(uint8_t **data, size_t *data_len, uint8_t tag, uint8_t **value, size_t *value_len)
Verify TLV header and advance data / subtract length.
Definition: tlv_parser.c:435
static uint8_t * lv_put(uint8_t *buf, uint8_t len, const uint8_t *val)
put (append) a LV field
Definition: tlv.h:85
int osmo_shift_lv(uint8_t **data, size_t *data_len, uint8_t **value, size_t *value_len)
Extract LV and advance data pointer + subtract length.
Definition: tlv_parser.c:503
static uint8_t * tv_put(uint8_t *buf, uint8_t tag, uint8_t val)
put (append) a TV field
Definition: tlv.h:255
static uint8_t * msgb_tv_fixed_put(struct msgb *msg, uint8_t tag, unsigned int len, const uint8_t *val)
put (append) a TVfixed field to a msgb
Definition: tlv.h:312
static uint8_t * tvlv_put(uint8_t *buf, uint8_t tag, uint16_t len, const uint8_t *val)
put (append) a TvLV field
Definition: tlv.h:147
static uint8_t * vtvlv_gan_put(uint8_t *buf, uint16_t tag, uint16_t len, const uint8_t *val)
Definition: tlv.h:184
static uint8_t * msgb_t16lv_put(struct msgb *msg, uint16_t tag, uint8_t len, const uint8_t *val)
Definition: tlv.h:212
result of the TLV parser
Definition: tlv.h:424
#define TLV_GROSS_LEN(x)
gross length of a TLV type field
Definition: tlv.h:30
static uint8_t * msgb_tv_put(struct msgb *msg, uint8_t tag, uint8_t val)
put (append) a TV field to a msgb
Definition: tlv.h:304
static uint8_t * msgb_tvlv_push(struct msgb *msg, uint8_t tag, uint16_t len, const uint8_t *val)
push (prepend) a TvLV field to a msgb
Definition: tlv.h:364
@ TLV_TYPE_vTvLV_GAN
variable-length tag, variable-length length
Definition: tlv.h:409
@ TLV_TYPE_TV
tag-value (8bit)
Definition: tlv.h:404
#define TLVP_VAL(x, y)
Definition: tlv.h:444