LXR linux/include/linux/rtnetlink.h

   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);
 103#endif
 104
 105void rtnetlink_init(void);
 106void __rtnl_unlock(void);
 107void rtnl_kfree_skbs(struct sk_buff *head, struct sk_buff *tail);
 108
 109#define ASSERT_RTNL() \
 110        WARN_ONCE(!rtnl_is_locked(), \
 111                  "RTNL: assertion failed at %s (%d)\n", __FILE__,  __LINE__)
 112
 113extern int ndo_dflt_fdb_dump(struct sk_buff *skb,
 114                             struct netlink_callback *cb,
 115                             struct net_device *dev,
 116                             struct net_device *filter_dev,
 117                             int *idx);
 118extern int ndo_dflt_fdb_add(struct ndmsg *ndm,
 119                            struct nlattr *tb[],
 120                            struct net_device *dev,
 121                            const unsigned char *addr,
 122                            u16 vid,
 123                            u16 flags);
 124extern int ndo_dflt_fdb_del(struct ndmsg *ndm,
 125                            struct nlattr *tb[],
 126                            struct net_device *dev,
 127                            const unsigned char *addr,
 128                            u16 vid);
 129
 130extern int ndo_dflt_bridge_getlink(struct sk_buff *skb, u32 pid, u32 seq,
 131                                   struct net_device *dev, u16 mode,
 132                                   u32 flags, u32 mask, int nlflags,
 133                                   u32 filter_mask,
 134                                   int (*vlan_fill)(struct sk_buff *skb,
 135                                                    struct net_device *dev,
 136                                                    u32 filter_mask));
 137#endif  /* __LINUX_RTNETLINK_H */
 138