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