1 // SPDX-License-Identifier: GPL-2.0-only
4 #include <linux/ethtool_netlink.h>
7 static struct genl_family ethtool_genl_family;
9 static bool ethnl_ok __read_mostly;
10 static u32 ethnl_bcast_seq;
12 static const struct nla_policy ethnl_header_policy[ETHTOOL_A_HEADER_MAX + 1] = {
13 [ETHTOOL_A_HEADER_UNSPEC] = { .type = NLA_REJECT },
14 [ETHTOOL_A_HEADER_DEV_INDEX] = { .type = NLA_U32 },
15 [ETHTOOL_A_HEADER_DEV_NAME] = { .type = NLA_NUL_STRING,
16 .len = ALTIFNAMSIZ - 1 },
17 [ETHTOOL_A_HEADER_FLAGS] = { .type = NLA_U32 },
21 * ethnl_parse_header_dev_get() - parse request header
22 * @req_info: structure to put results into
23 * @header: nest attribute with request header
25 * @extack: netlink extack for error reporting
26 * @require_dev: fail if no device identified in header
28 * Parse request header in nested attribute @nest and puts results into
29 * the structure pointed to by @req_info. Extack from @info is used for error
30 * reporting. If req_info->dev is not null on return, reference to it has
31 * been taken. If error is returned, *req_info is null initialized and no
34 * Return: 0 on success or negative error code
36 int ethnl_parse_header_dev_get(struct ethnl_req_info *req_info,
37 const struct nlattr *header, struct net *net,
38 struct netlink_ext_ack *extack, bool require_dev)
40 struct nlattr *tb[ETHTOOL_A_HEADER_MAX + 1];
41 const struct nlattr *devname_attr;
42 struct net_device *dev = NULL;
46 NL_SET_ERR_MSG(extack, "request header missing");
49 ret = nla_parse_nested(tb, ETHTOOL_A_HEADER_MAX, header,
50 ethnl_header_policy, extack);
53 devname_attr = tb[ETHTOOL_A_HEADER_DEV_NAME];
55 if (tb[ETHTOOL_A_HEADER_DEV_INDEX]) {
56 u32 ifindex = nla_get_u32(tb[ETHTOOL_A_HEADER_DEV_INDEX]);
58 dev = dev_get_by_index(net, ifindex);
60 NL_SET_ERR_MSG_ATTR(extack,
61 tb[ETHTOOL_A_HEADER_DEV_INDEX],
62 "no device matches ifindex");
65 /* if both ifindex and ifname are passed, they must match */
67 strncmp(dev->name, nla_data(devname_attr), IFNAMSIZ)) {
69 NL_SET_ERR_MSG_ATTR(extack, header,
70 "ifindex and name do not match");
73 } else if (devname_attr) {
74 dev = dev_get_by_name(net, nla_data(devname_attr));
76 NL_SET_ERR_MSG_ATTR(extack, devname_attr,
77 "no device matches name");
80 } else if (require_dev) {
81 NL_SET_ERR_MSG_ATTR(extack, header,
82 "neither ifindex nor name specified");
86 if (dev && !netif_device_present(dev)) {
88 NL_SET_ERR_MSG(extack, "device not present");
93 if (tb[ETHTOOL_A_HEADER_FLAGS])
94 req_info->flags = nla_get_u32(tb[ETHTOOL_A_HEADER_FLAGS]);
100 * ethnl_fill_reply_header() - Put common header into a reply message
101 * @skb: skb with the message
102 * @dev: network device to describe in header
103 * @attrtype: attribute type to use for the nest
105 * Create a nested attribute with attributes describing given network device.
107 * Return: 0 on success, error value (-EMSGSIZE only) on error
109 int ethnl_fill_reply_header(struct sk_buff *skb, struct net_device *dev,
116 nest = nla_nest_start(skb, attrtype);
120 if (nla_put_u32(skb, ETHTOOL_A_HEADER_DEV_INDEX, (u32)dev->ifindex) ||
121 nla_put_string(skb, ETHTOOL_A_HEADER_DEV_NAME, dev->name))
122 goto nla_put_failure;
123 /* If more attributes are put into reply header, ethnl_header_size()
124 * must be updated to account for them.
127 nla_nest_end(skb, nest);
131 nla_nest_cancel(skb, nest);
136 * ethnl_reply_init() - Create skb for a reply and fill device identification
137 * @payload: payload length (without netlink and genetlink header)
138 * @dev: device the reply is about (may be null)
139 * @cmd: ETHTOOL_MSG_* message type for reply
140 * @hdr_attrtype: attribute type for common header
141 * @info: genetlink info of the received packet we respond to
142 * @ehdrp: place to store payload pointer returned by genlmsg_new()
144 * Return: pointer to allocated skb on success, NULL on error
146 struct sk_buff *ethnl_reply_init(size_t payload, struct net_device *dev, u8 cmd,
147 u16 hdr_attrtype, struct genl_info *info,
152 skb = genlmsg_new(payload, GFP_KERNEL);
155 *ehdrp = genlmsg_put_reply(skb, info, ðtool_genl_family, 0, cmd);
162 ret = ethnl_fill_reply_header(skb, dev, hdr_attrtype);
172 GENL_SET_ERR_MSG(info, "failed to setup reply message");
176 static void *ethnl_bcastmsg_put(struct sk_buff *skb, u8 cmd)
178 return genlmsg_put(skb, 0, ++ethnl_bcast_seq, ðtool_genl_family, 0,
182 static int ethnl_multicast(struct sk_buff *skb, struct net_device *dev)
184 return genlmsg_multicast_netns(ðtool_genl_family, dev_net(dev), skb,
185 0, ETHNL_MCGRP_MONITOR, GFP_KERNEL);
188 /* GET request helpers */
191 * struct ethnl_dump_ctx - context structure for generic dumpit() callback
192 * @ops: request ops of currently processed message type
193 * @req_info: parsed request header of processed request
194 * @reply_data: data needed to compose the reply
195 * @pos_hash: saved iteration position - hashbucket
196 * @pos_idx: saved iteration position - index
198 * These parameters are kept in struct netlink_callback as context preserved
199 * between iterations. They are initialized by ethnl_default_start() and used
200 * in ethnl_default_dumpit() and ethnl_default_done().
202 struct ethnl_dump_ctx {
203 const struct ethnl_request_ops *ops;
204 struct ethnl_req_info *req_info;
205 struct ethnl_reply_data *reply_data;
210 static const struct ethnl_request_ops *
211 ethnl_default_requests[__ETHTOOL_MSG_USER_CNT] = {
212 [ETHTOOL_MSG_STRSET_GET] = ðnl_strset_request_ops,
213 [ETHTOOL_MSG_LINKINFO_GET] = ðnl_linkinfo_request_ops,
214 [ETHTOOL_MSG_LINKMODES_GET] = ðnl_linkmodes_request_ops,
215 [ETHTOOL_MSG_LINKSTATE_GET] = ðnl_linkstate_request_ops,
216 [ETHTOOL_MSG_DEBUG_GET] = ðnl_debug_request_ops,
217 [ETHTOOL_MSG_WOL_GET] = ðnl_wol_request_ops,
218 [ETHTOOL_MSG_FEATURES_GET] = ðnl_features_request_ops,
219 [ETHTOOL_MSG_PRIVFLAGS_GET] = ðnl_privflags_request_ops,
222 static struct ethnl_dump_ctx *ethnl_dump_context(struct netlink_callback *cb)
224 return (struct ethnl_dump_ctx *)cb->ctx;
228 * ethnl_default_parse() - Parse request message
229 * @req_info: pointer to structure to put data into
230 * @nlhdr: pointer to request message header
231 * @net: request netns
232 * @request_ops: struct request_ops for request type
233 * @extack: netlink extack for error reporting
234 * @require_dev: fail if no device identified in header
236 * Parse universal request header and call request specific ->parse_request()
237 * callback (if defined) to parse the rest of the message.
239 * Return: 0 on success or negative error code
241 static int ethnl_default_parse(struct ethnl_req_info *req_info,
242 const struct nlmsghdr *nlhdr, struct net *net,
243 const struct ethnl_request_ops *request_ops,
244 struct netlink_ext_ack *extack, bool require_dev)
249 tb = kmalloc_array(request_ops->max_attr + 1, sizeof(tb[0]),
254 ret = nlmsg_parse(nlhdr, GENL_HDRLEN, tb, request_ops->max_attr,
255 request_ops->request_policy, extack);
258 ret = ethnl_parse_header_dev_get(req_info, tb[request_ops->hdr_attr],
259 net, extack, require_dev);
263 if (request_ops->parse_request) {
264 ret = request_ops->parse_request(req_info, tb, extack);
276 * ethnl_init_reply_data() - Initialize reply data for GET request
277 * @reply_data: pointer to embedded struct ethnl_reply_data
278 * @ops: instance of struct ethnl_request_ops describing the layout
279 * @dev: network device to initialize the reply for
281 * Fills the reply data part with zeros and sets the dev member. Must be called
282 * before calling the ->fill_reply() callback (for each iteration when handling
285 static void ethnl_init_reply_data(struct ethnl_reply_data *reply_data,
286 const struct ethnl_request_ops *ops,
287 struct net_device *dev)
289 memset(reply_data, 0, ops->reply_data_size);
290 reply_data->dev = dev;
293 /* default ->doit() handler for GET type requests */
294 static int ethnl_default_doit(struct sk_buff *skb, struct genl_info *info)
296 struct ethnl_reply_data *reply_data = NULL;
297 struct ethnl_req_info *req_info = NULL;
298 const u8 cmd = info->genlhdr->cmd;
299 const struct ethnl_request_ops *ops;
300 struct sk_buff *rskb;
305 ops = ethnl_default_requests[cmd];
306 if (WARN_ONCE(!ops, "cmd %u has no ethnl_request_ops\n", cmd))
308 req_info = kzalloc(ops->req_info_size, GFP_KERNEL);
311 reply_data = kmalloc(ops->reply_data_size, GFP_KERNEL);
317 ret = ethnl_default_parse(req_info, info->nlhdr, genl_info_net(info), ops,
318 info->extack, !ops->allow_nodev_do);
321 ethnl_init_reply_data(reply_data, ops, req_info->dev);
324 ret = ops->prepare_data(req_info, reply_data, info);
328 ret = ops->reply_size(req_info, reply_data);
333 rskb = ethnl_reply_init(reply_len, req_info->dev, ops->reply_cmd,
334 ops->hdr_attr, info, &reply_payload);
337 ret = ops->fill_reply(rskb, req_info, reply_data);
340 if (ops->cleanup_data)
341 ops->cleanup_data(reply_data);
343 genlmsg_end(rskb, reply_payload);
345 dev_put(req_info->dev);
348 return genlmsg_reply(rskb, info);
351 WARN_ONCE(ret == -EMSGSIZE, "calculated message payload length (%d) not sufficient\n", reply_len);
354 if (ops->cleanup_data)
355 ops->cleanup_data(reply_data);
358 dev_put(req_info->dev);
364 static int ethnl_default_dump_one(struct sk_buff *skb, struct net_device *dev,
365 const struct ethnl_dump_ctx *ctx)
369 ethnl_init_reply_data(ctx->reply_data, ctx->ops, dev);
371 ret = ctx->ops->prepare_data(ctx->req_info, ctx->reply_data, NULL);
375 ret = ethnl_fill_reply_header(skb, dev, ctx->ops->hdr_attr);
378 ret = ctx->ops->fill_reply(skb, ctx->req_info, ctx->reply_data);
381 if (ctx->ops->cleanup_data)
382 ctx->ops->cleanup_data(ctx->reply_data);
383 ctx->reply_data->dev = NULL;
387 /* Default ->dumpit() handler for GET requests. Device iteration copied from
388 * rtnl_dump_ifinfo(); we have to be more careful about device hashtable
389 * persistence as we cannot guarantee to hold RTNL lock through the whole
390 * function as rtnetnlink does.
392 static int ethnl_default_dumpit(struct sk_buff *skb,
393 struct netlink_callback *cb)
395 struct ethnl_dump_ctx *ctx = ethnl_dump_context(cb);
396 struct net *net = sock_net(skb->sk);
397 int s_idx = ctx->pos_idx;
403 for (h = ctx->pos_hash; h < NETDEV_HASHENTRIES; h++, s_idx = 0) {
404 struct hlist_head *head;
405 struct net_device *dev;
408 head = &net->dev_index_head[h];
411 seq = net->dev_base_seq;
414 hlist_for_each_entry(dev, head, index_hlist) {
420 ehdr = genlmsg_put(skb, NETLINK_CB(cb->skb).portid,
422 ðtool_genl_family, 0,
423 ctx->ops->reply_cmd);
429 ret = ethnl_default_dump_one(skb, dev, ctx);
432 genlmsg_cancel(skb, ehdr);
433 if (ret == -EOPNOTSUPP)
435 if (likely(skb->len))
439 genlmsg_end(skb, ehdr);
442 if (net->dev_base_seq != seq) {
456 nl_dump_check_consistent(cb, nlmsg_hdr(skb));
461 /* generic ->start() handler for GET requests */
462 static int ethnl_default_start(struct netlink_callback *cb)
464 struct ethnl_dump_ctx *ctx = ethnl_dump_context(cb);
465 struct ethnl_reply_data *reply_data;
466 const struct ethnl_request_ops *ops;
467 struct ethnl_req_info *req_info;
468 struct genlmsghdr *ghdr;
471 BUILD_BUG_ON(sizeof(*ctx) > sizeof(cb->ctx));
473 ghdr = nlmsg_data(cb->nlh);
474 ops = ethnl_default_requests[ghdr->cmd];
475 if (WARN_ONCE(!ops, "cmd %u has no ethnl_request_ops\n", ghdr->cmd))
477 req_info = kzalloc(ops->req_info_size, GFP_KERNEL);
480 reply_data = kmalloc(ops->reply_data_size, GFP_KERNEL);
486 ret = ethnl_default_parse(req_info, cb->nlh, sock_net(cb->skb->sk), ops,
489 /* We ignore device specification in dump requests but as the
490 * same parser as for non-dump (doit) requests is used, it
491 * would take reference to the device if it finds one
493 dev_put(req_info->dev);
494 req_info->dev = NULL;
497 goto free_reply_data;
500 ctx->req_info = req_info;
501 ctx->reply_data = reply_data;
515 /* default ->done() handler for GET requests */
516 static int ethnl_default_done(struct netlink_callback *cb)
518 struct ethnl_dump_ctx *ctx = ethnl_dump_context(cb);
520 kfree(ctx->reply_data);
521 kfree(ctx->req_info);
526 static const struct ethnl_request_ops *
527 ethnl_default_notify_ops[ETHTOOL_MSG_KERNEL_MAX + 1] = {
528 [ETHTOOL_MSG_LINKINFO_NTF] = ðnl_linkinfo_request_ops,
529 [ETHTOOL_MSG_LINKMODES_NTF] = ðnl_linkmodes_request_ops,
530 [ETHTOOL_MSG_DEBUG_NTF] = ðnl_debug_request_ops,
531 [ETHTOOL_MSG_WOL_NTF] = ðnl_wol_request_ops,
532 [ETHTOOL_MSG_FEATURES_NTF] = ðnl_features_request_ops,
533 [ETHTOOL_MSG_PRIVFLAGS_NTF] = ðnl_privflags_request_ops,
536 /* default notification handler */
537 static void ethnl_default_notify(struct net_device *dev, unsigned int cmd,
540 struct ethnl_reply_data *reply_data;
541 const struct ethnl_request_ops *ops;
542 struct ethnl_req_info *req_info;
548 if (WARN_ONCE(cmd > ETHTOOL_MSG_KERNEL_MAX ||
549 !ethnl_default_notify_ops[cmd],
550 "unexpected notification type %u\n", cmd))
552 ops = ethnl_default_notify_ops[cmd];
553 req_info = kzalloc(ops->req_info_size, GFP_KERNEL);
556 reply_data = kmalloc(ops->reply_data_size, GFP_KERNEL);
563 req_info->flags |= ETHTOOL_FLAG_COMPACT_BITSETS;
565 ethnl_init_reply_data(reply_data, ops, dev);
566 ret = ops->prepare_data(req_info, reply_data, NULL);
569 ret = ops->reply_size(req_info, reply_data);
574 skb = genlmsg_new(reply_len, GFP_KERNEL);
577 reply_payload = ethnl_bcastmsg_put(skb, cmd);
580 ret = ethnl_fill_reply_header(skb, dev, ops->hdr_attr);
583 ret = ops->fill_reply(skb, req_info, reply_data);
586 if (ops->cleanup_data)
587 ops->cleanup_data(reply_data);
589 genlmsg_end(skb, reply_payload);
592 ethnl_multicast(skb, dev);
596 WARN_ONCE(ret == -EMSGSIZE,
597 "calculated message payload length (%d) not sufficient\n",
602 if (ops->cleanup_data)
603 ops->cleanup_data(reply_data);
611 typedef void (*ethnl_notify_handler_t)(struct net_device *dev, unsigned int cmd,
614 static const ethnl_notify_handler_t ethnl_notify_handlers[] = {
615 [ETHTOOL_MSG_LINKINFO_NTF] = ethnl_default_notify,
616 [ETHTOOL_MSG_LINKMODES_NTF] = ethnl_default_notify,
617 [ETHTOOL_MSG_DEBUG_NTF] = ethnl_default_notify,
618 [ETHTOOL_MSG_WOL_NTF] = ethnl_default_notify,
619 [ETHTOOL_MSG_FEATURES_NTF] = ethnl_default_notify,
620 [ETHTOOL_MSG_PRIVFLAGS_NTF] = ethnl_default_notify,
623 void ethtool_notify(struct net_device *dev, unsigned int cmd, const void *data)
625 if (unlikely(!ethnl_ok))
629 if (likely(cmd < ARRAY_SIZE(ethnl_notify_handlers) &&
630 ethnl_notify_handlers[cmd]))
631 ethnl_notify_handlers[cmd](dev, cmd, data);
633 WARN_ONCE(1, "notification %u not implemented (dev=%s)\n",
634 cmd, netdev_name(dev));
636 EXPORT_SYMBOL(ethtool_notify);
638 static void ethnl_notify_features(struct netdev_notifier_info *info)
640 struct net_device *dev = netdev_notifier_info_to_dev(info);
642 ethtool_notify(dev, ETHTOOL_MSG_FEATURES_NTF, NULL);
645 static int ethnl_netdev_event(struct notifier_block *this, unsigned long event,
649 case NETDEV_FEAT_CHANGE:
650 ethnl_notify_features(ptr);
657 static struct notifier_block ethnl_netdev_notifier = {
658 .notifier_call = ethnl_netdev_event,
661 /* genetlink setup */
663 static const struct genl_ops ethtool_genl_ops[] = {
665 .cmd = ETHTOOL_MSG_STRSET_GET,
666 .doit = ethnl_default_doit,
667 .start = ethnl_default_start,
668 .dumpit = ethnl_default_dumpit,
669 .done = ethnl_default_done,
672 .cmd = ETHTOOL_MSG_LINKINFO_GET,
673 .doit = ethnl_default_doit,
674 .start = ethnl_default_start,
675 .dumpit = ethnl_default_dumpit,
676 .done = ethnl_default_done,
679 .cmd = ETHTOOL_MSG_LINKINFO_SET,
680 .flags = GENL_UNS_ADMIN_PERM,
681 .doit = ethnl_set_linkinfo,
684 .cmd = ETHTOOL_MSG_LINKMODES_GET,
685 .doit = ethnl_default_doit,
686 .start = ethnl_default_start,
687 .dumpit = ethnl_default_dumpit,
688 .done = ethnl_default_done,
691 .cmd = ETHTOOL_MSG_LINKMODES_SET,
692 .flags = GENL_UNS_ADMIN_PERM,
693 .doit = ethnl_set_linkmodes,
696 .cmd = ETHTOOL_MSG_LINKSTATE_GET,
697 .doit = ethnl_default_doit,
698 .start = ethnl_default_start,
699 .dumpit = ethnl_default_dumpit,
700 .done = ethnl_default_done,
703 .cmd = ETHTOOL_MSG_DEBUG_GET,
704 .doit = ethnl_default_doit,
705 .start = ethnl_default_start,
706 .dumpit = ethnl_default_dumpit,
707 .done = ethnl_default_done,
710 .cmd = ETHTOOL_MSG_DEBUG_SET,
711 .flags = GENL_UNS_ADMIN_PERM,
712 .doit = ethnl_set_debug,
715 .cmd = ETHTOOL_MSG_WOL_GET,
716 .flags = GENL_UNS_ADMIN_PERM,
717 .doit = ethnl_default_doit,
718 .start = ethnl_default_start,
719 .dumpit = ethnl_default_dumpit,
720 .done = ethnl_default_done,
723 .cmd = ETHTOOL_MSG_WOL_SET,
724 .flags = GENL_UNS_ADMIN_PERM,
725 .doit = ethnl_set_wol,
728 .cmd = ETHTOOL_MSG_FEATURES_GET,
729 .doit = ethnl_default_doit,
730 .start = ethnl_default_start,
731 .dumpit = ethnl_default_dumpit,
732 .done = ethnl_default_done,
735 .cmd = ETHTOOL_MSG_FEATURES_SET,
736 .flags = GENL_UNS_ADMIN_PERM,
737 .doit = ethnl_set_features,
740 .cmd = ETHTOOL_MSG_PRIVFLAGS_GET,
741 .doit = ethnl_default_doit,
742 .start = ethnl_default_start,
743 .dumpit = ethnl_default_dumpit,
744 .done = ethnl_default_done,
747 .cmd = ETHTOOL_MSG_PRIVFLAGS_SET,
748 .flags = GENL_UNS_ADMIN_PERM,
749 .doit = ethnl_set_privflags,
753 static const struct genl_multicast_group ethtool_nl_mcgrps[] = {
754 [ETHNL_MCGRP_MONITOR] = { .name = ETHTOOL_MCGRP_MONITOR_NAME },
757 static struct genl_family ethtool_genl_family = {
758 .name = ETHTOOL_GENL_NAME,
759 .version = ETHTOOL_GENL_VERSION,
761 .parallel_ops = true,
762 .ops = ethtool_genl_ops,
763 .n_ops = ARRAY_SIZE(ethtool_genl_ops),
764 .mcgrps = ethtool_nl_mcgrps,
765 .n_mcgrps = ARRAY_SIZE(ethtool_nl_mcgrps),
770 static int __init ethnl_init(void)
774 ret = genl_register_family(ðtool_genl_family);
775 if (WARN(ret < 0, "ethtool: genetlink family registration failed"))
779 ret = register_netdevice_notifier(ðnl_netdev_notifier);
780 WARN(ret < 0, "ethtool: net device notifier registration failed");
784 subsys_initcall(ethnl_init);