xref: /linux-6.15/include/linux/rtnetlink.h (revision 2ff40400)
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 
21 /* RTNL is used as a global lock for all changes to network configuration  */
22 extern void rtnl_lock(void);
23 extern void rtnl_unlock(void);
24 extern int rtnl_trylock(void);
25 extern int rtnl_is_locked(void);
26 
27 extern wait_queue_head_t netdev_unregistering_wq;
28 extern struct mutex net_mutex;
29 
30 #ifdef CONFIG_PROVE_LOCKING
31 extern int lockdep_rtnl_is_held(void);
32 #else
33 static inline int lockdep_rtnl_is_held(void)
34 {
35 	return 1;
36 }
37 #endif /* #ifdef CONFIG_PROVE_LOCKING */
38 
39 /**
40  * rcu_dereference_rtnl - rcu_dereference with debug checking
41  * @p: The pointer to read, prior to dereferencing
42  *
43  * Do an rcu_dereference(p), but check caller either holds rcu_read_lock()
44  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference()
45  */
46 #define rcu_dereference_rtnl(p)					\
47 	rcu_dereference_check(p, lockdep_rtnl_is_held())
48 
49 /**
50  * rcu_dereference_bh_rtnl - rcu_dereference_bh with debug checking
51  * @p: The pointer to read, prior to dereference
52  *
53  * Do an rcu_dereference_bh(p), but check caller either holds rcu_read_lock_bh()
54  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference_bh()
55  */
56 #define rcu_dereference_bh_rtnl(p)				\
57 	rcu_dereference_bh_check(p, lockdep_rtnl_is_held())
58 
59 /**
60  * rtnl_dereference - fetch RCU pointer when updates are prevented by RTNL
61  * @p: The pointer to read, prior to dereferencing
62  *
63  * Return the value of the specified RCU-protected pointer, but omit
64  * both the smp_read_barrier_depends() and the ACCESS_ONCE(), because
65  * caller holds RTNL.
66  */
67 #define rtnl_dereference(p)					\
68 	rcu_dereference_protected(p, lockdep_rtnl_is_held())
69 
70 static inline struct netdev_queue *dev_ingress_queue(struct net_device *dev)
71 {
72 	return rtnl_dereference(dev->ingress_queue);
73 }
74 
75 extern struct netdev_queue *dev_ingress_queue_create(struct net_device *dev);
76 
77 extern void rtnetlink_init(void);
78 extern void __rtnl_unlock(void);
79 
80 #define ASSERT_RTNL() do { \
81 	if (unlikely(!rtnl_is_locked())) { \
82 		printk(KERN_ERR "RTNL: assertion failed at %s (%d)\n", \
83 		       __FILE__,  __LINE__); \
84 		dump_stack(); \
85 	} \
86 } while(0)
87 
88 extern int ndo_dflt_fdb_dump(struct sk_buff *skb,
89 			     struct netlink_callback *cb,
90 			     struct net_device *dev,
91 			     struct net_device *filter_dev,
92 			     int idx);
93 extern int ndo_dflt_fdb_add(struct ndmsg *ndm,
94 			    struct nlattr *tb[],
95 			    struct net_device *dev,
96 			    const unsigned char *addr,
97 			     u16 flags);
98 extern int ndo_dflt_fdb_del(struct ndmsg *ndm,
99 			    struct nlattr *tb[],
100 			    struct net_device *dev,
101 			    const unsigned char *addr);
102 
103 extern int ndo_dflt_bridge_getlink(struct sk_buff *skb, u32 pid, u32 seq,
104 				   struct net_device *dev, u16 mode);
105 #endif	/* __LINUX_RTNETLINK_H */
106