Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

Mar 24-27, 2025, special US time zones
Register
Loading...
v4.6
  1#ifndef __NET_RTNETLINK_H
  2#define __NET_RTNETLINK_H
  3
  4#include <linux/rtnetlink.h>
  5#include <net/netlink.h>
  6
  7typedef int (*rtnl_doit_func)(struct sk_buff *, struct nlmsghdr *);
  8typedef int (*rtnl_dumpit_func)(struct sk_buff *, struct netlink_callback *);
  9typedef u16 (*rtnl_calcit_func)(struct sk_buff *, struct nlmsghdr *);
 10
 11int __rtnl_register(int protocol, int msgtype,
 12		    rtnl_doit_func, rtnl_dumpit_func, rtnl_calcit_func);
 13void rtnl_register(int protocol, int msgtype,
 14		   rtnl_doit_func, rtnl_dumpit_func, rtnl_calcit_func);
 15int rtnl_unregister(int protocol, int msgtype);
 16void rtnl_unregister_all(int protocol);
 17
 18static 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/**
 27 *	struct rtnl_link_ops - rtnetlink link operations
 28 *
 29 *	@list: Used internally
 30 *	@kind: Identifier
 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 */
 51struct rtnl_link_ops {
 52	struct list_head	list;
 53
 54	const char		*kind;
 55
 56	size_t			priv_size;
 57	void			(*setup)(struct net_device *dev);
 58
 59	int			maxtype;
 60	const struct nla_policy	*policy;
 61	int			(*validate)(struct nlattr *tb[],
 62					    struct nlattr *data[]);
 63
 64	int			(*newlink)(struct net *src_net,
 65					   struct net_device *dev,
 66					   struct nlattr *tb[],
 67					   struct nlattr *data[]);
 68	int			(*changelink)(struct net_device *dev,
 69					      struct nlattr *tb[],
 70					      struct nlattr *data[]);
 71	void			(*dellink)(struct net_device *dev,
 72					   struct list_head *head);
 73
 74	size_t			(*get_size)(const struct net_device *dev);
 75	int			(*fill_info)(struct sk_buff *skb,
 76					     const struct net_device *dev);
 77
 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
 84	int			slave_maxtype;
 85	const struct nla_policy	*slave_policy;
 86	int			(*slave_validate)(struct nlattr *tb[],
 87						  struct nlattr *data[]);
 88	int			(*slave_changelink)(struct net_device *dev,
 89						    struct net_device *slave_dev,
 90						    struct nlattr *tb[],
 91						    struct nlattr *data[]);
 92	size_t			(*get_slave_size)(const struct net_device *dev,
 93						  const struct net_device *slave_dev);
 94	int			(*fill_slave_info)(struct sk_buff *skb,
 95						   const struct net_device *dev,
 96						   const struct net_device *slave_dev);
 97	struct net		*(*get_link_net)(const struct net_device *dev);
 98};
 99
100int __rtnl_link_register(struct rtnl_link_ops *ops);
101void __rtnl_link_unregister(struct rtnl_link_ops *ops);
102
103int rtnl_link_register(struct rtnl_link_ops *ops);
104void rtnl_link_unregister(struct rtnl_link_ops *ops);
105
106/**
107 * 	struct rtnl_af_ops - rtnetlink address family operations
108 *
109 *	@list: Used internally
110 * 	@family: Address family
111 * 	@fill_link_af: Function to fill IFLA_AF_SPEC with address family
112 * 		       specific netlink attributes.
113 * 	@get_link_af_size: Function to calculate size of address family specific
114 * 			   netlink attributes.
115 *	@validate_link_af: Validate a IFLA_AF_SPEC attribute, must check attr
116 *			   for invalid configuration settings.
117 * 	@set_link_af: Function to parse a IFLA_AF_SPEC attribute and modify
118 *		      net_device accordingly.
119 */
120struct rtnl_af_ops {
121	struct list_head	list;
122	int			family;
123
124	int			(*fill_link_af)(struct sk_buff *skb,
125						const struct net_device *dev,
126						u32 ext_filter_mask);
127	size_t			(*get_link_af_size)(const struct net_device *dev,
128						    u32 ext_filter_mask);
129
130	int			(*validate_link_af)(const struct net_device *dev,
131						    const struct nlattr *attr);
132	int			(*set_link_af)(struct net_device *dev,
133					       const struct nlattr *attr);
134};
135
136void __rtnl_af_unregister(struct rtnl_af_ops *ops);
137
138void rtnl_af_register(struct rtnl_af_ops *ops);
139void rtnl_af_unregister(struct rtnl_af_ops *ops);
140
141struct net *rtnl_link_get_net(struct net *src_net, struct nlattr *tb[]);
142struct net_device *rtnl_create_link(struct net *net, const char *ifname,
143				    unsigned char name_assign_type,
144				    const struct rtnl_link_ops *ops,
145				    struct nlattr *tb[]);
146int rtnl_delete_link(struct net_device *dev);
147int rtnl_configure_link(struct net_device *dev, const struct ifinfomsg *ifm);
148
149int rtnl_nla_parse_ifla(struct nlattr **tb, const struct nlattr *head, int len);
150
151#define MODULE_ALIAS_RTNL_LINK(kind) MODULE_ALIAS("rtnl-link-" kind)
152
153#endif
v3.15
  1#ifndef __NET_RTNETLINK_H
  2#define __NET_RTNETLINK_H
  3
  4#include <linux/rtnetlink.h>
  5#include <net/netlink.h>
  6
  7typedef int (*rtnl_doit_func)(struct sk_buff *, struct nlmsghdr *);
  8typedef int (*rtnl_dumpit_func)(struct sk_buff *, struct netlink_callback *);
  9typedef u16 (*rtnl_calcit_func)(struct sk_buff *, struct nlmsghdr *);
 10
 11int __rtnl_register(int protocol, int msgtype,
 12		    rtnl_doit_func, rtnl_dumpit_func, rtnl_calcit_func);
 13void rtnl_register(int protocol, int msgtype,
 14		   rtnl_doit_func, rtnl_dumpit_func, rtnl_calcit_func);
 15int rtnl_unregister(int protocol, int msgtype);
 16void rtnl_unregister_all(int protocol);
 17
 18static 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/**
 27 *	struct rtnl_link_ops - rtnetlink link operations
 28 *
 29 *	@list: Used internally
 30 *	@kind: Identifier
 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 */
 50struct rtnl_link_ops {
 51	struct list_head	list;
 52
 53	const char		*kind;
 54
 55	size_t			priv_size;
 56	void			(*setup)(struct net_device *dev);
 57
 58	int			maxtype;
 59	const struct nla_policy	*policy;
 60	int			(*validate)(struct nlattr *tb[],
 61					    struct nlattr *data[]);
 62
 63	int			(*newlink)(struct net *src_net,
 64					   struct net_device *dev,
 65					   struct nlattr *tb[],
 66					   struct nlattr *data[]);
 67	int			(*changelink)(struct net_device *dev,
 68					      struct nlattr *tb[],
 69					      struct nlattr *data[]);
 70	void			(*dellink)(struct net_device *dev,
 71					   struct list_head *head);
 72
 73	size_t			(*get_size)(const struct net_device *dev);
 74	int			(*fill_info)(struct sk_buff *skb,
 75					     const struct net_device *dev);
 76
 77	size_t			(*get_xstats_size)(const struct net_device *dev);
 78	int			(*fill_xstats)(struct sk_buff *skb,
 79					       const struct net_device *dev);
 80	unsigned int		(*get_num_tx_queues)(void);
 81	unsigned int		(*get_num_rx_queues)(void);
 82
 83	int			slave_maxtype;
 84	const struct nla_policy	*slave_policy;
 85	int			(*slave_validate)(struct nlattr *tb[],
 86						  struct nlattr *data[]);
 87	int			(*slave_changelink)(struct net_device *dev,
 88						    struct net_device *slave_dev,
 89						    struct nlattr *tb[],
 90						    struct nlattr *data[]);
 91	size_t			(*get_slave_size)(const struct net_device *dev,
 92						  const struct net_device *slave_dev);
 93	int			(*fill_slave_info)(struct sk_buff *skb,
 94						   const struct net_device *dev,
 95						   const struct net_device *slave_dev);
 
 96};
 97
 98int __rtnl_link_register(struct rtnl_link_ops *ops);
 99void __rtnl_link_unregister(struct rtnl_link_ops *ops);
100
101int rtnl_link_register(struct rtnl_link_ops *ops);
102void rtnl_link_unregister(struct rtnl_link_ops *ops);
103
104/**
105 * 	struct rtnl_af_ops - rtnetlink address family operations
106 *
107 *	@list: Used internally
108 * 	@family: Address family
109 * 	@fill_link_af: Function to fill IFLA_AF_SPEC with address family
110 * 		       specific netlink attributes.
111 * 	@get_link_af_size: Function to calculate size of address family specific
112 * 			   netlink attributes.
113 *	@validate_link_af: Validate a IFLA_AF_SPEC attribute, must check attr
114 *			   for invalid configuration settings.
115 * 	@set_link_af: Function to parse a IFLA_AF_SPEC attribute and modify
116 *		      net_device accordingly.
117 */
118struct rtnl_af_ops {
119	struct list_head	list;
120	int			family;
121
122	int			(*fill_link_af)(struct sk_buff *skb,
123						const struct net_device *dev);
124	size_t			(*get_link_af_size)(const struct net_device *dev);
 
 
125
126	int			(*validate_link_af)(const struct net_device *dev,
127						    const struct nlattr *attr);
128	int			(*set_link_af)(struct net_device *dev,
129					       const struct nlattr *attr);
130};
131
132void __rtnl_af_unregister(struct rtnl_af_ops *ops);
133
134void rtnl_af_register(struct rtnl_af_ops *ops);
135void rtnl_af_unregister(struct rtnl_af_ops *ops);
136
137struct net *rtnl_link_get_net(struct net *src_net, struct nlattr *tb[]);
138struct net_device *rtnl_create_link(struct net *net, char *ifname,
 
139				    const struct rtnl_link_ops *ops,
140				    struct nlattr *tb[]);
 
141int rtnl_configure_link(struct net_device *dev, const struct ifinfomsg *ifm);
142
143int rtnl_nla_parse_ifla(struct nlattr **tb, const struct nlattr *head, int len);
144
145#define MODULE_ALIAS_RTNL_LINK(kind) MODULE_ALIAS("rtnl-link-" kind)
146
147#endif