Documentation/netlink/genetlink.yaml

1 # SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
3 ---
4 $id: http://kernel.org/schemas/netlink/genetlink-legacy.yaml#
5 $schema: https://json-schema.org/draft-07/schema
12   len-or-define:
14     pattern: ^[0-9A-Za-z_-]+( - 1)?$
16   len-or-limit:
17     # literal int, const name, or limit based on fixed-width type
18     # e.g. u8-min, u16-max, etc.
20     pattern: ^[0-9A-Za-z_-]+$
27 required: [ name, doc, attribute-sets, operations ]
38   uapi-header:
39     description: Path to the uAPI header, default is linux/${family-name}.h
52         header:
53           description: For C-compatible languages, header which already defines this value.
61           description: For const - the value.
64         value-start:
72               - type: string
73               - type: object
83         render-max:
87   attribute-sets:
100         name-prefix:
102             Prefix for the C enum name of the attributes. Default family[name]-set[name]-a-
104         enum-name:
110         subset-of:
112             Name of another space which this is a logical part of. Sub-spaces can be used to define
125               type: &attr-type
128                         string, nest, indexed-array, nest-type-value ]
133                 description: Value for the enum item representing this attribute in the uAPI.
135               type-value:
136 …             description: Name of the value extracted from the type of a nest-type-value attribute.
140               byte-order:
141                 enum: [ little-endian, big-endian ]
142               multi-attr:
144               nested-attributes:
145                 description: Name of the space (sub-space) used inside the attribute.
150               enum-as-flags:
153 …               Sometimes, however, both forms are necessary, in which case header contains the enum
161                   flags-mask:
166                     $ref: '#/$defs/len-or-limit'
169                     $ref: '#/$defs/len-or-limit'
170                   min-len:
172                     $ref: '#/$defs/len-or-define'
173                   max-len:
175                     $ref: '#/$defs/len-or-define'
176                   exact-len:
178                     $ref: '#/$defs/len-or-define'
179               sub-type: *attr-type
180               display-hint: &display-hint
187       # Make sure name-prefix does not appear in subsets (subsets inherit naming)
189         name-prefix:
191             required: [ subset-of ]
192         subset-of:
194             required: [ name-prefix ]
199           subset-of:
214       enum-model:
222       name-prefix:
227       enum-name:
230       async-prefix:
231 …     description: Same as name-prefix but used to render notifications and events to separate enum.
233       async-enum:
245               description: Name of the operation, also defining its C enum value in uAPI.
251               description: Value for the enum in the uAPI.
253             attribute-set:
262                 enum: [ admin-perm ]
263             dont-validate:
267                 enum: [ strict, dump, dump-strict ]
268             config-cond:
273             do: &subop-type
278                 request: &subop-attr-list
285                         Names of attributes from the attribute-set (not full attribute
290                 reply: *subop-attr-list
297             dump: *subop-type
313   mcast-groups:
333   kernel-family:
345       sock-priv: