[linux-block.git] / Documentation / netlink / genetlink-legacy.yaml

# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
%YAML 1.2
---
$id: http://kernel.org/schemas/netlink/genetlink-legacy.yaml#
$schema: https://json-schema.org/draft-07/schema

# Common defines
$defs:
  uint:
    type: integer
    minimum: 0
  len-or-define:
    type: [ string, integer ]
    pattern: ^[0-9A-Za-z_]+( - 1)?$
    minimum: 0
  len-or-limit:
    # literal int or limit based on fixed-width type e.g. u8-min, u16-max, etc.
    type: [ string, integer ]
    pattern: ^[su](8|16|32|64)-(min|max)$
    minimum: 0

# Schema for specs
title: Protocol
description: Specification of a genetlink protocol
type: object
required: [ name, doc, attribute-sets, operations ]
additionalProperties: False
properties:
  name:
    description: Name of the genetlink family.
    type: string
  doc:
    type: string
  protocol:
    description: Schema compatibility level. Default is "genetlink".
    enum: [ genetlink, genetlink-c, genetlink-legacy ] # Trim
  uapi-header:
    description: Path to the uAPI header, default is linux/${family-name}.h
    type: string
  # Start genetlink-c
  c-family-name:
    description: Name of the define for the family name.
    type: string
  c-version-name:
    description: Name of the define for the version of the family.
    type: string
  max-by-define:
    description: Makes the number of attributes and commands be specified by a define, not an enum value.
    type: boolean
  cmd-max-name:
    description: Name of the define for the last operation in the list.
    type: string
  cmd-cnt-name:
    description: The explicit name for constant holding the count of operations (last operation + 1).
    type: string
  # End genetlink-c
  # Start genetlink-legacy
  kernel-policy:
    description: |
      Defines if the input policy in the kernel is global, per-operation, or split per operation type.
      Default is split.
    enum: [ split, per-op, global ]
  version:
    description: Generic Netlink family version. Default is 1.
    type: integer
    minimum: 1
  # End genetlink-legacy

  definitions:
    description: List of type and constant definitions (enums, flags, defines).
    type: array
    items:
      type: object
      required: [ type, name ]
      additionalProperties: False
      properties:
        name:
          type: string
        header:
          description: For C-compatible languages, header which already defines this value.
          type: string
        type:
          enum: [ const, enum, flags, struct ] # Trim
        doc:
          type: string
        # For const
        value:
          description: For const - the value.
          type: [ string, integer ]
        # For enum and flags
        value-start:
          description: For enum or flags the literal initializer for the first value.
          type: [ string, integer ]
        entries:
          description: For enum or flags array of values.
          type: array
          items:
            oneOf:
              - type: string
              - type: object
                required: [ name ]
                additionalProperties: False
                properties:
                  name:
                    type: string
                  value:
                    type: integer
                  doc:
                    type: string
        render-max:
          description: Render the max members for this enum.
          type: boolean
        # Start genetlink-c
        enum-name:
          description: Name for enum, if empty no name will be used.
          type: [ string, "null" ]
        name-prefix:
          description: For enum the prefix of the values, optional.
          type: string
        # End genetlink-c
        # Start genetlink-legacy
        members:
          description: List of struct members. Only scalars and strings members allowed.
          type: array
          items:
            type: object
            required: [ name, type ]
            additionalProperties: False
            properties:
              name:
                type: string
              type:
                description: The netlink attribute type
                enum: [ u8, u16, u32, u64, s8, s16, s32, s64, string, binary ]
              len:
                $ref: '#/$defs/len-or-define'
              byte-order:
                enum: [ little-endian, big-endian ]
              doc:
                description: Documentation for the struct member attribute.
                type: string
              enum:
                description: Name of the enum type used for the attribute.
                type: string
              display-hint: &display-hint
                description: |
                  Optional format indicator that is intended only for choosing
                  the right formatting mechanism when displaying values of this
                  type.
                enum: [ hex, mac, fddi, ipv4, ipv6, uuid ]
        # End genetlink-legacy

  attribute-sets:
    description: Definition of attribute spaces for this family.
    type: array
    items:
      description: Definition of a single attribute space.
      type: object
      required: [ name, attributes ]
      additionalProperties: False
      properties:
        name:
          description: |
            Name used when referring to this space in other definitions, not used outside of the spec.
          type: string
        name-prefix:
          description: |
            Prefix for the C enum name of the attributes. Default family[name]-set[name]-a-
          type: string
        enum-name:
          description: Name for the enum type of the attribute.
          type: string
        doc:
          description: Documentation of the space.
          type: string
        subset-of:
          description: |
            Name of another space which this is a logical part of. Sub-spaces can be used to define
            a limited group of attributes which are used in a nest.
          type: string
        # Start genetlink-c
        attr-cnt-name:
          description: The explicit name for constant holding the count of attributes (last attr + 1).
          type: string
        attr-max-name:
          description: The explicit name for last member of attribute enum.
          type: string
        # End genetlink-c
        attributes:
          description: List of attributes in the space.
          type: array
          items:
            type: object
            required: [ name ]
            additionalProperties: False
            properties:
              name:
                type: string
              type: &attr-type
                description: The netlink attribute type
                enum: [ unused, pad, flag, binary, bitfield32,
                        uint, sint, u8, u16, u32, u64, s32, s64,
                        string, nest, array-nest, nest-type-value ]
              doc:
                description: Documentation of the attribute.
                type: string
              value:
                description: Value for the enum item representing this attribute in the uAPI.
                $ref: '#/$defs/uint'
              type-value:
                description: Name of the value extracted from the type of a nest-type-value attribute.
                type: array
                items:
                  type: string
              byte-order:
                enum: [ little-endian, big-endian ]
              multi-attr:
                type: boolean
              nested-attributes:
                description: Name of the space (sub-space) used inside the attribute.
                type: string
              enum:
                description: Name of the enum type used for the attribute.
                type: string
              enum-as-flags:
                description: |
                  Treat the enum as flags. In most cases enum is either used as flags or as values.
                  Sometimes, however, both forms are necessary, in which case header contains the enum
                  form while specific attributes may request to convert the values into a bitfield.
                type: boolean
              checks:
                description: Kernel input validation.
                type: object
                additionalProperties: False
                properties:
                  flags-mask:
                    description: Name of the flags constant on which to base mask (unsigned scalar types only).
                    type: string
                  min:
                    description: Min value for an integer attribute.
                    $ref: '#/$defs/len-or-limit'
                  max:
                    description: Max value for an integer attribute.
                    $ref: '#/$defs/len-or-limit'
                  min-len:
                    description: Min length for a binary attribute.
                    $ref: '#/$defs/len-or-define'
                  max-len:
                    description: Max length for a string or a binary attribute.
                    $ref: '#/$defs/len-or-define'
                  exact-len:
                    description: Exact length for a string or a binary attribute.
                    $ref: '#/$defs/len-or-define'
              sub-type: *attr-type
              display-hint: *display-hint
              # Start genetlink-c
              name-prefix:
                type: string
              # End genetlink-c
              # Start genetlink-legacy
              struct:
                description: Name of the struct type used for the attribute.
                type: string
              # End genetlink-legacy

      # Make sure name-prefix does not appear in subsets (subsets inherit naming)
      dependencies:
        name-prefix:
          not:
            required: [ subset-of ]
        subset-of:
          not:
            required: [ name-prefix ]

      # type property is only required if not in subset definition
      if:
        properties:
          subset-of:
            not:
              type: string
      then:
        properties:
          attributes:
            items:
              required: [ type ]

  operations:
    description: Operations supported by the protocol.
    type: object
    required: [ list ]
    additionalProperties: False
    properties:
      enum-model:
        description: |
          The model of assigning values to the operations.
          "unified" is the recommended model where all message types belong
          to a single enum.
          "directional" has the messages sent to the kernel and from the kernel
          enumerated separately.
        enum: [ unified, directional ] # Trim
      name-prefix:
        description: |
          Prefix for the C enum name of the command. The name is formed by concatenating
          the prefix with the upper case name of the command, with dashes replaced by underscores.
        type: string
      enum-name:
        description: Name for the enum type with commands.
        type: string
      async-prefix:
        description: Same as name-prefix but used to render notifications and events to separate enum.
        type: string
      async-enum:
        description: Name for the enum type with notifications/events.
        type: string
      # Start genetlink-legacy
      fixed-header: &fixed-header
        description: |
          Name of the structure defining the optional fixed-length protocol
          header. This header is placed in a message after the netlink and
          genetlink headers and before any attributes.
        type: string
      # End genetlink-legacy
      list:
        description: List of commands
        type: array
        items:
          type: object
          additionalProperties: False
          required: [ name, doc ]
          properties:
            name:
              description: Name of the operation, also defining its C enum value in uAPI.
              type: string
            doc:
              description: Documentation for the command.
              type: string
            value:
              description: Value for the enum in the uAPI.
              $ref: '#/$defs/uint'
            attribute-set:
              description: |
                Attribute space from which attributes directly in the requests and replies
                to this command are defined.
              type: string
            flags: &cmd_flags
              description: Command flags.
              type: array
              items:
                enum: [ admin-perm, uns-admin-perm ]
            dont-validate:
              description: Kernel attribute validation flags.
              type: array
              items:
                enum: [ strict, dump, dump-strict ]
            config-cond:
              description: |
                Name of the kernel config option gating the presence of
                the operation, without the 'CONFIG_' prefix.
              type: string
            # Start genetlink-legacy
            fixed-header: *fixed-header
            # End genetlink-legacy
            do: &subop-type
              description: Main command handler.
              type: object
              additionalProperties: False
              properties:
                request: &subop-attr-list
                  description: Definition of the request message for a given command.
                  type: object
                  additionalProperties: False
                  properties:
                    attributes:
                      description: |
                        Names of attributes from the attribute-set (not full attribute
                        definitions, just names).
                      type: array
                      items:
                        type: string
                    # Start genetlink-legacy
                    value:
                      description: |
                        ID of this message if value for request and response differ,
                        i.e. requests and responses have different message enums.
                      $ref: '#/$defs/uint'
                    # End genetlink-legacy
                reply: *subop-attr-list
                pre:
                  description: Hook for a function to run before the main callback (pre_doit or start).
                  type: string
                post:
                  description: Hook for a function to run after the main callback (post_doit or done).
                  type: string
            dump: *subop-type
            notify:
              description: Name of the command sharing the reply type with this notification.
              type: string
            event:
              type: object
              additionalProperties: False
              properties:
                attributes:
                  description: Explicit list of the attributes for the notification.
                  type: array
                  items:
                    type: string
            mcgrp:
              description: Name of the multicast group generating given notification.
              type: string
  mcast-groups:
    description: List of multicast groups.
    type: object
    required: [ list ]
    additionalProperties: False
    properties:
      list:
        description: List of groups.
        type: array
        items:
          type: object
          required: [ name ]
          additionalProperties: False
          properties:
            name:
              description: |
                The name for the group, used to form the define and the value of the define.
              type: string
            # Start genetlink-c
            c-define-name:
              description: Override for the name of the define in C uAPI.
              type: string
            # End genetlink-c
            flags: *cmd_flags
Commit	Line	Data
4e16b6a7	1	# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
e616c07c JK	2	%YAML 1.2
	3	---
	4	$id: http://kernel.org/schemas/netlink/genetlink-legacy.yaml#
	5	$schema: https://json-schema.org/draft-07/schema
	6
	7	# Common defines
	8	$defs:
	9	uint:
	10	type: integer
	11	minimum: 0
	12	len-or-define:
	13	type: [ string, integer ]
	14	pattern: ^[0-9A-Za-z_]+( - 1)?$
	15	minimum: 0
f9bc3cbc JK	16	len-or-limit:
	17	# literal int or limit based on fixed-width type e.g. u8-min, u16-max, etc.
	18	type: [ string, integer ]
	19	pattern: ^[su](8\|16\|32\|64)-(min\|max)$
	20	minimum: 0
e616c07c JK	21
	22	# Schema for specs
	23	title: Protocol
	24	description: Specification of a genetlink protocol
	25	type: object
	26	required: [ name, doc, attribute-sets, operations ]
	27	additionalProperties: False
	28	properties:
	29	name:
	30	description: Name of the genetlink family.
	31	type: string
	32	doc:
	33	type: string
e616c07c JK	34	protocol:
	35	description: Schema compatibility level. Default is "genetlink".
	36	enum: [ genetlink, genetlink-c, genetlink-legacy ] # Trim
e616c07c JK	37	uapi-header:
	38	description: Path to the uAPI header, default is linux/${family-name}.h
	39	type: string
82b32970	40	# Start genetlink-c
e616c07c JK	41	c-family-name:
	42	description: Name of the define for the family name.
	43	type: string
	44	c-version-name:
c4e1ab07	45	description: Name of the define for the version of the family.
e616c07c JK	46	type: string
	47	max-by-define:
	48	description: Makes the number of attributes and commands be specified by a define, not an enum value.
	49	type: boolean
6479c975 DC	50	cmd-max-name:
	51	description: Name of the define for the last operation in the list.
	52	type: string
	53	cmd-cnt-name:
	54	description: The explicit name for constant holding the count of operations (last operation + 1).
	55	type: string
e616c07c JK	56	# End genetlink-c
	57	# Start genetlink-legacy
	58	kernel-policy:
	59	description: \|
	60	Defines if the input policy in the kernel is global, per-operation, or split per operation type.
	61	Default is split.
	62	enum: [ split, per-op, global ]
0f07415e JP	63	version:
	64	description: Generic Netlink family version. Default is 1.
	65	type: integer
	66	minimum: 1
e616c07c JK	67	# End genetlink-legacy
	68
	69	definitions:
	70	description: List of type and constant definitions (enums, flags, defines).
	71	type: array
	72	items:
	73	type: object
	74	required: [ type, name ]
	75	additionalProperties: False
	76	properties:
	77	name:
	78	type: string
	79	header:
	80	description: For C-compatible languages, header which already defines this value.
	81	type: string
	82	type:
	83	enum: [ const, enum, flags, struct ] # Trim
	84	doc:
	85	type: string
	86	# For const
	87	value:
	88	description: For const - the value.
	89	type: [ string, integer ]
	90	# For enum and flags
	91	value-start:
	92	description: For enum or flags the literal initializer for the first value.
	93	type: [ string, integer ]
	94	entries:
	95	description: For enum or flags array of values.
	96	type: array
	97	items:
	98	oneOf:
	99	- type: string
	100	- type: object
	101	required: [ name ]
	102	additionalProperties: False
	103	properties:
	104	name:
	105	type: string
	106	value:
	107	type: integer
	108	doc:
	109	type: string
	110	render-max:
	111	description: Render the max members for this enum.
	112	type: boolean
	113	# Start genetlink-c
	114	enum-name:
	115	description: Name for enum, if empty no name will be used.
	116	type: [ string, "null" ]
	117	name-prefix:
	118	description: For enum the prefix of the values, optional.
	119	type: string
	120	# End genetlink-c
	121	# Start genetlink-legacy
	122	members:
	123	description: List of struct members. Only scalars and strings members allowed.
	124	type: array
	125	items:
	126	type: object
	127	required: [ name, type ]
	128	additionalProperties: False
	129	properties:
	130	name:
131	type: string
132	type:
737eab77 DH	133	description: The netlink attribute type
737eab77 DH	134	enum: [ u8, u16, u32, u64, s8, s16, s32, s64, string, binary ]
e616c07c JK	135	len:
e616c07c JK	136	$ref: '#/$defs/len-or-define'
bddd2e56 DH	137	byte-order:
bddd2e56 DH	138	enum: [ little-endian, big-endian ]
6d6bae63 DH	139	doc:
	140	description: Documentation for the struct member attribute.
	141	type: string
313a7a80 DH	142	enum:
	143	description: Name of the enum type used for the attribute.
	144	type: string
737eab77 DH	145	display-hint: &display-hint
	146	description: \|
	147	Optional format indicator that is intended only for choosing
	148	the right formatting mechanism when displaying values of this
	149	type.
	150	enum: [ hex, mac, fddi, ipv4, ipv6, uuid ]
e616c07c JK	151	# End genetlink-legacy
	152
	153	attribute-sets:
	154	description: Definition of attribute spaces for this family.
	155	type: array
	156	items:
	157	description: Definition of a single attribute space.
	158	type: object
	159	required: [ name, attributes ]
	160	additionalProperties: False
	161	properties:
	162	name:
	163	description: \|
	164	Name used when referring to this space in other definitions, not used outside of the spec.
	165	type: string
	166	name-prefix:
	167	description: \|
	168	Prefix for the C enum name of the attributes. Default family[name]-set[name]-a-
	169	type: string
	170	enum-name:
	171	description: Name for the enum type of the attribute.
	172	type: string
	173	doc:
	174	description: Documentation of the space.
	175	type: string
	176	subset-of:
	177	description: \|
	178	Name of another space which this is a logical part of. Sub-spaces can be used to define
	179	a limited group of attributes which are used in a nest.
	180	type: string
	181	# Start genetlink-c
	182	attr-cnt-name:
	183	description: The explicit name for constant holding the count of attributes (last attr + 1).
	184	type: string
	185	attr-max-name:
	186	description: The explicit name for last member of attribute enum.
	187	type: string
	188	# End genetlink-c
	189	attributes:
	190	description: List of attributes in the space.
	191	type: array
	192	items:
	193	type: object
e18f3dc2	194	required: [ name ]
e616c07c JK	195	additionalProperties: False
	196	properties:
	197	name:
	198	type: string
	199	type: &attr-type
737eab77	200	description: The netlink attribute type
4e2846fd	201	enum: [ unused, pad, flag, binary, bitfield32,
7d4caf54	202	uint, sint, u8, u16, u32, u64, s32, s64,
e616c07c JK	203	string, nest, array-nest, nest-type-value ]
	204	doc:
	205	description: Documentation of the attribute.
	206	type: string
	207	value:
	208	description: Value for the enum item representing this attribute in the uAPI.
	209	$ref: '#/$defs/uint'
	210	type-value:
	211	description: Name of the value extracted from the type of a nest-type-value attribute.
	212	type: array
	213	items:
	214	type: string
	215	byte-order:
	216	enum: [ little-endian, big-endian ]
	217	multi-attr:
	218	type: boolean
	219	nested-attributes:
	220	description: Name of the space (sub-space) used inside the attribute.
	221	type: string
	222	enum:
	223	description: Name of the enum type used for the attribute.
	224	type: string
	225	enum-as-flags:
	226	description: \|
	227	Treat the enum as flags. In most cases enum is either used as flags or as values.
	228	Sometimes, however, both forms are necessary, in which case header contains the enum
	229	form while specific attributes may request to convert the values into a bitfield.
	230	type: boolean
	231	checks:
	232	description: Kernel input validation.
	233	type: object
	234	additionalProperties: False
	235	properties:
	236	flags-mask:
	237	description: Name of the flags constant on which to base mask (unsigned scalar types only).
	238	type: string
	239	min:
	240	description: Min value for an integer attribute.
f9bc3cbc	241	$ref: '#/$defs/len-or-limit'
668c1ac8 JK	242	max:
668c1ac8 JK	243	description: Max value for an integer attribute.
f9bc3cbc	244	$ref: '#/$defs/len-or-limit'
e616c07c JK	245	min-len:
	246	description: Min length for a binary attribute.
	247	$ref: '#/$defs/len-or-define'
	248	max-len:
	249	description: Max length for a string or a binary attribute.
	250	$ref: '#/$defs/len-or-define'
0c63ad37 DC	251	exact-len:
	252	description: Exact length for a string or a binary attribute.
	253	$ref: '#/$defs/len-or-define'
e616c07c	254	sub-type: *attr-type
737eab77	255	display-hint: *display-hint
ed2042cc JK	256	# Start genetlink-c
	257	name-prefix:
	258	type: string
	259	# End genetlink-c
26071913 DH	260	# Start genetlink-legacy
	261	struct:
	262	description: Name of the struct type used for the attribute.
	263	type: string
	264	# End genetlink-legacy
e616c07c JK	265
	266	# Make sure name-prefix does not appear in subsets (subsets inherit naming)
	267	dependencies:
	268	name-prefix:
	269	not:
	270	required: [ subset-of ]
	271	subset-of:
	272	not:
	273	required: [ name-prefix ]
	274
e18f3dc2 JP	275	# type property is only required if not in subset definition
	276	if:
	277	properties:
	278	subset-of:
	279	not:
	280	type: string
	281	then:
	282	properties:
	283	attributes:
	284	items:
	285	required: [ type ]
	286
e616c07c JK	287	operations:
	288	description: Operations supported by the protocol.
	289	type: object
	290	required: [ list ]
	291	additionalProperties: False
	292	properties:
	293	enum-model:
	294	description: \|
	295	The model of assigning values to the operations.
	296	"unified" is the recommended model where all message types belong
	297	to a single enum.
	298	"directional" has the messages sent to the kernel and from the kernel
	299	enumerated separately.
8403bf04	300	enum: [ unified, directional ] # Trim
e616c07c JK	301	name-prefix:
	302	description: \|
	303	Prefix for the C enum name of the command. The name is formed by concatenating
	304	the prefix with the upper case name of the command, with dashes replaced by underscores.
	305	type: string
	306	enum-name:
	307	description: Name for the enum type with commands.
	308	type: string
	309	async-prefix:
	310	description: Same as name-prefix but used to render notifications and events to separate enum.
	311	type: string
	312	async-enum:
	313	description: Name for the enum type with notifications/events.
	314	type: string
f036d936 DH	315	# Start genetlink-legacy
	316	fixed-header: &fixed-header
	317	description: \|
	318	Name of the structure defining the optional fixed-length protocol
	319	header. This header is placed in a message after the netlink and
	320	genetlink headers and before any attributes.
	321	type: string
	322	# End genetlink-legacy
e616c07c JK	323	list:
	324	description: List of commands
	325	type: array
	326	items:
	327	type: object
	328	additionalProperties: False
	329	required: [ name, doc ]
	330	properties:
	331	name:
	332	description: Name of the operation, also defining its C enum value in uAPI.
	333	type: string
	334	doc:
	335	description: Documentation for the command.
	336	type: string
	337	value:
	338	description: Value for the enum in the uAPI.
	339	$ref: '#/$defs/uint'
	340	attribute-set:
	341	description: \|
	342	Attribute space from which attributes directly in the requests and replies
	343	to this command are defined.
	344	type: string
	345	flags: &cmd_flags
	346	description: Command flags.
	347	type: array
	348	items:
52c121f4	349	enum: [ admin-perm, uns-admin-perm ]
e616c07c JK	350	dont-validate:
	351	description: Kernel attribute validation flags.
	352	type: array
	353	items:
78c96d7b	354	enum: [ strict, dump, dump-strict ]
bc30bb88 JK	355	config-cond:
	356	description: \|
	357	Name of the kernel config option gating the presence of
	358	the operation, without the 'CONFIG_' prefix.
	359	type: string
f036d936 DH	360	# Start genetlink-legacy
	361	fixed-header: *fixed-header
	362	# End genetlink-legacy
e616c07c JK	363	do: &subop-type
	364	description: Main command handler.
	365	type: object
	366	additionalProperties: False
	367	properties:
	368	request: &subop-attr-list
	369	description: Definition of the request message for a given command.
	370	type: object
	371	additionalProperties: False
	372	properties:
	373	attributes:
	374	description: \|
	375	Names of attributes from the attribute-set (not full attribute
	376	definitions, just names).
	377	type: array
	378	items:
	379	type: string
8403bf04 JK	380	# Start genetlink-legacy
	381	value:
	382	description: \|
	383	ID of this message if value for request and response differ,
	384	i.e. requests and responses have different message enums.
	385	$ref: '#/$defs/uint'
	386	# End genetlink-legacy
e616c07c JK	387	reply: *subop-attr-list
	388	pre:
	389	description: Hook for a function to run before the main callback (pre_doit or start).
	390	type: string
	391	post:
	392	description: Hook for a function to run after the main callback (post_doit or done).
	393	type: string
	394	dump: *subop-type
	395	notify:
	396	description: Name of the command sharing the reply type with this notification.
	397	type: string
	398	event:
	399	type: object
	400	additionalProperties: False
	401	properties:
	402	attributes:
	403	description: Explicit list of the attributes for the notification.
	404	type: array
	405	items:
	406	type: string
	407	mcgrp:
	408	description: Name of the multicast group generating given notification.
	409	type: string
	410	mcast-groups:
	411	description: List of multicast groups.
	412	type: object
	413	required: [ list ]
	414	additionalProperties: False
	415	properties:
	416	list:
	417	description: List of groups.
	418	type: array
	419	items:
	420	type: object
	421	required: [ name ]
	422	additionalProperties: False
	423	properties:
	424	name:
	425	description: \|
	426	The name for the group, used to form the define and the value of the define.
	427	type: string
	428	# Start genetlink-c
	429	c-define-name:
	430	description: Override for the name of the define in C uAPI.
	431	type: string
	432	# End genetlink-c
	433	flags: *cmd_flags