1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _UAPI__LINUX_RTNETLINK_H
3 #define _UAPI__LINUX_RTNETLINK_H
5 #include <linux/types.h>
6 #include <linux/netlink.h>
7 #include <linux/if_link.h>
8 #include <linux/if_addr.h>
9 #include <linux/neighbour.h>
11 /* rtnetlink families. Values up to 127 are reserved for real address
12 * families, values above 128 may be used arbitrarily.
14 #define RTNL_FAMILY_IPMR 128
15 #define RTNL_FAMILY_IP6MR 129
16 #define RTNL_FAMILY_MAX 129
19 * Routing/neighbour discovery messages.
22 /* Types of messages */
26 #define RTM_BASE RTM_BASE
29 #define RTM_NEWLINK RTM_NEWLINK
31 #define RTM_DELLINK RTM_DELLINK
33 #define RTM_GETLINK RTM_GETLINK
35 #define RTM_SETLINK RTM_SETLINK
38 #define RTM_NEWADDR RTM_NEWADDR
40 #define RTM_DELADDR RTM_DELADDR
42 #define RTM_GETADDR RTM_GETADDR
45 #define RTM_NEWROUTE RTM_NEWROUTE
47 #define RTM_DELROUTE RTM_DELROUTE
49 #define RTM_GETROUTE RTM_GETROUTE
52 #define RTM_NEWNEIGH RTM_NEWNEIGH
54 #define RTM_DELNEIGH RTM_DELNEIGH
56 #define RTM_GETNEIGH RTM_GETNEIGH
59 #define RTM_NEWRULE RTM_NEWRULE
61 #define RTM_DELRULE RTM_DELRULE
63 #define RTM_GETRULE RTM_GETRULE
66 #define RTM_NEWQDISC RTM_NEWQDISC
68 #define RTM_DELQDISC RTM_DELQDISC
70 #define RTM_GETQDISC RTM_GETQDISC
73 #define RTM_NEWTCLASS RTM_NEWTCLASS
75 #define RTM_DELTCLASS RTM_DELTCLASS
77 #define RTM_GETTCLASS RTM_GETTCLASS
80 #define RTM_NEWTFILTER RTM_NEWTFILTER
82 #define RTM_DELTFILTER RTM_DELTFILTER
84 #define RTM_GETTFILTER RTM_GETTFILTER
87 #define RTM_NEWACTION RTM_NEWACTION
89 #define RTM_DELACTION RTM_DELACTION
91 #define RTM_GETACTION RTM_GETACTION
94 #define RTM_NEWPREFIX RTM_NEWPREFIX
96 RTM_GETMULTICAST = 58,
97 #define RTM_GETMULTICAST RTM_GETMULTICAST
100 #define RTM_GETANYCAST RTM_GETANYCAST
102 RTM_NEWNEIGHTBL = 64,
103 #define RTM_NEWNEIGHTBL RTM_NEWNEIGHTBL
104 RTM_GETNEIGHTBL = 66,
105 #define RTM_GETNEIGHTBL RTM_GETNEIGHTBL
107 #define RTM_SETNEIGHTBL RTM_SETNEIGHTBL
109 RTM_NEWNDUSEROPT = 68,
110 #define RTM_NEWNDUSEROPT RTM_NEWNDUSEROPT
112 RTM_NEWADDRLABEL = 72,
113 #define RTM_NEWADDRLABEL RTM_NEWADDRLABEL
115 #define RTM_DELADDRLABEL RTM_DELADDRLABEL
117 #define RTM_GETADDRLABEL RTM_GETADDRLABEL
120 #define RTM_GETDCB RTM_GETDCB
122 #define RTM_SETDCB RTM_SETDCB
125 #define RTM_NEWNETCONF RTM_NEWNETCONF
127 #define RTM_DELNETCONF RTM_DELNETCONF
129 #define RTM_GETNETCONF RTM_GETNETCONF
132 #define RTM_NEWMDB RTM_NEWMDB
134 #define RTM_DELMDB RTM_DELMDB
136 #define RTM_GETMDB RTM_GETMDB
139 #define RTM_NEWNSID RTM_NEWNSID
141 #define RTM_DELNSID RTM_DELNSID
143 #define RTM_GETNSID RTM_GETNSID
146 #define RTM_NEWSTATS RTM_NEWSTATS
148 #define RTM_GETSTATS RTM_GETSTATS
150 RTM_NEWCACHEREPORT = 96,
151 #define RTM_NEWCACHEREPORT RTM_NEWCACHEREPORT
154 #define RTM_NEWCHAIN RTM_NEWCHAIN
156 #define RTM_DELCHAIN RTM_DELCHAIN
158 #define RTM_GETCHAIN RTM_GETCHAIN
160 RTM_NEWNEXTHOP = 104,
161 #define RTM_NEWNEXTHOP RTM_NEWNEXTHOP
163 #define RTM_DELNEXTHOP RTM_DELNEXTHOP
165 #define RTM_GETNEXTHOP RTM_GETNEXTHOP
167 RTM_NEWLINKPROP = 108,
168 #define RTM_NEWLINKPROP RTM_NEWLINKPROP
170 #define RTM_DELLINKPROP RTM_DELLINKPROP
172 #define RTM_GETLINKPROP RTM_GETLINKPROP
175 #define RTM_NEWNVLAN RTM_NEWVLAN
177 #define RTM_DELVLAN RTM_DELVLAN
179 #define RTM_GETVLAN RTM_GETVLAN
182 #define RTM_MAX (((__RTM_MAX + 3) & ~3) - 1)
185 #define RTM_NR_MSGTYPES (RTM_MAX + 1 - RTM_BASE)
186 #define RTM_NR_FAMILIES (RTM_NR_MSGTYPES >> 2)
187 #define RTM_FAM(cmd) (((cmd) - RTM_BASE) >> 2)
190 Generic structure for encapsulation of optional route information.
191 It is reminiscent of sockaddr, but with sa_family replaced
196 unsigned short rta_len;
197 unsigned short rta_type;
200 /* Macros to handle rtattributes */
202 #define RTA_ALIGNTO 4U
203 #define RTA_ALIGN(len) ( ((len)+RTA_ALIGNTO-1) & ~(RTA_ALIGNTO-1) )
204 #define RTA_OK(rta,len) ((len) >= (int)sizeof(struct rtattr) && \
205 (rta)->rta_len >= sizeof(struct rtattr) && \
206 (rta)->rta_len <= (len))
207 #define RTA_NEXT(rta,attrlen) ((attrlen) -= RTA_ALIGN((rta)->rta_len), \
208 (struct rtattr*)(((char*)(rta)) + RTA_ALIGN((rta)->rta_len)))
209 #define RTA_LENGTH(len) (RTA_ALIGN(sizeof(struct rtattr)) + (len))
210 #define RTA_SPACE(len) RTA_ALIGN(RTA_LENGTH(len))
211 #define RTA_DATA(rta) ((void*)(((char*)(rta)) + RTA_LENGTH(0)))
212 #define RTA_PAYLOAD(rta) ((int)((rta)->rta_len) - RTA_LENGTH(0))
217 /******************************************************************************
218 * Definitions used in routing table administration.
222 unsigned char rtm_family;
223 unsigned char rtm_dst_len;
224 unsigned char rtm_src_len;
225 unsigned char rtm_tos;
227 unsigned char rtm_table; /* Routing table id */
228 unsigned char rtm_protocol; /* Routing protocol; see below */
229 unsigned char rtm_scope; /* See below */
230 unsigned char rtm_type; /* See below */
239 RTN_UNICAST, /* Gateway or direct route */
240 RTN_LOCAL, /* Accept locally */
241 RTN_BROADCAST, /* Accept locally as broadcast,
243 RTN_ANYCAST, /* Accept locally as broadcast,
244 but send as unicast */
245 RTN_MULTICAST, /* Multicast route */
246 RTN_BLACKHOLE, /* Drop */
247 RTN_UNREACHABLE, /* Destination is unreachable */
248 RTN_PROHIBIT, /* Administratively prohibited */
249 RTN_THROW, /* Not in this table */
250 RTN_NAT, /* Translate this address */
251 RTN_XRESOLVE, /* Use external resolver */
255 #define RTN_MAX (__RTN_MAX - 1)
260 #define RTPROT_UNSPEC 0
261 #define RTPROT_REDIRECT 1 /* Route installed by ICMP redirects;
262 not used by current IPv4 */
263 #define RTPROT_KERNEL 2 /* Route installed by kernel */
264 #define RTPROT_BOOT 3 /* Route installed during boot */
265 #define RTPROT_STATIC 4 /* Route installed by administrator */
267 /* Values of protocol >= RTPROT_STATIC are not interpreted by kernel;
268 they are just passed from user and back as is.
269 It will be used by hypothetical multiple routing daemons.
270 Note that protocol values should be standardized in order to
274 #define RTPROT_GATED 8 /* Apparently, GateD */
275 #define RTPROT_RA 9 /* RDISC/ND router advertisements */
276 #define RTPROT_MRT 10 /* Merit MRT */
277 #define RTPROT_ZEBRA 11 /* Zebra */
278 #define RTPROT_BIRD 12 /* BIRD */
279 #define RTPROT_DNROUTED 13 /* DECnet routing daemon */
280 #define RTPROT_XORP 14 /* XORP */
281 #define RTPROT_NTK 15 /* Netsukuku */
282 #define RTPROT_DHCP 16 /* DHCP client */
283 #define RTPROT_MROUTED 17 /* Multicast daemon */
284 #define RTPROT_KEEPALIVED 18 /* Keepalived daemon */
285 #define RTPROT_BABEL 42 /* Babel daemon */
286 #define RTPROT_BGP 186 /* BGP Routes */
287 #define RTPROT_ISIS 187 /* ISIS Routes */
288 #define RTPROT_OSPF 188 /* OSPF Routes */
289 #define RTPROT_RIP 189 /* RIP Routes */
290 #define RTPROT_EIGRP 192 /* EIGRP Routes */
294 Really it is not scope, but sort of distance to the destination.
295 NOWHERE are reserved for not existing destinations, HOST is our
296 local addresses, LINK are destinations, located on directly attached
297 link and UNIVERSE is everywhere in the Universe.
299 Intermediate values are also possible f.e. interior routes
300 could be assigned a value between UNIVERSE and LINK.
305 /* User defined values */
314 #define RTM_F_NOTIFY 0x100 /* Notify user of route change */
315 #define RTM_F_CLONED 0x200 /* This route is cloned */
316 #define RTM_F_EQUALIZE 0x400 /* Multipath equalizer: NI */
317 #define RTM_F_PREFIX 0x800 /* Prefix addresses */
318 #define RTM_F_LOOKUP_TABLE 0x1000 /* set rtm_table to FIB lookup result */
319 #define RTM_F_FIB_MATCH 0x2000 /* return full fib lookup match */
320 #define RTM_F_OFFLOAD 0x4000 /* route is offloaded */
321 #define RTM_F_TRAP 0x8000 /* route is trapping packets */
323 /* Reserved table identifiers */
327 /* User defined values */
329 RT_TABLE_DEFAULT=253,
332 RT_TABLE_MAX=0xFFFFFFFF
336 /* Routing message attributes */
349 RTA_PROTOINFO, /* no longer used */
352 RTA_SESSION, /* no longer used */
353 RTA_MP_ALGO, /* no longer used */
373 #define RTA_MAX (__RTA_MAX - 1)
375 #define RTM_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct rtmsg))))
376 #define RTM_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct rtmsg))
378 /* RTM_MULTIPATH --- array of struct rtnexthop.
380 * "struct rtnexthop" describes all necessary nexthop information,
381 * i.e. parameters of path to a destination via this nexthop.
383 * At the moment it is impossible to set different prefsrc, mtu, window
384 * and rtt for different paths from multipath.
388 unsigned short rtnh_len;
389 unsigned char rtnh_flags;
390 unsigned char rtnh_hops;
396 #define RTNH_F_DEAD 1 /* Nexthop is dead (used by multipath) */
397 #define RTNH_F_PERVASIVE 2 /* Do recursive gateway lookup */
398 #define RTNH_F_ONLINK 4 /* Gateway is forced on link */
399 #define RTNH_F_OFFLOAD 8 /* offloaded route */
400 #define RTNH_F_LINKDOWN 16 /* carrier-down on nexthop */
401 #define RTNH_F_UNRESOLVED 32 /* The entry is unresolved (ipmr) */
403 #define RTNH_COMPARE_MASK (RTNH_F_DEAD | RTNH_F_LINKDOWN | RTNH_F_OFFLOAD)
405 /* Macros to handle hexthops */
407 #define RTNH_ALIGNTO 4
408 #define RTNH_ALIGN(len) ( ((len)+RTNH_ALIGNTO-1) & ~(RTNH_ALIGNTO-1) )
409 #define RTNH_OK(rtnh,len) ((rtnh)->rtnh_len >= sizeof(struct rtnexthop) && \
410 ((int)(rtnh)->rtnh_len) <= (len))
411 #define RTNH_NEXT(rtnh) ((struct rtnexthop*)(((char*)(rtnh)) + RTNH_ALIGN((rtnh)->rtnh_len)))
412 #define RTNH_LENGTH(len) (RTNH_ALIGN(sizeof(struct rtnexthop)) + (len))
413 #define RTNH_SPACE(len) RTNH_ALIGN(RTNH_LENGTH(len))
414 #define RTNH_DATA(rtnh) ((struct rtattr*)(((char*)(rtnh)) + RTNH_LENGTH(0)))
418 __kernel_sa_family_t rtvia_family;
424 struct rta_cacheinfo {
431 #define RTNETLINK_HAVE_PEERINFO 1
437 /* RTM_METRICS --- array of struct rtattr with types of RTAX_* */
441 #define RTAX_UNSPEC RTAX_UNSPEC
443 #define RTAX_LOCK RTAX_LOCK
445 #define RTAX_MTU RTAX_MTU
447 #define RTAX_WINDOW RTAX_WINDOW
449 #define RTAX_RTT RTAX_RTT
451 #define RTAX_RTTVAR RTAX_RTTVAR
453 #define RTAX_SSTHRESH RTAX_SSTHRESH
455 #define RTAX_CWND RTAX_CWND
457 #define RTAX_ADVMSS RTAX_ADVMSS
459 #define RTAX_REORDERING RTAX_REORDERING
461 #define RTAX_HOPLIMIT RTAX_HOPLIMIT
463 #define RTAX_INITCWND RTAX_INITCWND
465 #define RTAX_FEATURES RTAX_FEATURES
467 #define RTAX_RTO_MIN RTAX_RTO_MIN
469 #define RTAX_INITRWND RTAX_INITRWND
471 #define RTAX_QUICKACK RTAX_QUICKACK
473 #define RTAX_CC_ALGO RTAX_CC_ALGO
474 RTAX_FASTOPEN_NO_COOKIE,
475 #define RTAX_FASTOPEN_NO_COOKIE RTAX_FASTOPEN_NO_COOKIE
479 #define RTAX_MAX (__RTAX_MAX - 1)
481 #define RTAX_FEATURE_ECN (1 << 0)
482 #define RTAX_FEATURE_SACK (1 << 1)
483 #define RTAX_FEATURE_TIMESTAMP (1 << 2)
484 #define RTAX_FEATURE_ALLFRAG (1 << 3)
486 #define RTAX_FEATURE_MASK (RTAX_FEATURE_ECN | RTAX_FEATURE_SACK | \
487 RTAX_FEATURE_TIMESTAMP | RTAX_FEATURE_ALLFRAG)
510 struct rta_mfc_stats {
517 * General form of address family dependent message.
521 unsigned char rtgen_family;
524 /*****************************************************************
525 * Link layer specific messages.
529 * passes link level specific information, not dependent
530 * on network protocol.
534 unsigned char ifi_family;
535 unsigned char __ifi_pad;
536 unsigned short ifi_type; /* ARPHRD_* */
537 int ifi_index; /* Link index */
538 unsigned ifi_flags; /* IFF_* flags */
539 unsigned ifi_change; /* IFF_* change mask */
542 /********************************************************************
547 unsigned char prefix_family;
548 unsigned char prefix_pad1;
549 unsigned short prefix_pad2;
551 unsigned char prefix_type;
552 unsigned char prefix_len;
553 unsigned char prefix_flags;
554 unsigned char prefix_pad3;
565 #define PREFIX_MAX (__PREFIX_MAX - 1)
567 struct prefix_cacheinfo {
568 __u32 preferred_time;
573 /*****************************************************************
574 * Traffic control messages.
578 unsigned char tcm_family;
579 unsigned char tcm__pad1;
580 unsigned short tcm__pad2;
584 /* tcm_block_index is used instead of tcm_parent
585 * in case tcm_ifindex == TCM_IFINDEX_MAGIC_BLOCK
587 #define tcm_block_index tcm_parent
591 /* For manipulation of filters in shared block, tcm_ifindex is set to
592 * TCM_IFINDEX_MAGIC_BLOCK, and tcm_parent is aliased to tcm_block_index
593 * which is the block index.
595 #define TCM_IFINDEX_MAGIC_BLOCK (0xFFFFFFFFU)
617 #define TCA_MAX (__TCA_MAX - 1)
619 #define TCA_DUMP_FLAGS_TERSE (1 << 0) /* Means that in dump user gets only basic
620 * data necessary to identify the objects
621 * (handle, cookie, etc.) and stats.
624 #define TCA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct tcmsg))))
625 #define TCA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct tcmsg))
627 /********************************************************************
628 * Neighbor Discovery userland options
631 struct nduseroptmsg {
632 unsigned char nduseropt_family;
633 unsigned char nduseropt_pad1;
634 unsigned short nduseropt_opts_len; /* Total length of options */
635 int nduseropt_ifindex;
636 __u8 nduseropt_icmp_type;
637 __u8 nduseropt_icmp_code;
638 unsigned short nduseropt_pad2;
639 unsigned int nduseropt_pad3;
640 /* Followed by one or more ND options */
649 #define NDUSEROPT_MAX (__NDUSEROPT_MAX - 1)
652 /* RTnetlink multicast groups - backwards compatibility for userspace */
653 #define RTMGRP_LINK 1
654 #define RTMGRP_NOTIFY 2
655 #define RTMGRP_NEIGH 4
658 #define RTMGRP_IPV4_IFADDR 0x10
659 #define RTMGRP_IPV4_MROUTE 0x20
660 #define RTMGRP_IPV4_ROUTE 0x40
661 #define RTMGRP_IPV4_RULE 0x80
663 #define RTMGRP_IPV6_IFADDR 0x100
664 #define RTMGRP_IPV6_MROUTE 0x200
665 #define RTMGRP_IPV6_ROUTE 0x400
666 #define RTMGRP_IPV6_IFINFO 0x800
668 #define RTMGRP_DECnet_IFADDR 0x1000
669 #define RTMGRP_DECnet_ROUTE 0x4000
671 #define RTMGRP_IPV6_PREFIX 0x20000
674 /* RTnetlink multicast groups */
675 enum rtnetlink_groups {
677 #define RTNLGRP_NONE RTNLGRP_NONE
679 #define RTNLGRP_LINK RTNLGRP_LINK
681 #define RTNLGRP_NOTIFY RTNLGRP_NOTIFY
683 #define RTNLGRP_NEIGH RTNLGRP_NEIGH
685 #define RTNLGRP_TC RTNLGRP_TC
687 #define RTNLGRP_IPV4_IFADDR RTNLGRP_IPV4_IFADDR
689 #define RTNLGRP_IPV4_MROUTE RTNLGRP_IPV4_MROUTE
691 #define RTNLGRP_IPV4_ROUTE RTNLGRP_IPV4_ROUTE
693 #define RTNLGRP_IPV4_RULE RTNLGRP_IPV4_RULE
695 #define RTNLGRP_IPV6_IFADDR RTNLGRP_IPV6_IFADDR
697 #define RTNLGRP_IPV6_MROUTE RTNLGRP_IPV6_MROUTE
699 #define RTNLGRP_IPV6_ROUTE RTNLGRP_IPV6_ROUTE
701 #define RTNLGRP_IPV6_IFINFO RTNLGRP_IPV6_IFINFO
702 RTNLGRP_DECnet_IFADDR,
703 #define RTNLGRP_DECnet_IFADDR RTNLGRP_DECnet_IFADDR
705 RTNLGRP_DECnet_ROUTE,
706 #define RTNLGRP_DECnet_ROUTE RTNLGRP_DECnet_ROUTE
708 #define RTNLGRP_DECnet_RULE RTNLGRP_DECnet_RULE
711 #define RTNLGRP_IPV6_PREFIX RTNLGRP_IPV6_PREFIX
713 #define RTNLGRP_IPV6_RULE RTNLGRP_IPV6_RULE
715 #define RTNLGRP_ND_USEROPT RTNLGRP_ND_USEROPT
716 RTNLGRP_PHONET_IFADDR,
717 #define RTNLGRP_PHONET_IFADDR RTNLGRP_PHONET_IFADDR
718 RTNLGRP_PHONET_ROUTE,
719 #define RTNLGRP_PHONET_ROUTE RTNLGRP_PHONET_ROUTE
721 #define RTNLGRP_DCB RTNLGRP_DCB
722 RTNLGRP_IPV4_NETCONF,
723 #define RTNLGRP_IPV4_NETCONF RTNLGRP_IPV4_NETCONF
724 RTNLGRP_IPV6_NETCONF,
725 #define RTNLGRP_IPV6_NETCONF RTNLGRP_IPV6_NETCONF
727 #define RTNLGRP_MDB RTNLGRP_MDB
729 #define RTNLGRP_MPLS_ROUTE RTNLGRP_MPLS_ROUTE
731 #define RTNLGRP_NSID RTNLGRP_NSID
732 RTNLGRP_MPLS_NETCONF,
733 #define RTNLGRP_MPLS_NETCONF RTNLGRP_MPLS_NETCONF
734 RTNLGRP_IPV4_MROUTE_R,
735 #define RTNLGRP_IPV4_MROUTE_R RTNLGRP_IPV4_MROUTE_R
736 RTNLGRP_IPV6_MROUTE_R,
737 #define RTNLGRP_IPV6_MROUTE_R RTNLGRP_IPV6_MROUTE_R
739 #define RTNLGRP_NEXTHOP RTNLGRP_NEXTHOP
741 #define RTNLGRP_BRVLAN RTNLGRP_BRVLAN
744 #define RTNLGRP_MAX (__RTNLGRP_MAX - 1)
746 /* TC action piece */
748 unsigned char tca_family;
749 unsigned char tca__pad1;
750 unsigned short tca__pad2;
756 #define TCA_ACT_TAB TCA_ROOT_TAB
757 #define TCAA_MAX TCA_ROOT_TAB
760 TCA_ROOT_TIME_DELTA, /* in msecs */
762 #define TCA_ROOT_MAX (__TCA_ROOT_MAX - 1)
765 #define TA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct tcamsg))))
766 #define TA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct tcamsg))
767 /* tcamsg flags stored in attribute TCA_ROOT_FLAGS
769 * TCA_FLAG_LARGE_DUMP_ON user->kernel to request for larger than TCA_ACT_MAX_PRIO
770 * actions in a dump. All dump responses will contain the number of actions
771 * being dumped stored in for user app's consumption in TCA_ROOT_COUNT
774 #define TCA_FLAG_LARGE_DUMP_ON (1 << 0)
776 /* New extended info filters for IFLA_EXT_MASK */
777 #define RTEXT_FILTER_VF (1 << 0)
778 #define RTEXT_FILTER_BRVLAN (1 << 1)
779 #define RTEXT_FILTER_BRVLAN_COMPRESSED (1 << 2)
780 #define RTEXT_FILTER_SKIP_STATS (1 << 3)
781 #define RTEXT_FILTER_MRP (1 << 4)
783 /* End of information exported to user level */
787 #endif /* _UAPI__LINUX_RTNETLINK_H */