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