2 * blobmsg - library for generating/parsing structured blob messages
4 * Copyright (C) 2010 Felix Fietkau <nbd@openwrt.org>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU Lesser General Public License version 2.1
8 * as published by the Free Software Foundation
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
21 #define BLOBMSG_ALIGN 2
22 #define BLOBMSG_PADDING(len) (((len) + (1 << BLOBMSG_ALIGN) - 1) & ~((1 << BLOBMSG_ALIGN) - 1))
34 BLOBMSG_TYPE_LAST
= __BLOBMSG_TYPE_LAST
- 1,
35 BLOBMSG_TYPE_BOOL
= BLOBMSG_TYPE_INT8
,
43 struct blobmsg_policy
{
45 enum blobmsg_type type
;
48 static inline int blobmsg_hdrlen(int namelen
)
50 return BLOBMSG_PADDING(sizeof(struct blobmsg_hdr
) + namelen
+ 1);
53 static inline const char *blobmsg_name(const struct blob_attr
*attr
)
55 struct blobmsg_hdr
*hdr
= blob_data(attr
);
56 return (const char *) hdr
->name
;
59 static inline int blobmsg_type(const struct blob_attr
*attr
)
64 static inline void *blobmsg_data(const struct blob_attr
*attr
)
66 struct blobmsg_hdr
*hdr
= blob_data(attr
);
67 return (char *) hdr
+ blobmsg_hdrlen(hdr
->namelen
);
70 static inline int blobmsg_data_len(const struct blob_attr
*attr
)
74 start
= blob_data(attr
);
75 end
= blobmsg_data(attr
);
77 return blob_len(attr
) - (end
- start
);
80 bool blobmsg_check_attr(const struct blob_attr
*attr
, bool name
);
81 int blobmsg_parse(const struct blobmsg_policy
*policy
, int policy_len
,
82 struct blob_attr
**tb
, void *data
, int len
);
84 int blobmsg_add_field(struct blob_buf
*buf
, int type
, const char *name
,
85 const void *data
, int len
);
88 blobmsg_add_u8(struct blob_buf
*buf
, const char *name
, uint8_t val
)
90 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT8
, name
, &val
, 1);
94 blobmsg_add_u16(struct blob_buf
*buf
, const char *name
, uint16_t val
)
96 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT16
, name
, &val
, 2);
100 blobmsg_add_u32(struct blob_buf
*buf
, const char *name
, uint32_t val
)
102 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT32
, name
, &val
, 4);
106 blobmsg_add_u64(struct blob_buf
*buf
, const char *name
, uint64_t val
)
108 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT64
, name
, &val
, 8);
112 blobmsg_add_string(struct blob_buf
*buf
, const char *name
, const char *string
)
114 return blobmsg_add_field(buf
, BLOBMSG_TYPE_STRING
, name
, string
, strlen(string
) + 1);
117 void *blobmsg_open_nested(struct blob_buf
*buf
, const char *name
, bool array
);
120 blobmsg_open_array(struct blob_buf
*buf
, const char *name
)
122 return blobmsg_open_nested(buf
, name
, true);
126 blobmsg_open_table(struct blob_buf
*buf
, const char *name
)
128 return blobmsg_open_nested(buf
, name
, false);
132 blobmsg_close_array(struct blob_buf
*buf
, void *cookie
)
134 blob_nest_end(buf
, cookie
);
138 blobmsg_close_table(struct blob_buf
*buf
, void *cookie
)
140 blob_nest_end(buf
, cookie
);
143 static inline int blobmsg_buf_init(struct blob_buf
*buf
)
145 return blob_buf_init(buf
, BLOBMSG_TYPE_TABLE
);
148 static inline uint8_t blobmsg_get_u8(struct blob_attr
*attr
)
150 return *(uint8_t *) blobmsg_data(attr
);
153 static inline bool blobmsg_get_bool(struct blob_attr
*attr
)
155 return *(uint8_t *) blobmsg_data(attr
);
158 static inline uint16_t blobmsg_get_u16(struct blob_attr
*attr
)
160 return *(uint16_t *) blobmsg_data(attr
);
163 static inline uint32_t blobmsg_get_u32(struct blob_attr
*attr
)
165 return *(uint32_t *) blobmsg_data(attr
);
168 static inline uint64_t blobmsg_get_u64(struct blob_attr
*attr
)
170 return *(uint64_t *) blobmsg_data(attr
);
173 void *blobmsg_alloc_string_buffer(struct blob_buf
*buf
, const char *name
, int maxlen
);
174 void blobmsg_add_string_buffer(struct blob_buf
*buf
);
176 /* blobmsg to json formatting */
178 #define blobmsg_for_each_attr(pos, attr, rem) \
179 for (rem = blobmsg_data_len(attr), pos = blobmsg_data(attr); \
180 rem > 0 && (blob_pad_len(pos) <= rem) && \
181 (blob_pad_len(pos) >= sizeof(struct blob_attr)); \
182 rem -= blob_pad_len(pos), pos = blob_next(pos))