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