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
11extern int rtnetlink_send(struct sk_buff *skb, struct net *net, u32 pid, u32 group, int echo);
12extern int rtnl_unicast(struct sk_buff *skb, struct net *net, u32 pid);
13extern void rtnl_notify(struct sk_buff *skb, struct net *net, u32 pid,
14 u32 group, struct nlmsghdr *nlh, gfp_t flags);
15extern void rtnl_set_sk_err(struct net *net, u32 group, int error);
16extern int rtnetlink_put_metrics(struct sk_buff *skb, u32 *metrics);
17extern int rtnl_put_cacheinfo(struct sk_buff *skb, struct dst_entry *dst,
18 u32 id, long expires, u32 error);
19
20void rtmsg_ifinfo(int type, struct net_device *dev, unsigned change, gfp_t flags);
21void rtmsg_ifinfo_newnet(int type, struct net_device *dev, unsigned int change,
22 gfp_t flags, int *new_nsid, int new_ifindex);
23struct 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);
27void 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 */
32extern void rtnl_lock(void);
33extern void rtnl_unlock(void);
34extern int rtnl_trylock(void);
35extern int rtnl_is_locked(void);
36extern int rtnl_lock_killable(void);
37
38extern wait_queue_head_t netdev_unregistering_wq;
39extern struct rw_semaphore pernet_ops_rwsem;
40extern struct rw_semaphore net_rwsem;
41
42#ifdef CONFIG_PROVE_LOCKING
43extern bool lockdep_rtnl_is_held(void);
44#else
45static 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
81static inline struct netdev_queue *dev_ingress_queue(struct net_device *dev)
82{
83 return rtnl_dereference(dev->ingress_queue);
84}
85
86struct netdev_queue *dev_ingress_queue_create(struct net_device *dev);
87
88#ifdef CONFIG_NET_INGRESS
89void net_inc_ingress_queue(void);
90void net_dec_ingress_queue(void);
91#endif
92
93#ifdef CONFIG_NET_EGRESS
94void net_inc_egress_queue(void);
95void net_dec_egress_queue(void);
96#endif
97
98void rtnetlink_init(void);
99void __rtnl_unlock(void);
100void 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
106extern 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);
111extern 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);
117extern 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
123extern 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