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