include/linux/rtnetlink.h

0001 /* SPDX-License-Identifier: GPL-2.0 */
0002 #ifndef __LINUX_RTNETLINK_H
0003 #define __LINUX_RTNETLINK_H
0004
0005
0006 #include <linux/mutex.h>
0007 #include <linux/netdevice.h>
0008 #include <linux/wait.h>
0009 #include <linux/refcount.h>
0010 #include <uapi/linux/rtnetlink.h>
0011
0012 extern int rtnetlink_send(struct sk_buff *skb, struct net *net, u32 pid, u32 group, int echo);
0013 extern int rtnl_unicast(struct sk_buff *skb, struct net *net, u32 pid);
0014 extern void rtnl_notify(struct sk_buff *skb, struct net *net, u32 pid,
0015             u32 group, struct nlmsghdr *nlh, gfp_t flags);
0016 extern void rtnl_set_sk_err(struct net *net, u32 group, int error);
0017 extern int rtnetlink_put_metrics(struct sk_buff *skb, u32 *metrics);
0018 extern int rtnl_put_cacheinfo(struct sk_buff *skb, struct dst_entry *dst,
0019                   u32 id, long expires, u32 error);
0020
0021 void rtmsg_ifinfo(int type, struct net_device *dev, unsigned change, gfp_t flags);
0022 void rtmsg_ifinfo_newnet(int type, struct net_device *dev, unsigned int change,
0023              gfp_t flags, int *new_nsid, int new_ifindex);
0024 struct sk_buff *rtmsg_ifinfo_build_skb(int type, struct net_device *dev,
0025                        unsigned change, u32 event,
0026                        gfp_t flags, int *new_nsid,
0027                        int new_ifindex);
0028 void rtmsg_ifinfo_send(struct sk_buff *skb, struct net_device *dev,
0029                gfp_t flags);
0030
0031
0032 /* RTNL is used as a global lock for all changes to network configuration  */
0033 extern void rtnl_lock(void);
0034 extern void rtnl_unlock(void);
0035 extern int rtnl_trylock(void);
0036 extern int rtnl_is_locked(void);
0037 extern int rtnl_lock_killable(void);
0038 extern bool refcount_dec_and_rtnl_lock(refcount_t *r);
0039
0040 extern wait_queue_head_t netdev_unregistering_wq;
0041 extern struct rw_semaphore pernet_ops_rwsem;
0042 extern struct rw_semaphore net_rwsem;
0043
0044 #ifdef CONFIG_PROVE_LOCKING
0045 extern bool lockdep_rtnl_is_held(void);
0046 #else
0047 static inline bool lockdep_rtnl_is_held(void)
0048 {
0049     return true;
0050 }
0051 #endif /* #ifdef CONFIG_PROVE_LOCKING */
0052
0053 /**
0054  * rcu_dereference_rtnl - rcu_dereference with debug checking
0055  * @p: The pointer to read, prior to dereferencing
0056  *
0057  * Do an rcu_dereference(p), but check caller either holds rcu_read_lock()
0058  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference()
0059  */
0060 #define rcu_dereference_rtnl(p)                 \
0061     rcu_dereference_check(p, lockdep_rtnl_is_held())
0062
0063 /**
0064  * rcu_dereference_bh_rtnl - rcu_dereference_bh with debug checking
0065  * @p: The pointer to read, prior to dereference
0066  *
0067  * Do an rcu_dereference_bh(p), but check caller either holds rcu_read_lock_bh()
0068  * or RTNL. Note : Please prefer rtnl_dereference() or rcu_dereference_bh()
0069  */
0070 #define rcu_dereference_bh_rtnl(p)              \
0071     rcu_dereference_bh_check(p, lockdep_rtnl_is_held())
0072
0073 /**
0074  * rtnl_dereference - fetch RCU pointer when updates are prevented by RTNL
0075  * @p: The pointer to read, prior to dereferencing
0076  *
0077  * Return the value of the specified RCU-protected pointer, but omit
0078  * the READ_ONCE(), because caller holds RTNL.
0079  */
0080 #define rtnl_dereference(p)                 \
0081     rcu_dereference_protected(p, lockdep_rtnl_is_held())
0082
0083 static inline struct netdev_queue *dev_ingress_queue(struct net_device *dev)
0084 {
0085     return rtnl_dereference(dev->ingress_queue);
0086 }
0087
0088 static inline struct netdev_queue *dev_ingress_queue_rcu(struct net_device *dev)
0089 {
0090     return rcu_dereference(dev->ingress_queue);
0091 }
0092
0093 struct netdev_queue *dev_ingress_queue_create(struct net_device *dev);
0094
0095 #ifdef CONFIG_NET_INGRESS
0096 void net_inc_ingress_queue(void);
0097 void net_dec_ingress_queue(void);
0098 #endif
0099
0100 #ifdef CONFIG_NET_EGRESS
0101 void net_inc_egress_queue(void);
0102 void net_dec_egress_queue(void);
0103 void netdev_xmit_skip_txqueue(bool skip);
0104 #endif
0105
0106 void rtnetlink_init(void);
0107 void __rtnl_unlock(void);
0108 void rtnl_kfree_skbs(struct sk_buff *head, struct sk_buff *tail);
0109
0110 #define ASSERT_RTNL() \
0111     WARN_ONCE(!rtnl_is_locked(), \
0112           "RTNL: assertion failed at %s (%d)\n", __FILE__,  __LINE__)
0113
0114 extern int ndo_dflt_fdb_dump(struct sk_buff *skb,
0115                  struct netlink_callback *cb,
0116                  struct net_device *dev,
0117                  struct net_device *filter_dev,
0118                  int *idx);
0119 extern int ndo_dflt_fdb_add(struct ndmsg *ndm,
0120                 struct nlattr *tb[],
0121                 struct net_device *dev,
0122                 const unsigned char *addr,
0123                 u16 vid,
0124                 u16 flags);
0125 extern int ndo_dflt_fdb_del(struct ndmsg *ndm,
0126                 struct nlattr *tb[],
0127                 struct net_device *dev,
0128                 const unsigned char *addr,
0129                 u16 vid);
0130
0131 extern int ndo_dflt_bridge_getlink(struct sk_buff *skb, u32 pid, u32 seq,
0132                    struct net_device *dev, u16 mode,
0133                    u32 flags, u32 mask, int nlflags,
0134                    u32 filter_mask,
0135                    int (*vlan_fill)(struct sk_buff *skb,
0136                             struct net_device *dev,
0137                             u32 filter_mask));
0138
0139 extern void rtnl_offload_xstats_notify(struct net_device *dev);
0140
0141 #endif  /* __LINUX_RTNETLINK_H */