]> git.proxmox.com Git - mirror_iproute2.git/blame - include/libnetlink.h
libnetlink: Rename rtnl_wilddump_* to rtnl_linkdump_*
[mirror_iproute2.git] / include / libnetlink.h
CommitLineData
6054c1eb 1/* SPDX-License-Identifier: GPL-2.0 */
aba5acdf
SH
2#ifndef __LIBNETLINK_H__
3#define __LIBNETLINK_H__ 1
4
5bd9dd49 5#include <stdio.h>
f5b830dc 6#include <string.h>
aba5acdf
SH
7#include <asm/types.h>
8#include <linux/netlink.h>
9#include <linux/rtnetlink.h>
ead2ba70
SH
10#include <linux/if_link.h>
11#include <linux/if_addr.h>
12#include <linux/neighbour.h>
9d0efc10 13#include <linux/netconf.h>
aab0f610 14#include <arpa/inet.h>
aba5acdf 15
e9e9365b 16struct rtnl_handle {
aba5acdf
SH
17 int fd;
18 struct sockaddr_nl local;
19 struct sockaddr_nl peer;
20 __u32 seq;
21 __u32 dump;
8a4025f6 22 int proto;
486ccd99 23 FILE *dump_fp;
449b824a 24#define RTNL_HANDLE_F_LISTEN_ALL_NSID 0x01
3ad6d176 25#define RTNL_HANDLE_F_SUPPRESS_NLERR 0x02
449b824a 26 int flags;
aba5acdf
SH
27};
28
4ad87594
DA
29struct nlmsg_list {
30 struct nlmsg_list *next;
31 struct nlmsghdr h;
32};
33
34struct nlmsg_chain {
35 struct nlmsg_list *head;
36 struct nlmsg_list *tail;
37};
38
7f03191f
PM
39extern int rcvbuf;
40
e9e9365b 41int rtnl_open(struct rtnl_handle *rth, unsigned int subscriptions)
d2468da0
SH
42 __attribute__((warn_unused_result));
43
e9e9365b 44int rtnl_open_byproto(struct rtnl_handle *rth, unsigned int subscriptions,
d2468da0
SH
45 int protocol)
46 __attribute__((warn_unused_result));
47
892e2124 48void rtnl_close(struct rtnl_handle *rth);
46917d08
DA
49
50int rtnl_addrdump_req(struct rtnl_handle *rth, int family)
51 __attribute__((warn_unused_result));
39360023
DA
52int rtnl_addrlbldump_req(struct rtnl_handle *rth, int family)
53 __attribute__((warn_unused_result));
bfb27dfa
DA
54int rtnl_routedump_req(struct rtnl_handle *rth, int family)
55 __attribute__((warn_unused_result));
b05d9a3d
DA
56int rtnl_ruledump_req(struct rtnl_handle *rth, int family)
57 __attribute__((warn_unused_result));
9e0ab19c
DA
58int rtnl_neighdump_req(struct rtnl_handle *rth, int family)
59 __attribute__((warn_unused_result));
ff41db8a
DA
60int rtnl_neightbldump_req(struct rtnl_handle *rth, int family)
61 __attribute__((warn_unused_result));
9dbe6df4
DA
62int rtnl_mdbdump_req(struct rtnl_handle *rth, int family)
63 __attribute__((warn_unused_result));
ddee16bc
DA
64int rtnl_netconfdump_req(struct rtnl_handle *rth, int family)
65 __attribute__((warn_unused_result));
efb0b383
DA
66int rtnl_nsiddump_req(struct rtnl_handle *rth, int family)
67 __attribute__((warn_unused_result));
46917d08 68
31ae2912 69int rtnl_linkdump_req(struct rtnl_handle *rth, int fam)
d2468da0 70 __attribute__((warn_unused_result));
31ae2912 71int rtnl_linkdump_req_filter(struct rtnl_handle *rth, int fam, __u32 filt_mask)
d2468da0 72 __attribute__((warn_unused_result));
b0a4ce62
DA
73
74typedef int (*req_filter_fn_t)(struct nlmsghdr *nlh, int reqlen);
75
31ae2912 76int rtnl_linkdump_req_filter_fn(struct rtnl_handle *rth, int fam,
b0a4ce62
DA
77 req_filter_fn_t fn)
78 __attribute__((warn_unused_result));
7abf5de6
NA
79int rtnl_wilddump_stats_req_filter(struct rtnl_handle *rth, int fam, int type,
80 __u32 filt_mask)
81 __attribute__((warn_unused_result));
892e2124 82int rtnl_dump_request(struct rtnl_handle *rth, int type, void *req,
d2468da0
SH
83 int len)
84 __attribute__((warn_unused_result));
0d238ca2
DA
85int rtnl_dump_request_n(struct rtnl_handle *rth, struct nlmsghdr *n)
86 __attribute__((warn_unused_result));
6dc9f016 87
0628cddd 88struct rtnl_ctrl_data {
449b824a 89 int nsid;
0628cddd
ND
90};
91
ae665a52 92typedef int (*rtnl_filter_t)(const struct sockaddr_nl *,
50772dc5 93 struct nlmsghdr *n, void *);
b49240ec 94
0628cddd
ND
95typedef int (*rtnl_listen_filter_t)(const struct sockaddr_nl *,
96 struct rtnl_ctrl_data *,
97 struct nlmsghdr *n, void *);
98
b6432e68
SH
99typedef int (*nl_ext_ack_fn_t)(const char *errmsg, uint32_t off,
100 const struct nlmsghdr *inner_nlh);
101
e9e9365b 102struct rtnl_dump_filter_arg {
b49240ec
SH
103 rtnl_filter_t filter;
104 void *arg1;
8e72880f 105 __u16 nc_flags;
b49240ec
SH
106};
107
892e2124 108int rtnl_dump_filter_l(struct rtnl_handle *rth,
b49240ec 109 const struct rtnl_dump_filter_arg *arg);
8e72880f
PS
110int rtnl_dump_filter_nc(struct rtnl_handle *rth,
111 rtnl_filter_t filter,
112 void *arg, __u16 nc_flags);
113#define rtnl_dump_filter(rth, filter, arg) \
114 rtnl_dump_filter_nc(rth, filter, arg, 0)
892e2124 115int rtnl_talk(struct rtnl_handle *rtnl, struct nlmsghdr *n,
86bf43c7 116 struct nlmsghdr **answer)
d2468da0 117 __attribute__((warn_unused_result));
72a2ff39
CM
118int rtnl_talk_iov(struct rtnl_handle *rtnl, struct iovec *iovec, size_t iovlen,
119 struct nlmsghdr **answer)
120 __attribute__((warn_unused_result));
b6432e68 121int rtnl_talk_extack(struct rtnl_handle *rtnl, struct nlmsghdr *n,
86bf43c7 122 struct nlmsghdr **answer, nl_ext_ack_fn_t errfn)
b6432e68 123 __attribute__((warn_unused_result));
463d9efa 124int rtnl_talk_suppress_rtnl_errmsg(struct rtnl_handle *rtnl, struct nlmsghdr *n,
86bf43c7 125 struct nlmsghdr **answer)
463d9efa 126 __attribute__((warn_unused_result));
892e2124 127int rtnl_send(struct rtnl_handle *rth, const void *buf, int)
d2468da0 128 __attribute__((warn_unused_result));
892e2124 129int rtnl_send_check(struct rtnl_handle *rth, const void *buf, int)
d2468da0 130 __attribute__((warn_unused_result));
049c5853 131int nl_dump_ext_ack(const struct nlmsghdr *nlh, nl_ext_ack_fn_t errfn);
aba5acdf 132
892e2124
SH
133int addattr(struct nlmsghdr *n, int maxlen, int type);
134int addattr8(struct nlmsghdr *n, int maxlen, int type, __u8 data);
135int addattr16(struct nlmsghdr *n, int maxlen, int type, __u16 data);
136int addattr32(struct nlmsghdr *n, int maxlen, int type, __u32 data);
137int addattr64(struct nlmsghdr *n, int maxlen, int type, __u64 data);
138int addattrstrz(struct nlmsghdr *n, int maxlen, int type, const char *data);
139
140int addattr_l(struct nlmsghdr *n, int maxlen, int type,
141 const void *data, int alen);
142int addraw_l(struct nlmsghdr *n, int maxlen, const void *data, int len);
143struct rtattr *addattr_nest(struct nlmsghdr *n, int maxlen, int type);
144int addattr_nest_end(struct nlmsghdr *n, struct rtattr *nest);
145struct rtattr *addattr_nest_compat(struct nlmsghdr *n, int maxlen, int type,
146 const void *data, int len);
147int addattr_nest_compat_end(struct nlmsghdr *n, struct rtattr *nest);
303cc9cb
RP
148int rta_addattr8(struct rtattr *rta, int maxlen, int type, __u8 data);
149int rta_addattr16(struct rtattr *rta, int maxlen, int type, __u16 data);
892e2124 150int rta_addattr32(struct rtattr *rta, int maxlen, int type, __u32 data);
303cc9cb 151int rta_addattr64(struct rtattr *rta, int maxlen, int type, __u64 data);
892e2124
SH
152int rta_addattr_l(struct rtattr *rta, int maxlen, int type,
153 const void *data, int alen);
154
155int parse_rtattr(struct rtattr *tb[], int max, struct rtattr *rta, int len);
156int parse_rtattr_flags(struct rtattr *tb[], int max, struct rtattr *rta,
b1b7ce0f 157 int len, unsigned short flags);
892e2124
SH
158int parse_rtattr_byindex(struct rtattr *tb[], int max,
159 struct rtattr *rta, int len);
160struct rtattr *parse_rtattr_one(int type, struct rtattr *rta, int len);
161int __parse_rtattr_nested_compat(struct rtattr *tb[], int max, struct rtattr *rta, int len);
aba5acdf 162
303cc9cb
RP
163struct rtattr *rta_nest(struct rtattr *rta, int maxlen, int type);
164int rta_nest_end(struct rtattr *rta, struct rtattr *nest);
165
166#define RTA_TAIL(rta) \
167 ((struct rtattr *) (((void *) (rta)) + \
168 RTA_ALIGN((rta)->rta_len)))
169
753fca4f 170#define parse_rtattr_nested(tb, max, rta) \
171 (parse_rtattr((tb), (max), RTA_DATA(rta), RTA_PAYLOAD(rta)))
172
decbb437
JP
173#define parse_rtattr_one_nested(type, rta) \
174 (parse_rtattr_one(type, RTA_DATA(rta), RTA_PAYLOAD(rta)))
175
2f90c9c0 176#define parse_rtattr_nested_compat(tb, max, rta, data, len) \
cd70f3f5
SH
177 ({ data = RTA_PAYLOAD(rta) >= len ? RTA_DATA(rta) : NULL; \
178 __parse_rtattr_nested_compat(tb, max, rta, len); })
2f90c9c0 179
7dd03712
SH
180static inline __u8 rta_getattr_u8(const struct rtattr *rta)
181{
182 return *(__u8 *)RTA_DATA(rta);
183}
46c5d64d
SH
184static inline __u16 rta_getattr_u16(const struct rtattr *rta)
185{
186 return *(__u16 *)RTA_DATA(rta);
187}
aab0f610
AV
188static inline __be16 rta_getattr_be16(const struct rtattr *rta)
189{
190 return ntohs(rta_getattr_u16(rta));
191}
7dd03712 192static inline __u32 rta_getattr_u32(const struct rtattr *rta)
46c5d64d
SH
193{
194 return *(__u32 *)RTA_DATA(rta);
195}
aab0f610
AV
196static inline __be32 rta_getattr_be32(const struct rtattr *rta)
197{
198 return ntohl(rta_getattr_u32(rta));
199}
46c5d64d
SH
200static inline __u64 rta_getattr_u64(const struct rtattr *rta)
201{
202 __u64 tmp;
e9e9365b 203
46c5d64d
SH
204 memcpy(&tmp, RTA_DATA(rta), sizeof(__u64));
205 return tmp;
206}
207static inline const char *rta_getattr_str(const struct rtattr *rta)
208{
cfd2cbd1 209 return (const char *)RTA_DATA(rta);
46c5d64d
SH
210}
211
892e2124
SH
212int rtnl_listen_all_nsid(struct rtnl_handle *);
213int rtnl_listen(struct rtnl_handle *, rtnl_listen_filter_t handler,
214 void *jarg);
215int rtnl_from_file(FILE *, rtnl_listen_filter_t handler,
216 void *jarg);
aba5acdf 217
370d67ba 218#define NLMSG_TAIL(nmsg) \
219 ((struct rtattr *) (((void *) (nmsg)) + NLMSG_ALIGN((nmsg)->nlmsg_len)))
220
ead2ba70
SH
221#ifndef IFA_RTA
222#define IFA_RTA(r) \
e9e9365b 223 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct ifaddrmsg))))
ead2ba70
SH
224#endif
225#ifndef IFA_PAYLOAD
e9e9365b 226#define IFA_PAYLOAD(n) NLMSG_PAYLOAD(n, sizeof(struct ifaddrmsg))
ead2ba70
SH
227#endif
228
229#ifndef IFLA_RTA
230#define IFLA_RTA(r) \
e9e9365b 231 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct ifinfomsg))))
ead2ba70
SH
232#endif
233#ifndef IFLA_PAYLOAD
e9e9365b 234#define IFLA_PAYLOAD(n) NLMSG_PAYLOAD(n, sizeof(struct ifinfomsg))
ead2ba70
SH
235#endif
236
237#ifndef NDA_RTA
238#define NDA_RTA(r) \
e9e9365b 239 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct ndmsg))))
ead2ba70
SH
240#endif
241#ifndef NDA_PAYLOAD
e9e9365b 242#define NDA_PAYLOAD(n) NLMSG_PAYLOAD(n, sizeof(struct ndmsg))
ead2ba70
SH
243#endif
244
245#ifndef NDTA_RTA
246#define NDTA_RTA(r) \
e9e9365b 247 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct ndtmsg))))
ead2ba70
SH
248#endif
249#ifndef NDTA_PAYLOAD
e9e9365b 250#define NDTA_PAYLOAD(n) NLMSG_PAYLOAD(n, sizeof(struct ndtmsg))
ead2ba70
SH
251#endif
252
d182ee13
ND
253#ifndef NETNS_RTA
254#define NETNS_RTA(r) \
e9e9365b 255 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct rtgenmsg))))
d182ee13
ND
256#endif
257#ifndef NETNS_PAYLOAD
e9e9365b 258#define NETNS_PAYLOAD(n) NLMSG_PAYLOAD(n, sizeof(struct rtgenmsg))
d182ee13
ND
259#endif
260
7abf5de6
NA
261#ifndef IFLA_STATS_RTA
262#define IFLA_STATS_RTA(r) \
263 ((struct rtattr *)(((char *)(r)) + NLMSG_ALIGN(sizeof(struct if_stats_msg))))
264#endif
265
27b14f2e
VK
266/* User defined nlmsg_type which is used mostly for logging netlink
267 * messages from dump file */
268#define NLMSG_TSTAMP 15
269
aba5acdf 270#endif /* __LIBNETLINK_H__ */