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 void *blobmsg_data(const struct blob_attr
*attr
)
61 struct blobmsg_hdr
*hdr
= blob_data(attr
);
62 return (char *) hdr
+ blobmsg_hdrlen(hdr
->namelen
);
65 static inline int blobmsg_data_len(const struct blob_attr
*attr
)
69 start
= blob_data(attr
);
70 end
= blobmsg_data(attr
);
72 return blob_len(attr
) - (end
- start
);
75 bool blobmsg_check_attr(const struct blob_attr
*attr
, bool name
);
76 int blobmsg_parse(const struct blobmsg_policy
*policy
, int policy_len
,
77 struct blob_attr
**tb
, void *data
, int len
);
79 int blobmsg_add_field(struct blob_buf
*buf
, int type
, const char *name
,
80 const void *data
, int len
);
83 blobmsg_add_u8(struct blob_buf
*buf
, const char *name
, uint8_t val
)
85 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT8
, name
, &val
, 1);
89 blobmsg_add_u16(struct blob_buf
*buf
, const char *name
, uint16_t val
)
91 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT16
, name
, &val
, 2);
95 blobmsg_add_u32(struct blob_buf
*buf
, const char *name
, uint32_t val
)
97 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT32
, name
, &val
, 4);
101 blobmsg_add_u64(struct blob_buf
*buf
, const char *name
, uint64_t val
)
103 return blobmsg_add_field(buf
, BLOBMSG_TYPE_INT64
, name
, &val
, 8);
107 blobmsg_add_string(struct blob_buf
*buf
, const char *name
, const char *string
)
109 return blobmsg_add_field(buf
, BLOBMSG_TYPE_STRING
, name
, string
, strlen(string
) + 1);
112 void *blobmsg_open_nested(struct blob_buf
*buf
, const char *name
, bool array
);
115 blobmsg_open_array(struct blob_buf
*buf
, const char *name
)
117 return blobmsg_open_nested(buf
, name
, true);
121 blobmsg_open_table(struct blob_buf
*buf
, const char *name
)
123 return blobmsg_open_nested(buf
, name
, false);
127 blobmsg_close_array(struct blob_buf
*buf
, void *cookie
)
129 blob_nest_end(buf
, cookie
);
133 blobmsg_close_table(struct blob_buf
*buf
, void *cookie
)
135 blob_nest_end(buf
, cookie
);
138 static inline int blobmsg_buf_init(struct blob_buf
*buf
)
140 return blob_buf_init(buf
, BLOBMSG_TYPE_TABLE
);
143 static inline uint8_t blobmsg_get_u8(struct blob_attr
*attr
)
145 return *(uint8_t *) blobmsg_data(attr
);
148 static inline bool blobmsg_get_bool(struct blob_attr
*attr
)
150 return *(uint8_t *) blobmsg_data(attr
);
153 static inline uint16_t blobmsg_get_u16(struct blob_attr
*attr
)
155 return *(uint16_t *) blobmsg_data(attr
);
158 static inline uint32_t blobmsg_get_u32(struct blob_attr
*attr
)
160 return *(uint32_t *) blobmsg_data(attr
);
163 static inline uint64_t blobmsg_get_u64(struct blob_attr
*attr
)
165 return *(uint64_t *) blobmsg_data(attr
);
168 void *blobmsg_alloc_string_buffer(struct blob_buf
*buf
, const char *name
, int maxlen
);
169 void blobmsg_add_string_buffer(struct blob_buf
*buf
);
171 /* blobmsg to json formatting */
173 #define blobmsg_for_each_attr(pos, attr, rem) \
174 for (rem = blobmsg_data_len(attr), pos = blobmsg_data(attr); \
175 (blob_pad_len(pos) <= rem) && \
176 (blob_pad_len(pos) >= sizeof(struct blob_attr)); \
177 rem -= blob_pad_len(pos), pos = blob_next(pos))