xref: /linux-6.15/include/linux/rtnetlink.h (revision 548ec114)
1 #ifndef __LINUX_RTNETLINK_H
2 #define __LINUX_RTNETLINK_H
3 
4 
5 #include <linux/mutex.h>
6 #include <linux/netdevice.h>
7 #include <linux/wait.h>
8 #include <uapi/linux/rtnetlink.h>
9 
10 extern int rtnetlink_send(struct sk_buff *skb, struct net *net, u32 pid, u32 group, int echo);
11 extern int rtnl_unicast(struct sk_buff *skb, struct net *net, u32 pid);
12 extern void rtnl_notify(struct sk_buff *skb, struct net *net, u32 pid,
13 			u32 group, struct nlmsghdr *nlh, gfp_t flags);
14 extern void rtnl_set_sk_err(struct net *net, u32 group, int error);
15 extern int rtnetlink_put_metrics(struct sk_buff *skb, u32 *metrics);
16 extern int rtnl_put_cacheinfo(struct sk_buff *skb, struct dst_entry *dst,
17 			      u32 id, long expires, u32 error);
18 
19 void rtmsg_ifinfo(int type, struct net_device *dev, unsigned change, gfp_t flags);
20 void rtmsg_ifinfo_newnet(int type, struct net_device *dev, unsigned int change,
21 			 gfp_t flags, int *new_nsid);
22 struct sk_buff *rtmsg_ifinfo_build_skb(int type, struct net_device *dev,
23 				       unsigned change, u32 event,
24 				       gfp_t flags, int *new_nsid);
25 void rtmsg_ifinfo_send(struct sk_buff *skb, struct net_device *dev,
26 		       gfp_t flags);
27 
28 
29 /* RTNL is used as a global lock for all changes to network configuration  */
30 extern void rtnl_lock(void);
31 extern void rtnl_unlock(void);
32 extern int rtnl_trylock(void);
33 extern int rtnl_is_locked(void);
34 
35 extern wait_queue_head_t netdev_unregistering_wq;
36 extern struct mutex net_mutex;
37 
38 #ifdef CONFIG_PROVE_LOCKING
39 extern bool lockdep_rtnl_is_held(void);
40 #else
41 static inline bool lockdep_rtnl_is_held(void)
42 {
43 	return true;
44 }
45 #endif /* #ifdef CONFIG_PROVE_LOCKING */
46 
47 /**
48  * rcu_dereference_rtnl - rcu_dereference with debug checking
49  * @p: The pointer to read, prior to dereferencing
50  *
51  * Do an rcu_dereference(p), but check caller either holds rcu_read_lock()
52  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference()
53  */
54 #define rcu_dereference_rtnl(p)					\
55 	rcu_dereference_check(p, lockdep_rtnl_is_held())
56 
57 /**
58  * rcu_dereference_bh_rtnl - rcu_dereference_bh with debug checking
59  * @p: The pointer to read, prior to dereference
60  *
61  * Do an rcu_dereference_bh(p), but check caller either holds rcu_read_lock_bh()
62  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference_bh()
63  */
64 #define rcu_dereference_bh_rtnl(p)				\
65 	rcu_dereference_bh_check(p, lockdep_rtnl_is_held())
66 
67 /**
68  * rtnl_dereference - fetch RCU pointer when updates are prevented by RTNL
69  * @p: The pointer to read, prior to dereferencing
70  *
71  * Return the value of the specified RCU-protected pointer, but omit
72  * both the smp_read_barrier_depends() and the ACCESS_ONCE(), because
73  * caller holds RTNL.
74  */
75 #define rtnl_dereference(p)					\
76 	rcu_dereference_protected(p, lockdep_rtnl_is_held())
77 
78 static inline struct netdev_queue *dev_ingress_queue(struct net_device *dev)
79 {
80 	return rtnl_dereference(dev->ingress_queue);
81 }
82 
83 struct netdev_queue *dev_ingress_queue_create(struct net_device *dev);
84 
85 #ifdef CONFIG_NET_INGRESS
86 void net_inc_ingress_queue(void);
87 void net_dec_ingress_queue(void);
88 #endif
89 
90 #ifdef CONFIG_NET_EGRESS
91 void net_inc_egress_queue(void);
92 void net_dec_egress_queue(void);
93 #endif
94 
95 void rtnetlink_init(void);
96 void __rtnl_unlock(void);
97 void rtnl_kfree_skbs(struct sk_buff *head, struct sk_buff *tail);
98 
99 #define ASSERT_RTNL() do { \
100 	if (unlikely(!rtnl_is_locked())) { \
101 		printk(KERN_ERR "RTNL: assertion failed at %s (%d)\n", \
102 		       __FILE__,  __LINE__); \
103 		dump_stack(); \
104 	} \
105 } while(0)
106 
107 extern int ndo_dflt_fdb_dump(struct sk_buff *skb,
108 			     struct netlink_callback *cb,
109 			     struct net_device *dev,
110 			     struct net_device *filter_dev,
111 			     int *idx);
112 extern int ndo_dflt_fdb_add(struct ndmsg *ndm,
113 			    struct nlattr *tb[],
114 			    struct net_device *dev,
115 			    const unsigned char *addr,
116 			    u16 vid,
117 			    u16 flags);
118 extern int ndo_dflt_fdb_del(struct ndmsg *ndm,
119 			    struct nlattr *tb[],
120 			    struct net_device *dev,
121 			    const unsigned char *addr,
122 			    u16 vid);
123 
124 extern int ndo_dflt_bridge_getlink(struct sk_buff *skb, u32 pid, u32 seq,
125 				   struct net_device *dev, u16 mode,
126 				   u32 flags, u32 mask, int nlflags,
127 				   u32 filter_mask,
128 				   int (*vlan_fill)(struct sk_buff *skb,
129 						    struct net_device *dev,
130 						    u32 filter_mask));
131 #endif	/* __LINUX_RTNETLINK_H */
132