doc/netlink: add a YAML spec for team
Subsystems (4)
v2 cover doc/netlink: add a YAML spec for team
Add a YAML spec for team. As we need to link two objects together to form the team module, rename team to team_core for linking.
Hangbin Liu (4):
Documentation: netlink: add a YAML spec for team
net: team: rename team to team_core for linking
net: team: use policy generated by YAML spec
uapi: team: use header file generated from YAML spec
Documentation/netlink/specs/team.yaml | 208 +++++++++++++++++++++++
MAINTAINERS | 1 +
drivers/net/team/Makefile | 1 +
drivers/net/team/{team.c => team_core.c} | 63 +------
drivers/net/team/team_nl.c | 59 +++++++
drivers/net/team/team_nl.h | 29 ++++
include/uapi/linux/if_team.h | 116 +++++--------
7 files changed, 350 insertions(+), 127 deletions(-)
create mode 100644 Documentation/netlink/specs/team.yaml
rename drivers/net/team/{team.c => team_core.c} (97%)
create mode 100644 drivers/net/team/team_nl.c
create mode 100644 drivers/net/team/team_nl.hSignature · 1 line
2.43.0
PATCH v2 1/4 Documentation: netlink: add a YAML spec for team
Add a YAML specification for team.
---
Draft -> v1: remove dump from team options.
--- Documentation/netlink/specs/team.yaml | 208 ++++++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 209 insertions(+) create mode 100644 Documentation/netlink/specs/team.yaml
Documentation/netlink/specs/team.yaml new file +208 -0
@@ -0,0 +1,208 @@ +# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) + +name: team + +protocol: genetlink-legacy + +doc: | + Network team device driver. + +c-family-name: team-genl-name +c-version-name: team-genl-version +kernel-policy: global +uapi-header: linux/if_team.h + +definitions: + - + name: string-max-len + type: const + value: 32 + - + name: genl-change-event-mc-grp-name + type: const + value: change_event + +attribute-sets: + - + name: team + doc: + The team nested layout of get/set msg looks like + [TEAM_ATTR_LIST_OPTION] + [TEAM_ATTR_ITEM_OPTION] + [TEAM_ATTR_OPTION_*], ... + [TEAM_ATTR_ITEM_OPTION] + [TEAM_ATTR_OPTION_*], ... + ... + [TEAM_ATTR_LIST_PORT] + [TEAM_ATTR_ITEM_PORT] + [TEAM_ATTR_PORT_*], ... + [TEAM_ATTR_ITEM_PORT] + [TEAM_ATTR_PORT_*], ... + ... + name-prefix: team-attr- + attributes: + - + name: unspec + type: unused + value: 0 + - + name: team-ifindex + type: u32 + - + name: list-option + type: nest + nested-attributes: item-option + - + name: list-port + type: nest + nested-attributes: item-port + - + name: item-option + name-prefix: team-attr-item- + attr-cnt-name: __team-attr-item-option-max + attr-max-name: team-attr-item-option-max + attributes: + - + name: option-unspec + type: unused + value: 0 + - + name: option + type: nest + nested-attributes: attr-option + - + name: attr-option + name-prefix: team-attr-option- + attributes: + - + name: unspec + type: unused + value: 0 + - + name: name + type: string + checks: + max-len: string-max-len + unterminated-ok: true + - + name: changed + type: flag + - + name: type + type: u8 + - + name: data + type: binary + - + name: removed + type: flag + - + name: port-ifindex + type: u32 + doc: for per-port options + - + name: array-index + type: u32 + doc: for array options + - + name: item-port + name-prefix: team-attr-item- + attr-cnt-name: __team-attr-item-port-max + attr-max-name: team-attr-item-port-max + attributes: + - + name: port-unspec + type: unused + value: 0 + - + name: port + type: nest + nested-attributes: attr-port + - + name: attr-port + name-prefix: team-attr-port- + attributes: + - + name: unspec + type: unused + value: 0 + - + name: ifindex + type: u32 + - + name: changed + type: flag + - + name: linkup + type: flag + - + name: speed + type: u32 + - + name: duplex + type: u8 + - + name: removed + type: flag + +operations: + list: + - + name: noop + doc: No operation + value: 0 + attribute-set: team + dont-validate: [ strict ] + + do: + # Actually it only reply the team netlink family + reply: + attributes: + - unspec + + - + name: options-set + doc: Set team options + attribute-set: team + dont-validate: [ strict ] + flags: [ admin-perm ] + + do: + request: &option_attrs + attributes: + - team-ifindex + - list-option + - item-option + - attr-option + reply: *option_attrs + + - + name: options-get + doc: Get team options info + attribute-set: team + dont-validate: [ strict ] + flags: [ admin-perm ] + + do: + request: + attributes: + - team-ifindex + reply: *option_attrs + + - + name: port-list-get + doc: Get team ports info + attribute-set: team + dont-validate: [ strict ] + flags: [ admin-perm ] + + do: + request: + attributes: + - team-ifindex + reply: &port_attrs + attributes: + - team-ifindex + - list-port + - item-port + - attr-port
MAINTAINERS +1 -0
@@ -21636,6 +21636,7 @@ TEAM DRIVER M: Jiri Pirko <[email protected]> L: [email protected] S: Supported +F: Documentation/netlink/specs/team.yaml F: drivers/net/team/ F: include/linux/if_team.h F: include/uapi/linux/if_team.h
Signature · 1 line
2.43.0
Jakub Kicinski
maintainerRe: [PATCHv2 net-next 1/4] Documentation: netlink: add a YAML spec for team
Documentation/netlink/specs/team.yaml line 175
Quoted 5 lines · On Wed, 27 Mar 2024 18:03:15 +0800 Hangbin Liu wrote:
Documentation/netlink/specs/team.yaml new file +5
-0+ request: &option_attrs + attributes: + - team-ifindex + - list-option + - item-option
item-option is a name of a space, not of an attribute
please test with:
make -C tools/net/ynl
Quoted 1 line
+ - attr-option
Signature · 1 line
pw-bot: cr
PATCH v2 2/4 net: team: rename team to team_core for linking
In reply to Hangbin LiuSimilar with commit 08d323234d10 ("net: fou: rename the source for linking"), We'll need to link two objects together to form the team module. This means the source can't be called team, the build system expects team.o to be the combined object.
---
drivers/net/team/Makefile | 1 +
drivers/net/team/{team.c => team_core.c} | 0
2 files changed, 1 insertion(+)
rename drivers/net/team/{team.c => team_core.c} (100%)drivers/net/team/Makefile +1 -0
@@ -3,6 +3,7 @@ # Makefile for the network team driver # +team-y:= team_core.o obj-$(CONFIG_NET_TEAM) += team.o obj-$(CONFIG_NET_TEAM_MODE_BROADCAST) += team_mode_broadcast.o obj-$(CONFIG_NET_TEAM_MODE_ROUNDROBIN) += team_mode_roundrobin.o
drivers/net/team/team_core.c renamed from drivers/net/team/team.c +0 -0
Signature · 1 line
2.43.0
PATCH v2 3/4 net: team: use policy generated by YAML spec
In reply to Hangbin Liugenerated with:
$ ./tools/net/ynl/ynl-gen-c.py --mode kernel \
Quoted 2 lines
--spec
Documentation/netlink/specs/team.yaml--source \
-odrivers/net/team/team_nl.c
$ ./tools/net/ynl/ynl-gen-c.py --mode kernel \
Quoted 2 lines
--spec
Documentation/netlink/specs/team.yaml--header \
-odrivers/net/team/team_nl.h
The TEAM_ATTR_LIST_PORT in team_nl_policy is removed as it is only in the port list reply attributes.
---
v1 -> v2:
1. adjust the continuation line (Jakub Kicinski)
2. adjust the family maxattr (Jakub Kicinski)
Draft -> v1:
1. remove all GENL_DONT_VALIDATE_DUMP from genl_small_ops since we actually don't have dump option. (Jiri Pirko)
--- drivers/net/team/Makefile | 2 +- drivers/net/team/team_core.c | 63 ++++++------------------------------ drivers/net/team/team_nl.c | 59 +++++++++++++++++++++++++++++++++ drivers/net/team/team_nl.h | 29 +++++++++++++++++ 4 files changed, 98 insertions(+), 55 deletions(-) create mode 100644 drivers/net/team/team_nl.c create mode 100644 drivers/net/team/team_nl.h
drivers/net/team/Makefile +1 -1
@@ -3,7 +3,7 @@ # Makefile for the network team driver # -team-y:= team_core.o +team-y:= team_core.o team_nl.o obj-$(CONFIG_NET_TEAM) += team.o obj-$(CONFIG_NET_TEAM_MODE_BROADCAST) += team_mode_broadcast.o obj-$(CONFIG_NET_TEAM_MODE_ROUNDROBIN) += team_mode_roundrobin.o
drivers/net/team/team_core.c +9 -54
111 lines not on this page · raw message
drivers/net/team/team_nl.c new file +59 -0
59 lines not on this page · raw message
drivers/net/team/team_nl.h new file +29 -0
@@ -0,0 +1,29 @@ +/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */ +/* Do not edit directly, auto-generated from: */ +/* Documentation/netlink/specs/team.yaml */ +/* YNL-GEN kernel header */ + +#ifndef _LINUX_TEAM_GEN_H +#define _LINUX_TEAM_GEN_H + +#include <net/netlink.h> +#include <net/genetlink.h> + +#include <uapi/linux/if_team.h> + +/* Common nested types */ +extern const struct nla_policy team_attr_option_nl_policy[TEAM_ATTR_OPTION_ARRAY_INDEX +1 ]; +extern const struct nla_policy team_item_option_nl_policy[TEAM_ATTR_ITEM_OPTION +1 ]; + +/* Global operation policy for team */ +extern const struct nla_policy team_nl_policy[TEAM_ATTR_LIST_OPTION +1 ]; + +/* Ops table for team */ +extern const struct genl_small_ops team_nl_ops[4 ]; + +int team_nl_noop_doit (struct sk_buff *skb,struct genl_info *info); +int team_nl_options_set_doit (struct sk_buff *skb,struct genl_info *info); +int team_nl_options_get_doit (struct sk_buff *skb,struct genl_info *info); +int team_nl_port_list_get_doit (struct sk_buff *skb,struct genl_info *info); + +#endif /* _LINUX_TEAM_GEN_H */
Signature · 1 line
2.43.0
PATCH v2 4/4 uapi: team: use header file generated from YAML spec
In reply to Hangbin Liugenerated with:
$ ./tools/net/ynl/ynl-gen-c.py --mode uapi \
Quoted 2 lines
--spec
Documentation/netlink/specs/team.yaml\
--header -oinclude/uapi/linux/if_team.h
--- include/uapi/linux/if_team.h | 116 +++++++++++++---------------------- 1 file changed, 43 insertions(+), 73 deletions(-)
include/uapi/linux/if_team.h +43 -73
@@ -1,108 +1,78 @@ -/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ -/* -* include/linux/if_team.h - Network team device driver header -* Copyright (c) 2011 Jiri Pirko <[email protected]> -* -* This program is free software; you can redistribute it and/or modify -* it under the terms of the GNU General Public License as published by -* the Free Software Foundation; either version 2 of the License, or -* (at your option) any later version. -*/ +/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */ +/* Do not edit directly, auto-generated from: */ +/* Documentation/netlink/specs/team.yaml */ +/* YNL-GEN uapi header */ -#ifndef _UAPI_LINUX_IF_TEAM_H_ -#define _UAPI_LINUX_IF_TEAM_H_ +#ifndef _UAPI_LINUX_IF_TEAM_H +#define _UAPI_LINUX_IF_TEAM_H +#define TEAM_GENL_NAME "team" +#define TEAM_GENL_VERSION 1 -#define TEAM_STRING_MAX_LEN 32 - -/********************************** -* NETLINK_GENERIC netlink family. -**********************************/ - -enum { -TEAM_CMD_NOOP , -TEAM_CMD_OPTIONS_SET , -TEAM_CMD_OPTIONS_GET , -TEAM_CMD_PORT_LIST_GET , - - __TEAM_CMD_MAX, -TEAM_CMD_MAX = (__TEAM_CMD_MAX -1 ), -}; +#define TEAM_STRING_MAX_LEN 32 +#define TEAM_GENL_CHANGE_EVENT_MC_GRP_NAME "change_event"enum {TEAM_ATTR_UNSPEC , -TEAM_ATTR_TEAM_IFINDEX ,/* u32 */ -TEAM_ATTR_LIST_OPTION ,/* nest */ -TEAM_ATTR_LIST_PORT ,/* nest */ +TEAM_ATTR_TEAM_IFINDEX , +TEAM_ATTR_LIST_OPTION , +TEAM_ATTR_LIST_PORT , __TEAM_ATTR_MAX, -TEAM_ATTR_MAX = __TEAM_ATTR_MAX -1 , +TEAM_ATTR_MAX = (__TEAM_ATTR_MAX -1 ) }; -/* Nested layout of get/set msg: -* -* [TEAM_ATTR_LIST_OPTION] -* [TEAM_ATTR_ITEM_OPTION] -* [TEAM_ATTR_OPTION_*], ... -* [TEAM_ATTR_ITEM_OPTION] -* [TEAM_ATTR_OPTION_*], ... -* ... -* [TEAM_ATTR_LIST_PORT] -* [TEAM_ATTR_ITEM_PORT] -* [TEAM_ATTR_PORT_*], ... -* [TEAM_ATTR_ITEM_PORT] -* [TEAM_ATTR_PORT_*], ... -* ... -*/ -enum {TEAM_ATTR_ITEM_OPTION_UNSPEC , -TEAM_ATTR_ITEM_OPTION ,/* nest */ +TEAM_ATTR_ITEM_OPTION , __TEAM_ATTR_ITEM_OPTION_MAX, -TEAM_ATTR_ITEM_OPTION_MAX = __TEAM_ATTR_ITEM_OPTION_MAX -1 , +TEAM_ATTR_ITEM_OPTION_MAX = (__TEAM_ATTR_ITEM_OPTION_MAX -1 ) };enum {TEAM_ATTR_OPTION_UNSPEC , -TEAM_ATTR_OPTION_NAME ,/* string */ -TEAM_ATTR_OPTION_CHANGED ,/* flag */ -TEAM_ATTR_OPTION_TYPE ,/* u8 */ -TEAM_ATTR_OPTION_DATA ,/* dynamic */ -TEAM_ATTR_OPTION_REMOVED ,/* flag */ -TEAM_ATTR_OPTION_PORT_IFINDEX ,/* u32 */ /* for per-port options */ -TEAM_ATTR_OPTION_ARRAY_INDEX ,/* u32 */ /* for array options */ +TEAM_ATTR_OPTION_NAME , +TEAM_ATTR_OPTION_CHANGED , +TEAM_ATTR_OPTION_TYPE , +TEAM_ATTR_OPTION_DATA , +TEAM_ATTR_OPTION_REMOVED , +TEAM_ATTR_OPTION_PORT_IFINDEX , +TEAM_ATTR_OPTION_ARRAY_INDEX , __TEAM_ATTR_OPTION_MAX, -TEAM_ATTR_OPTION_MAX = __TEAM_ATTR_OPTION_MAX -1 , +TEAM_ATTR_OPTION_MAX = (__TEAM_ATTR_OPTION_MAX -1 ) };enum {TEAM_ATTR_ITEM_PORT_UNSPEC , -TEAM_ATTR_ITEM_PORT ,/* nest */ +TEAM_ATTR_ITEM_PORT , __TEAM_ATTR_ITEM_PORT_MAX, -TEAM_ATTR_ITEM_PORT_MAX = __TEAM_ATTR_ITEM_PORT_MAX -1 , +TEAM_ATTR_ITEM_PORT_MAX = (__TEAM_ATTR_ITEM_PORT_MAX -1 ) };enum {TEAM_ATTR_PORT_UNSPEC , -TEAM_ATTR_PORT_IFINDEX ,/* u32 */ -TEAM_ATTR_PORT_CHANGED ,/* flag */ -TEAM_ATTR_PORT_LINKUP ,/* flag */ -TEAM_ATTR_PORT_SPEED ,/* u32 */ -TEAM_ATTR_PORT_DUPLEX ,/* u8 */ -TEAM_ATTR_PORT_REMOVED ,/* flag */ +TEAM_ATTR_PORT_IFINDEX , +TEAM_ATTR_PORT_CHANGED , +TEAM_ATTR_PORT_LINKUP , +TEAM_ATTR_PORT_SPEED , +TEAM_ATTR_PORT_DUPLEX , +TEAM_ATTR_PORT_REMOVED , __TEAM_ATTR_PORT_MAX, -TEAM_ATTR_PORT_MAX = __TEAM_ATTR_PORT_MAX -1 , +TEAM_ATTR_PORT_MAX = (__TEAM_ATTR_PORT_MAX -1 ) }; -/* -* NETLINK_GENERIC related info -*/ -#define TEAM_GENL_NAME "team" -#define TEAM_GENL_VERSION 0x1 -#define TEAM_GENL_CHANGE_EVENT_MC_GRP_NAME "change_event" +enum { +TEAM_CMD_NOOP , +TEAM_CMD_OPTIONS_SET , +TEAM_CMD_OPTIONS_GET , +TEAM_CMD_PORT_LIST_GET , + + __TEAM_CMD_MAX, +TEAM_CMD_MAX = (__TEAM_CMD_MAX -1 ) +}; -#endif /* _UAPI_LINUX_IF_TEAM_H_ */ +#endif /* _UAPI_LINUX_IF_TEAM_H */
Signature · 1 line
2.43.0