rtnetlink.h 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. #ifndef __NET_RTNETLINK_H
  3. #define __NET_RTNETLINK_H
  4. #include <linux/rtnetlink.h>
  5. #include <net/netlink.h>
  6. typedef int (*rtnl_doit_func)(struct sk_buff *, struct nlmsghdr *,
  7. struct netlink_ext_ack *);
  8. typedef int (*rtnl_dumpit_func)(struct sk_buff *, struct netlink_callback *);
  9. enum rtnl_link_flags {
  10. RTNL_FLAG_DOIT_UNLOCKED = 1,
  11. };
  12. int __rtnl_register(int protocol, int msgtype,
  13. rtnl_doit_func, rtnl_dumpit_func, unsigned int flags);
  14. void rtnl_register(int protocol, int msgtype,
  15. rtnl_doit_func, rtnl_dumpit_func, unsigned int flags);
  16. int rtnl_unregister(int protocol, int msgtype);
  17. void rtnl_unregister_all(int protocol);
  18. static inline int rtnl_msg_family(const struct nlmsghdr *nlh)
  19. {
  20. if (nlmsg_len(nlh) >= sizeof(struct rtgenmsg))
  21. return ((struct rtgenmsg *) nlmsg_data(nlh))->rtgen_family;
  22. else
  23. return AF_UNSPEC;
  24. }
  25. /**
  26. * struct rtnl_link_ops - rtnetlink link operations
  27. *
  28. * @list: Used internally
  29. * @kind: Identifier
  30. * @netns_refund: Physical device, move to init_net on netns exit
  31. * @maxtype: Highest device specific netlink attribute number
  32. * @policy: Netlink policy for device specific attribute validation
  33. * @validate: Optional validation function for netlink/changelink parameters
  34. * @priv_size: sizeof net_device private space
  35. * @setup: net_device setup function
  36. * @newlink: Function for configuring and registering a new device
  37. * @changelink: Function for changing parameters of an existing device
  38. * @dellink: Function to remove a device
  39. * @get_size: Function to calculate required room for dumping device
  40. * specific netlink attributes
  41. * @fill_info: Function to dump device specific netlink attributes
  42. * @get_xstats_size: Function to calculate required room for dumping device
  43. * specific statistics
  44. * @fill_xstats: Function to dump device specific statistics
  45. * @get_num_tx_queues: Function to determine number of transmit queues
  46. * to create when creating a new device.
  47. * @get_num_rx_queues: Function to determine number of receive queues
  48. * to create when creating a new device.
  49. * @get_link_net: Function to get the i/o netns of the device
  50. * @get_linkxstats_size: Function to calculate the required room for
  51. * dumping device-specific extended link stats
  52. * @fill_linkxstats: Function to dump device-specific extended link stats
  53. */
  54. struct rtnl_link_ops {
  55. struct list_head list;
  56. const char *kind;
  57. size_t priv_size;
  58. void (*setup)(struct net_device *dev);
  59. int maxtype;
  60. const struct nla_policy *policy;
  61. int (*validate)(struct nlattr *tb[],
  62. struct nlattr *data[],
  63. struct netlink_ext_ack *extack);
  64. int (*newlink)(struct net *src_net,
  65. struct net_device *dev,
  66. struct nlattr *tb[],
  67. struct nlattr *data[],
  68. struct netlink_ext_ack *extack);
  69. int (*changelink)(struct net_device *dev,
  70. struct nlattr *tb[],
  71. struct nlattr *data[],
  72. struct netlink_ext_ack *extack);
  73. void (*dellink)(struct net_device *dev,
  74. struct list_head *head);
  75. size_t (*get_size)(const struct net_device *dev);
  76. int (*fill_info)(struct sk_buff *skb,
  77. const struct net_device *dev);
  78. size_t (*get_xstats_size)(const struct net_device *dev);
  79. int (*fill_xstats)(struct sk_buff *skb,
  80. const struct net_device *dev);
  81. unsigned int (*get_num_tx_queues)(void);
  82. unsigned int (*get_num_rx_queues)(void);
  83. bool netns_refund;
  84. int slave_maxtype;
  85. const struct nla_policy *slave_policy;
  86. int (*slave_validate)(struct nlattr *tb[],
  87. struct nlattr *data[],
  88. struct netlink_ext_ack *extack);
  89. int (*slave_changelink)(struct net_device *dev,
  90. struct net_device *slave_dev,
  91. struct nlattr *tb[],
  92. struct nlattr *data[],
  93. struct netlink_ext_ack *extack);
  94. size_t (*get_slave_size)(const struct net_device *dev,
  95. const struct net_device *slave_dev);
  96. int (*fill_slave_info)(struct sk_buff *skb,
  97. const struct net_device *dev,
  98. const struct net_device *slave_dev);
  99. struct net *(*get_link_net)(const struct net_device *dev);
  100. size_t (*get_linkxstats_size)(const struct net_device *dev,
  101. int attr);
  102. int (*fill_linkxstats)(struct sk_buff *skb,
  103. const struct net_device *dev,
  104. int *prividx, int attr);
  105. };
  106. int __rtnl_link_register(struct rtnl_link_ops *ops);
  107. void __rtnl_link_unregister(struct rtnl_link_ops *ops);
  108. int rtnl_link_register(struct rtnl_link_ops *ops);
  109. void rtnl_link_unregister(struct rtnl_link_ops *ops);
  110. /**
  111. * struct rtnl_af_ops - rtnetlink address family operations
  112. *
  113. * @list: Used internally
  114. * @family: Address family
  115. * @fill_link_af: Function to fill IFLA_AF_SPEC with address family
  116. * specific netlink attributes.
  117. * @get_link_af_size: Function to calculate size of address family specific
  118. * netlink attributes.
  119. * @validate_link_af: Validate a IFLA_AF_SPEC attribute, must check attr
  120. * for invalid configuration settings.
  121. * @set_link_af: Function to parse a IFLA_AF_SPEC attribute and modify
  122. * net_device accordingly.
  123. */
  124. struct rtnl_af_ops {
  125. struct list_head list;
  126. int family;
  127. int (*fill_link_af)(struct sk_buff *skb,
  128. const struct net_device *dev,
  129. u32 ext_filter_mask);
  130. size_t (*get_link_af_size)(const struct net_device *dev,
  131. u32 ext_filter_mask);
  132. int (*validate_link_af)(const struct net_device *dev,
  133. const struct nlattr *attr);
  134. int (*set_link_af)(struct net_device *dev,
  135. const struct nlattr *attr);
  136. int (*fill_stats_af)(struct sk_buff *skb,
  137. const struct net_device *dev);
  138. size_t (*get_stats_af_size)(const struct net_device *dev);
  139. };
  140. void __rtnl_af_unregister(struct rtnl_af_ops *ops);
  141. void rtnl_af_register(struct rtnl_af_ops *ops);
  142. void rtnl_af_unregister(struct rtnl_af_ops *ops);
  143. struct net *rtnl_link_get_net(struct net *src_net, struct nlattr *tb[]);
  144. struct net_device *rtnl_create_link(struct net *net, const char *ifname,
  145. unsigned char name_assign_type,
  146. const struct rtnl_link_ops *ops,
  147. struct nlattr *tb[]);
  148. int rtnl_delete_link(struct net_device *dev);
  149. int rtnl_configure_link(struct net_device *dev, const struct ifinfomsg *ifm);
  150. int rtnl_nla_parse_ifla(struct nlattr **tb, const struct nlattr *head, int len,
  151. struct netlink_ext_ack *exterr);
  152. #define MODULE_ALIAS_RTNL_LINK(kind) MODULE_ALIAS("rtnl-link-" kind)
  153. #endif