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
12extern int rtnetlink_send(struct sk_buff *skb, struct net *net, u32 pid, u32 group, int echo);
13extern int rtnl_unicast(struct sk_buff *skb, struct net *net, u32 pid);
14extern void rtnl_notify(struct sk_buff *skb, struct net *net, u32 pid,
15 u32 group, struct nlmsghdr *nlh, gfp_t flags);
16extern void rtnl_set_sk_err(struct net *net, u32 group, int error);
17extern int rtnetlink_put_metrics(struct sk_buff *skb, u32 *metrics);
18extern int rtnl_put_cacheinfo(struct sk_buff *skb, struct dst_entry *dst,
19 u32 id, long expires, u32 error);
20
21void rtmsg_ifinfo(int type, struct net_device *dev, unsigned change, gfp_t flags);
22void rtmsg_ifinfo_newnet(int type, struct net_device *dev, unsigned int change,
23 gfp_t flags, int *new_nsid, int new_ifindex);
24struct 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);
28void 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 */
33extern void rtnl_lock(void);
34extern void rtnl_unlock(void);
35extern int rtnl_trylock(void);
36extern int rtnl_is_locked(void);
37extern int rtnl_lock_killable(void);
38extern bool refcount_dec_and_rtnl_lock(refcount_t *r);
39
40extern wait_queue_head_t netdev_unregistering_wq;
41extern struct rw_semaphore pernet_ops_rwsem;
42extern struct rw_semaphore net_rwsem;
43
44#ifdef CONFIG_PROVE_LOCKING
45extern bool lockdep_rtnl_is_held(void);
46#else
47static 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
83static inline struct netdev_queue *dev_ingress_queue(struct net_device *dev)
84{
85 return rtnl_dereference(dev->ingress_queue);
86}
87
88static inline struct netdev_queue *dev_ingress_queue_rcu(struct net_device *dev)
89{
90 return rcu_dereference(dev->ingress_queue);
91}
92
93struct netdev_queue *dev_ingress_queue_create(struct net_device *dev);
94
95#ifdef CONFIG_NET_INGRESS
96void net_inc_ingress_queue(void);
97void net_dec_ingress_queue(void);
98#endif
99
100#ifdef CONFIG_NET_EGRESS
101void net_inc_egress_queue(void);
102void net_dec_egress_queue(void);
103void netdev_xmit_skip_txqueue(bool skip);
104#endif
105
106void rtnetlink_init(void);
107void __rtnl_unlock(void);
108void 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
114extern 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);
119extern 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);
125extern 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
131extern 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
139extern void rtnl_offload_xstats_notify(struct net_device *dev);
140
141#endif /* __LINUX_RTNETLINK_H */
142

source code of linux/include/linux/rtnetlink.h