]> git.proxmox.com Git - mirror_iproute2.git/blob - include/utils.h
lib: Add parse_one_of(), parse_on_off()
[mirror_iproute2.git] / include / utils.h
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __UTILS_H__
3 #define __UTILS_H__ 1
4
5 #include <sys/types.h>
6 #include <asm/types.h>
7 #include <resolv.h>
8 #include <stdlib.h>
9 #include <stdbool.h>
10 #include <time.h>
11
12 #ifdef HAVE_LIBBSD
13 #include <bsd/string.h>
14 #endif
15
16 #include "libnetlink.h"
17 #include "ll_map.h"
18 #include "rtm_map.h"
19 #include "json_print.h"
20
21 extern int preferred_family;
22 extern int human_readable;
23 extern int use_iec;
24 extern int show_stats;
25 extern int show_details;
26 extern int show_raw;
27 extern int resolve_hosts;
28 extern int oneline;
29 extern int brief;
30 extern int json;
31 extern int pretty;
32 extern int timestamp;
33 extern int timestamp_short;
34 extern const char * _SL_;
35 extern int max_flush_loops;
36 extern int batch_mode;
37 extern int numeric;
38 extern bool do_all;
39
40 #ifndef CONFDIR
41 #define CONFDIR "/etc/iproute2"
42 #endif
43
44 #define SPRINT_BSIZE 64
45 #define SPRINT_BUF(x) char x[SPRINT_BSIZE]
46
47 void incomplete_command(void) __attribute__((noreturn));
48
49 #define NEXT_ARG() do { argv++; if (--argc <= 0) incomplete_command(); } while(0)
50 #define NEXT_ARG_OK() (argc - 1 > 0)
51 #define NEXT_ARG_FWD() do { argv++; argc--; } while(0)
52 #define PREV_ARG() do { argv--; argc++; } while(0)
53
54 #define TIME_UNITS_PER_SEC 1000000
55 #define NSEC_PER_USEC 1000
56 #define NSEC_PER_MSEC 1000000
57 #define NSEC_PER_SEC 1000000000LL
58
59 typedef struct
60 {
61 __u16 flags;
62 __u16 bytelen;
63 __s16 bitlen;
64 /* These next two fields match rtvia */
65 __u16 family;
66 __u32 data[64];
67 } inet_prefix;
68
69 enum {
70 PREFIXLEN_SPECIFIED = (1 << 0),
71 ADDRTYPE_INET = (1 << 1),
72 ADDRTYPE_UNSPEC = (1 << 2),
73 ADDRTYPE_MULTI = (1 << 3),
74
75 ADDRTYPE_INET_UNSPEC = ADDRTYPE_INET | ADDRTYPE_UNSPEC,
76 ADDRTYPE_INET_MULTI = ADDRTYPE_INET | ADDRTYPE_MULTI
77 };
78
79 static inline void inet_prefix_reset(inet_prefix *p)
80 {
81 p->flags = 0;
82 }
83
84 static inline bool is_addrtype_inet(const inet_prefix *p)
85 {
86 return p->flags & ADDRTYPE_INET;
87 }
88
89 static inline bool is_addrtype_inet_unspec(const inet_prefix *p)
90 {
91 return (p->flags & ADDRTYPE_INET_UNSPEC) == ADDRTYPE_INET_UNSPEC;
92 }
93
94 static inline bool is_addrtype_inet_multi(const inet_prefix *p)
95 {
96 return (p->flags & ADDRTYPE_INET_MULTI) == ADDRTYPE_INET_MULTI;
97 }
98
99 static inline bool is_addrtype_inet_not_unspec(const inet_prefix *p)
100 {
101 return (p->flags & ADDRTYPE_INET_UNSPEC) == ADDRTYPE_INET;
102 }
103
104 static inline bool is_addrtype_inet_not_multi(const inet_prefix *p)
105 {
106 return (p->flags & ADDRTYPE_INET_MULTI) == ADDRTYPE_INET;
107 }
108
109 #define DN_MAXADDL 20
110 #ifndef AF_DECnet
111 #define AF_DECnet 12
112 #endif
113
114 struct dn_naddr
115 {
116 unsigned short a_len;
117 unsigned char a_addr[DN_MAXADDL];
118 };
119
120 #ifndef AF_MPLS
121 # define AF_MPLS 28
122 #endif
123 #ifndef IPPROTO_MPLS
124 #define IPPROTO_MPLS 137
125 #endif
126
127 #ifndef CLOCK_TAI
128 # define CLOCK_TAI 11
129 #endif
130
131 #ifndef AF_XDP
132 # define AF_XDP 44
133 # if AF_MAX < 45
134 # undef AF_MAX
135 # define AF_MAX 45
136 # endif
137 #endif
138
139 __u32 get_addr32(const char *name);
140 int get_addr_1(inet_prefix *dst, const char *arg, int family);
141 int get_prefix_1(inet_prefix *dst, char *arg, int family);
142 int get_addr(inet_prefix *dst, const char *arg, int family);
143 int get_prefix(inet_prefix *dst, char *arg, int family);
144 int mask2bits(__u32 netmask);
145 int get_addr_rta(inet_prefix *dst, const struct rtattr *rta, int family);
146 int get_addr_ila(__u64 *val, const char *arg);
147
148 int read_prop(const char *dev, char *prop, long *value);
149 int get_hex(char c);
150 int get_integer(int *val, const char *arg, int base);
151 int get_unsigned(unsigned *val, const char *arg, int base);
152 int get_time_rtt(unsigned *val, const char *arg, int *raw);
153 #define get_byte get_u8
154 #define get_ushort get_u16
155 #define get_short get_s16
156 int get_s64(__s64 *val, const char *arg, int base);
157 int get_u64(__u64 *val, const char *arg, int base);
158 int get_u32(__u32 *val, const char *arg, int base);
159 int get_s32(__s32 *val, const char *arg, int base);
160 int get_u16(__u16 *val, const char *arg, int base);
161 int get_u8(__u8 *val, const char *arg, int base);
162 int get_be64(__be64 *val, const char *arg, int base);
163 int get_be32(__be32 *val, const char *arg, int base);
164 int get_be16(__be16 *val, const char *arg, int base);
165 int get_addr64(__u64 *ap, const char *cp);
166
167 int hex2mem(const char *buf, uint8_t *mem, int count);
168 char *hexstring_n2a(const __u8 *str, int len, char *buf, int blen);
169 __u8 *hexstring_a2n(const char *str, __u8 *buf, int blen, unsigned int *len);
170 #define ADDR64_BUF_SIZE sizeof("xxxx:xxxx:xxxx:xxxx")
171 int addr64_n2a(__u64 addr, char *buff, size_t len);
172
173 int af_bit_len(int af);
174
175 const char *format_host_r(int af, int len, const void *addr,
176 char *buf, int buflen);
177 #define format_host_rta_r(af, rta, buf, buflen) \
178 format_host_r(af, RTA_PAYLOAD(rta), RTA_DATA(rta), \
179 buf, buflen)
180
181 const char *format_host(int af, int lne, const void *addr);
182 #define format_host_rta(af, rta) \
183 format_host(af, RTA_PAYLOAD(rta), RTA_DATA(rta))
184 const char *rt_addr_n2a_r(int af, int len, const void *addr,
185 char *buf, int buflen);
186 const char *rt_addr_n2a(int af, int len, const void *addr);
187 #define rt_addr_n2a_rta(af, rta) \
188 rt_addr_n2a(af, RTA_PAYLOAD(rta), RTA_DATA(rta))
189
190 int read_family(const char *name);
191 const char *family_name(int family);
192
193 void missarg(const char *) __attribute__((noreturn));
194 void invarg(const char *, const char *) __attribute__((noreturn));
195 void duparg(const char *, const char *) __attribute__((noreturn));
196 void duparg2(const char *, const char *) __attribute__((noreturn));
197 int nodev(const char *dev);
198 int check_ifname(const char *);
199 int check_altifname(const char *name);
200 int get_ifname(char *, const char *);
201 const char *get_ifname_rta(int ifindex, const struct rtattr *rta);
202 bool matches(const char *prefix, const char *string);
203 int inet_addr_match(const inet_prefix *a, const inet_prefix *b, int bits);
204 int inet_addr_match_rta(const inet_prefix *m, const struct rtattr *rta);
205
206 const char *mpls_ntop(int af, const void *addr, char *str, size_t len);
207 int mpls_pton(int af, const char *src, void *addr, size_t alen);
208
209 extern int __iproute2_hz_internal;
210 int __get_hz(void);
211
212 static __inline__ int get_hz(void)
213 {
214 if (__iproute2_hz_internal == 0)
215 __iproute2_hz_internal = __get_hz();
216 return __iproute2_hz_internal;
217 }
218
219 extern int __iproute2_user_hz_internal;
220 int __get_user_hz(void);
221
222 static __inline__ int get_user_hz(void)
223 {
224 if (__iproute2_user_hz_internal == 0)
225 __iproute2_user_hz_internal = __get_user_hz();
226 return __iproute2_user_hz_internal;
227 }
228
229 static inline __u32 nl_mgrp(__u32 group)
230 {
231 if (group > 31 ) {
232 fprintf(stderr, "Use setsockopt for this group %d\n", group);
233 exit(-1);
234 }
235 return group ? (1 << (group - 1)) : 0;
236 }
237
238 /* courtesy of bridge-utils */
239 static inline unsigned long __tv_to_jiffies(const struct timeval *tv)
240 {
241 unsigned long long jif;
242
243 jif = 1000000ULL * tv->tv_sec + tv->tv_usec;
244
245 return jif/10000;
246 }
247
248 static inline void __jiffies_to_tv(struct timeval *tv, unsigned long jiffies)
249 {
250 unsigned long long tvusec;
251
252 tvusec = 10000ULL*jiffies;
253 tv->tv_sec = tvusec/1000000;
254 tv->tv_usec = tvusec - 1000000 * tv->tv_sec;
255 }
256
257 void print_escape_buf(const __u8 *buf, size_t len, const char *escape);
258
259 int print_timestamp(FILE *fp);
260 void print_nlmsg_timestamp(FILE *fp, const struct nlmsghdr *n);
261
262 unsigned int print_name_and_link(const char *fmt,
263 const char *name, struct rtattr *tb[]);
264
265 #define BIT(nr) (1UL << (nr))
266
267 #define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
268
269 #define BUILD_BUG_ON(cond) ((void)sizeof(char[1 - 2 * !!(cond)]))
270
271 #ifndef offsetof
272 # define offsetof(type, member) ((size_t) &((type *)0)->member)
273 #endif
274
275 #ifndef min
276 # define min(x, y) ({ \
277 typeof(x) _min1 = (x); \
278 typeof(y) _min2 = (y); \
279 (void) (&_min1 == &_min2); \
280 _min1 < _min2 ? _min1 : _min2; })
281 #endif
282
283 #ifndef __check_format_string
284 # define __check_format_string(pos_str, pos_args) \
285 __attribute__ ((format (printf, (pos_str), (pos_args))))
286 #endif
287
288 #define _textify(x) #x
289 #define textify(x) _textify(x)
290
291 #define htonll(x) ((1==htonl(1)) ? (x) : ((uint64_t)htonl((x) & 0xFFFFFFFF) << 32) | htonl((x) >> 32))
292 #define ntohll(x) ((1==ntohl(1)) ? (x) : ((uint64_t)ntohl((x) & 0xFFFFFFFF) << 32) | ntohl((x) >> 32))
293
294 extern int cmdlineno;
295 ssize_t getcmdline(char **line, size_t *len, FILE *in);
296 int makeargs(char *line, char *argv[], int maxargs);
297
298 char *int_to_str(int val, char *buf);
299 int get_guid(__u64 *guid, const char *arg);
300 int get_real_family(int rtm_type, int rtm_family);
301
302 int cmd_exec(const char *cmd, char **argv, bool do_fork,
303 int (*setup)(void *), void *arg);
304 int make_path(const char *path, mode_t mode);
305 char *find_cgroup2_mount(bool do_mount);
306 __u64 get_cgroup2_id(const char *path);
307 char *get_cgroup2_path(__u64 id, bool full);
308 int get_command_name(const char *pid, char *comm, size_t len);
309
310 int get_rtnl_link_stats_rta(struct rtnl_link_stats64 *stats64,
311 struct rtattr *tb[]);
312
313 #ifdef NEED_STRLCPY
314 size_t strlcpy(char *dst, const char *src, size_t size);
315 size_t strlcat(char *dst, const char *src, size_t size);
316 #endif
317
318 void drop_cap(void);
319
320 int get_time(unsigned int *time, const char *str);
321 int get_time64(__s64 *time, const char *str);
322 char *sprint_time(__u32 time, char *buf);
323 char *sprint_time64(__s64 time, char *buf);
324
325 int do_batch(const char *name, bool force,
326 int (*cmd)(int argc, char *argv[], void *user), void *user);
327
328 int parse_one_of(const char *msg, const char *realval, const char * const *list,
329 size_t len, int *p_err);
330 bool parse_on_off(const char *msg, const char *realval, int *p_err);
331
332 #endif /* __UTILS_H__ */