1 #ifndef __LINUX_RTNETLINK_H
2 #define __LINUX_RTNETLINK_H
4 #include <linux/netlink.h>
7 * Routing/neighbour discovery messages.
10 /* Types of messages */
14 #define RTM_BASE RTM_BASE
17 #define RTM_NEWLINK RTM_NEWLINK
19 #define RTM_DELLINK RTM_DELLINK
21 #define RTM_GETLINK RTM_GETLINK
23 #define RTM_SETLINK RTM_SETLINK
26 #define RTM_NEWADDR RTM_NEWADDR
28 #define RTM_DELADDR RTM_DELADDR
30 #define RTM_GETADDR RTM_GETADDR
33 #define RTM_NEWROUTE RTM_NEWROUTE
35 #define RTM_DELROUTE RTM_DELROUTE
37 #define RTM_GETROUTE RTM_GETROUTE
40 #define RTM_NEWNEIGH RTM_NEWNEIGH
42 #define RTM_DELNEIGH RTM_DELNEIGH
44 #define RTM_GETNEIGH RTM_GETNEIGH
47 #define RTM_NEWRULE RTM_NEWRULE
49 #define RTM_DELRULE RTM_DELRULE
51 #define RTM_GETRULE RTM_GETRULE
54 #define RTM_NEWQDISC RTM_NEWQDISC
56 #define RTM_DELQDISC RTM_DELQDISC
58 #define RTM_GETQDISC RTM_GETQDISC
61 #define RTM_NEWTCLASS RTM_NEWTCLASS
63 #define RTM_DELTCLASS RTM_DELTCLASS
65 #define RTM_GETTCLASS RTM_GETTCLASS
68 #define RTM_NEWTFILTER RTM_NEWTFILTER
70 #define RTM_DELTFILTER RTM_DELTFILTER
72 #define RTM_GETTFILTER RTM_GETTFILTER
75 #define RTM_NEWACTION RTM_NEWACTION
77 #define RTM_DELACTION RTM_DELACTION
79 #define RTM_GETACTION RTM_GETACTION
82 #define RTM_NEWPREFIX RTM_NEWPREFIX
84 #define RTM_GETPREFIX RTM_GETPREFIX
86 RTM_GETMULTICAST = 58,
87 #define RTM_GETMULTICAST RTM_GETMULTICAST
90 #define RTM_GETANYCAST RTM_GETANYCAST
93 #define RTM_MAX (((__RTM_MAX + 3) & ~3) - 1)
96 #define RTM_FAM(cmd) (((cmd) - RTM_BASE) >> 2)
99 Generic structure for encapsulation of optional route information.
100 It is reminiscent of sockaddr, but with sa_family replaced
106 unsigned short rta_len;
107 unsigned short rta_type;
110 /* Macros to handle rtattributes */
112 #define RTA_ALIGNTO 4
113 #define RTA_ALIGN(len) ( ((len)+RTA_ALIGNTO-1) & ~(RTA_ALIGNTO-1) )
114 #define RTA_OK(rta,len) ((len) >= (int)sizeof(struct rtattr) && \
115 (rta)->rta_len >= sizeof(struct rtattr) && \
116 (rta)->rta_len <= (len))
117 #define RTA_NEXT(rta,attrlen) ((attrlen) -= RTA_ALIGN((rta)->rta_len), \
118 (struct rtattr*)(((char*)(rta)) + RTA_ALIGN((rta)->rta_len)))
119 #define RTA_LENGTH(len) (RTA_ALIGN(sizeof(struct rtattr)) + (len))
120 #define RTA_SPACE(len) RTA_ALIGN(RTA_LENGTH(len))
121 #define RTA_DATA(rta) ((void*)(((char*)(rta)) + RTA_LENGTH(0)))
122 #define RTA_PAYLOAD(rta) ((int)((rta)->rta_len) - RTA_LENGTH(0))
127 /******************************************************************************
128 * Definitions used in routing table administration.
133 unsigned char rtm_family;
134 unsigned char rtm_dst_len;
135 unsigned char rtm_src_len;
136 unsigned char rtm_tos;
138 unsigned char rtm_table; /* Routing table id */
139 unsigned char rtm_protocol; /* Routing protocol; see below */
140 unsigned char rtm_scope; /* See below */
141 unsigned char rtm_type; /* See below */
151 RTN_UNICAST, /* Gateway or direct route */
152 RTN_LOCAL, /* Accept locally */
153 RTN_BROADCAST, /* Accept locally as broadcast,
155 RTN_ANYCAST, /* Accept locally as broadcast,
156 but send as unicast */
157 RTN_MULTICAST, /* Multicast route */
158 RTN_BLACKHOLE, /* Drop */
159 RTN_UNREACHABLE, /* Destination is unreachable */
160 RTN_PROHIBIT, /* Administratively prohibited */
161 RTN_THROW, /* Not in this table */
162 RTN_NAT, /* Translate this address */
163 RTN_XRESOLVE, /* Use external resolver */
167 #define RTN_MAX (__RTN_MAX - 1)
172 #define RTPROT_UNSPEC 0
173 #define RTPROT_REDIRECT 1 /* Route installed by ICMP redirects;
174 not used by current IPv4 */
175 #define RTPROT_KERNEL 2 /* Route installed by kernel */
176 #define RTPROT_BOOT 3 /* Route installed during boot */
177 #define RTPROT_STATIC 4 /* Route installed by administrator */
179 /* Values of protocol >= RTPROT_STATIC are not interpreted by kernel;
180 they are just passed from user and back as is.
181 It will be used by hypothetical multiple routing daemons.
182 Note that protocol values should be standardized in order to
186 #define RTPROT_GATED 8 /* Apparently, GateD */
187 #define RTPROT_RA 9 /* RDISC/ND router advertisements */
188 #define RTPROT_MRT 10 /* Merit MRT */
189 #define RTPROT_ZEBRA 11 /* Zebra */
190 #define RTPROT_BIRD 12 /* BIRD */
191 #define RTPROT_DNROUTED 13 /* DECnet routing daemon */
192 #define RTPROT_XORP 14 /* XORP */
196 Really it is not scope, but sort of distance to the destination.
197 NOWHERE are reserved for not existing destinations, HOST is our
198 local addresses, LINK are destinations, located on directly attached
199 link and UNIVERSE is everywhere in the Universe.
201 Intermediate values are also possible f.e. interior routes
202 could be assigned a value between UNIVERSE and LINK.
208 /* User defined values */
217 #define RTM_F_NOTIFY 0x100 /* Notify user of route change */
218 #define RTM_F_CLONED 0x200 /* This route is cloned */
219 #define RTM_F_EQUALIZE 0x400 /* Multipath equalizer: NI */
220 #define RTM_F_PREFIX 0x800 /* Prefix addresses */
222 /* Reserved table identifiers */
227 /* User defined values */
228 RT_TABLE_DEFAULT=253,
233 #define RT_TABLE_MAX (__RT_TABLE_MAX - 1)
237 /* Routing message attributes */
259 #define RTA_MAX (__RTA_MAX - 1)
261 #define RTM_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct rtmsg))))
262 #define RTM_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct rtmsg))
264 /* RTM_MULTIPATH --- array of struct rtnexthop.
266 * "struct rtnexthop" describes all necessary nexthop information,
267 * i.e. parameters of path to a destination via this nexthop.
269 * At the moment it is impossible to set different prefsrc, mtu, window
270 * and rtt for different paths from multipath.
275 unsigned short rtnh_len;
276 unsigned char rtnh_flags;
277 unsigned char rtnh_hops;
283 #define RTNH_F_DEAD 1 /* Nexthop is dead (used by multipath) */
284 #define RTNH_F_PERVASIVE 2 /* Do recursive gateway lookup */
285 #define RTNH_F_ONLINK 4 /* Gateway is forced on link */
287 /* Macros to handle hexthops */
289 #define RTNH_ALIGNTO 4
290 #define RTNH_ALIGN(len) ( ((len)+RTNH_ALIGNTO-1) & ~(RTNH_ALIGNTO-1) )
291 #define RTNH_OK(rtnh,len) ((rtnh)->rtnh_len >= sizeof(struct rtnexthop) && \
292 ((int)(rtnh)->rtnh_len) <= (len))
293 #define RTNH_NEXT(rtnh) ((struct rtnexthop*)(((char*)(rtnh)) + RTNH_ALIGN((rtnh)->rtnh_len)))
294 #define RTNH_LENGTH(len) (RTNH_ALIGN(sizeof(struct rtnexthop)) + (len))
295 #define RTNH_SPACE(len) RTNH_ALIGN(RTNH_LENGTH(len))
296 #define RTNH_DATA(rtnh) ((struct rtattr*)(((char*)(rtnh)) + RTNH_LENGTH(0)))
308 #define RTNETLINK_HAVE_PEERINFO 1
314 /* RTM_METRICS --- array of struct rtattr with types of RTAX_* */
319 #define RTAX_UNSPEC RTAX_UNSPEC
321 #define RTAX_LOCK RTAX_LOCK
323 #define RTAX_MTU RTAX_MTU
325 #define RTAX_WINDOW RTAX_WINDOW
327 #define RTAX_RTT RTAX_RTT
329 #define RTAX_RTTVAR RTAX_RTTVAR
331 #define RTAX_SSTHRESH RTAX_SSTHRESH
333 #define RTAX_CWND RTAX_CWND
335 #define RTAX_ADVMSS RTAX_ADVMSS
337 #define RTAX_REORDERING RTAX_REORDERING
339 #define RTAX_HOPLIMIT RTAX_HOPLIMIT
341 #define RTAX_INITCWND RTAX_INITCWND
343 #define RTAX_FEATURES RTAX_FEATURES
347 #define RTAX_MAX (__RTAX_MAX - 1)
349 #define RTAX_FEATURE_ECN 0x00000001
350 #define RTAX_FEATURE_SACK 0x00000002
351 #define RTAX_FEATURE_TIMESTAMP 0x00000004
352 #define RTAX_FEATURE_ALLFRAG 0x00000008
375 /*********************************************************
381 unsigned char ifa_family;
382 unsigned char ifa_prefixlen; /* The prefix length */
383 unsigned char ifa_flags; /* Flags */
384 unsigned char ifa_scope; /* See above */
385 int ifa_index; /* Link index */
401 #define IFA_MAX (__IFA_MAX - 1)
405 #define IFA_F_SECONDARY 0x01
406 #define IFA_F_TEMPORARY IFA_F_SECONDARY
408 #define IFA_F_DEPRECATED 0x20
409 #define IFA_F_TENTATIVE 0x40
410 #define IFA_F_PERMANENT 0x80
416 __u32 cstamp; /* created timestamp, hundredths of seconds */
417 __u32 tstamp; /* updated timestamp, hundredths of seconds */
421 #define IFA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct ifaddrmsg))))
422 #define IFA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct ifaddrmsg))
426 IFA_ADDRESS is prefix address, rather than local interface address.
427 It makes no difference for normally configured broadcast interfaces,
428 but for point-to-point IFA_ADDRESS is DESTINATION address,
429 local address is supplied in IFA_LOCAL attribute.
432 /**************************************************************
433 * Neighbour discovery.
438 unsigned char ndm_family;
439 unsigned char ndm_pad1;
440 unsigned short ndm_pad2;
441 int ndm_ifindex; /* Link index */
457 #define NDA_MAX (__NDA_MAX - 1)
459 #define NDA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct ndmsg))))
460 #define NDA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct ndmsg))
463 * Neighbor Cache Entry Flags
466 #define NTF_PROXY 0x08 /* == ATF_PUBL */
467 #define NTF_ROUTER 0x80
470 * Neighbor Cache Entry States.
473 #define NUD_INCOMPLETE 0x01
474 #define NUD_REACHABLE 0x02
475 #define NUD_STALE 0x04
476 #define NUD_DELAY 0x08
477 #define NUD_PROBE 0x10
478 #define NUD_FAILED 0x20
481 #define NUD_NOARP 0x40
482 #define NUD_PERMANENT 0x80
483 #define NUD_NONE 0x00
495 * General form of address family dependent message.
500 unsigned char rtgen_family;
503 /*****************************************************************
504 * Link layer specific messages.
508 * passes link level specific information, not dependent
509 * on network protocol.
514 unsigned char ifi_family;
515 unsigned char __ifi_pad;
516 unsigned short ifi_type; /* ARPHRD_* */
517 int ifi_index; /* Link index */
518 unsigned ifi_flags; /* IFF_* flags */
519 unsigned ifi_change; /* IFF_* change mask */
522 /********************************************************************
528 unsigned char prefix_family;
530 unsigned char prefix_type;
531 unsigned char prefix_len;
532 unsigned char prefix_flags;
543 #define PREFIX_MAX (__PREFIX_MAX - 1)
545 struct prefix_cacheinfo
547 __u32 preferred_time;
551 /* The struct should be in sync with struct net_device_stats */
552 struct rtnl_link_stats
554 __u32 rx_packets; /* total packets received */
555 __u32 tx_packets; /* total packets transmitted */
556 __u32 rx_bytes; /* total bytes received */
557 __u32 tx_bytes; /* total bytes transmitted */
558 __u32 rx_errors; /* bad packets received */
559 __u32 tx_errors; /* packet transmit problems */
560 __u32 rx_dropped; /* no space in linux buffers */
561 __u32 tx_dropped; /* no space available in linux */
562 __u32 multicast; /* multicast packets received */
565 /* detailed rx_errors: */
566 __u32 rx_length_errors;
567 __u32 rx_over_errors; /* receiver ring buff overflow */
568 __u32 rx_crc_errors; /* recved pkt with crc error */
569 __u32 rx_frame_errors; /* recv'd frame alignment error */
570 __u32 rx_fifo_errors; /* recv'r fifo overrun */
571 __u32 rx_missed_errors; /* receiver missed packet */
573 /* detailed tx_errors */
574 __u32 tx_aborted_errors;
575 __u32 tx_carrier_errors;
576 __u32 tx_fifo_errors;
577 __u32 tx_heartbeat_errors;
578 __u32 tx_window_errors;
585 /* The struct should be in sync with struct ifmap */
586 struct rtnl_link_ifmap
607 #define IFLA_COST IFLA_COST
609 #define IFLA_PRIORITY IFLA_PRIORITY
611 #define IFLA_MASTER IFLA_MASTER
612 IFLA_WIRELESS, /* Wireless Extension event - see wireless.h */
613 #define IFLA_WIRELESS IFLA_WIRELESS
614 IFLA_PROTINFO, /* Protocol specific information for a link */
615 #define IFLA_PROTINFO IFLA_PROTINFO
617 #define IFLA_TXQLEN IFLA_TXQLEN
619 #define IFLA_MAP IFLA_MAP
621 #define IFLA_WEIGHT IFLA_WEIGHT
626 #define IFLA_MAX (__IFLA_MAX - 1)
628 #define IFLA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct ifinfomsg))))
629 #define IFLA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct ifinfomsg))
636 IFF_LOOPBACK, IFF_BROADCAST and IFF_POINTOPOINT are
637 more not changeable by user. They describe link media
638 characteristics and set by device driver.
641 - Combination IFF_BROADCAST|IFF_POINTOPOINT is invalid
642 - If neither of these three flags are set;
643 the interface is NBMA.
645 - IFF_MULTICAST does not mean anything special:
646 multicasts can be used on all not-NBMA links.
647 IFF_MULTICAST means that this media uses special encapsulation
648 for multicast frames. Apparently, all IFF_POINTOPOINT and
649 IFF_BROADCAST devices are able to use multicasts too.
653 For usual devices it is equal ifi_index.
654 If it is a "virtual interface" (f.e. tunnel), ifi_link
655 can point to real physical interface (f.e. for bandwidth calculations),
656 or maybe 0, what means, that real media is unknown (usual
657 for IPIP tunnels, when route to endpoint is allowed to change)
660 /* Subtype attributes for IFLA_PROTINFO */
664 IFLA_INET6_FLAGS, /* link flags */
665 IFLA_INET6_CONF, /* sysctl parameters */
666 IFLA_INET6_STATS, /* statistics */
667 IFLA_INET6_MCAST, /* MC things. What of them? */
668 IFLA_INET6_CACHEINFO, /* time values and max reasm size */
672 #define IFLA_INET6_MAX (__IFLA_INET6_MAX - 1)
674 struct ifla_cacheinfo
677 __u32 tstamp; /* ipv6InterfaceTable updated timestamp */
678 __u32 reachable_time;
682 /*****************************************************************
683 * Traffic control messages.
688 unsigned char tcm_family;
689 unsigned char tcm__pad1;
690 unsigned short tcm__pad2;
710 #define TCA_MAX (__TCA_MAX - 1)
712 #define TCA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct tcmsg))))
713 #define TCA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct tcmsg))
716 /* RTnetlink multicast groups */
718 #define RTMGRP_LINK 1
719 #define RTMGRP_NOTIFY 2
720 #define RTMGRP_NEIGH 4
723 #define RTMGRP_IPV4_IFADDR 0x10
724 #define RTMGRP_IPV4_MROUTE 0x20
725 #define RTMGRP_IPV4_ROUTE 0x40
727 #define RTMGRP_IPV6_IFADDR 0x100
728 #define RTMGRP_IPV6_MROUTE 0x200
729 #define RTMGRP_IPV6_ROUTE 0x400
730 #define RTMGRP_IPV6_IFINFO 0x800
732 #define RTMGRP_DECnet_IFADDR 0x1000
733 #define RTMGRP_DECnet_ROUTE 0x4000
735 #define RTMGRP_IPV6_PREFIX 0x20000
737 /* TC action piece */
740 unsigned char tca_family;
741 unsigned char tca__pad1;
742 unsigned short tca__pad2;
744 #define TA_RTA(r) ((struct rtattr*)(((char*)(r)) + NLMSG_ALIGN(sizeof(struct tcamsg))))
745 #define TA_PAYLOAD(n) NLMSG_PAYLOAD(n,sizeof(struct tcamsg))
746 #define TCA_ACT_TAB 1 /* attr type must be >=1 */
749 /* End of information exported to user level */
753 #include <linux/config.h>
755 extern size_t rtattr_strlcpy(char *dest, const struct rtattr *rta, size_t size);
756 static __inline__ int rtattr_strcmp(const struct rtattr *rta, const char *str)
758 int len = strlen(str) + 1;
759 return len > rta->rta_len || memcmp(RTA_DATA(rta), str, len);
762 extern int rtattr_parse(struct rtattr *tb[], int maxattr, struct rtattr *rta, int len);
764 #define rtattr_parse_nested(tb, max, rta) \
765 rtattr_parse((tb), (max), RTA_DATA((rta)), RTA_PAYLOAD((rta)))
767 extern struct sock *rtnl;
769 struct rtnetlink_link
771 int (*doit)(struct sk_buff *, struct nlmsghdr*, void *attr);
772 int (*dumpit)(struct sk_buff *, struct netlink_callback *cb);
775 extern struct rtnetlink_link * rtnetlink_links[NPROTO];
776 extern int rtnetlink_send(struct sk_buff *skb, u32 pid, u32 group, int echo);
777 extern int rtnetlink_put_metrics(struct sk_buff *skb, u32 *metrics);
779 extern void __rta_fill(struct sk_buff *skb, int attrtype, int attrlen, const void *data);
781 #define RTA_PUT(skb, attrtype, attrlen, data) \
782 ({ if (unlikely(skb_tailroom(skb) < (int)RTA_SPACE(attrlen))) \
783 goto rtattr_failure; \
784 __rta_fill(skb, attrtype, attrlen, data); })
786 #define RTA_PUT_NOHDR(skb, attrlen, data) \
787 ({ if (unlikely(skb_tailroom(skb) < (int)(attrlen))) \
788 goto rtattr_failure; \
789 memcpy(skb_put(skb, RTA_ALIGN(attrlen)), data, attrlen); })
791 static inline struct rtattr *
792 __rta_reserve(struct sk_buff *skb, int attrtype, int attrlen)
795 int size = RTA_LENGTH(attrlen);
797 rta = (struct rtattr*)skb_put(skb, RTA_ALIGN(size));
798 rta->rta_type = attrtype;
803 #define __RTA_PUT(skb, attrtype, attrlen) \
804 ({ if (unlikely(skb_tailroom(skb) < (int)RTA_SPACE(attrlen))) \
805 goto rtattr_failure; \
806 __rta_reserve(skb, attrtype, attrlen); })
808 extern void rtmsg_ifinfo(int type, struct net_device *dev, unsigned change);
810 extern struct semaphore rtnl_sem;
812 #define rtnl_shlock() down(&rtnl_sem)
813 #define rtnl_shlock_nowait() down_trylock(&rtnl_sem)
815 #define rtnl_shunlock() do { up(&rtnl_sem); \
816 if (rtnl && rtnl->sk_receive_queue.qlen) \
817 rtnl->sk_data_ready(rtnl, 0); \
820 extern void rtnl_lock(void);
821 extern int rtnl_lock_interruptible(void);
822 extern void rtnl_unlock(void);
823 extern void rtnetlink_init(void);
825 #define ASSERT_RTNL() do { \
826 if (unlikely(down_trylock(&rtnl_sem) == 0)) { \
828 printk(KERN_ERR "RTNL: assertion failed at %s (%d)\n", \
829 __FILE__, __LINE__); \
834 #define BUG_TRAP(x) do { \
835 if (unlikely(!(x))) { \
836 printk(KERN_ERR "KERNEL: assertion (%s) failed at %s (%d)\n", \
837 #x, __FILE__ , __LINE__); \
841 #endif /* __KERNEL__ */
844 #endif /* __LINUX_RTNETLINK_H */