github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-08-01 12:11:59 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

Merge branch 'netlink-specs-fix-all-the-yamllint-errors'

Browse Source 
Donald Hunter says:

====================
netlink: specs: fix all the yamllint errors

yamllint reported ~500 errors and warnings in the netlink specs. Fix all
the reported issues.

Link: https://lore.kernel.org/netdev/m2tt4tt3wv.fsf@gmail.com/
====================

Link: https://patch.msgid.link/20250610125944.85265-1-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
This commit is contained in:
Jakub Kicinski 2025-06-11 14:01:21 -07:00
commit a184bb1e71
26 changed files with 440 additions and 418 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
Documentation/netlink/specs/conntrack.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: conntrack
protocol: netlink-raw
protonum: 12
@ -195,17 +195,17 @@ attribute-sets:
-
name: tuple-attrs
attributes:
-
-
name: tuple-ip
type: nest
nested-attributes: tuple-ip-attrs
doc: conntrack l3 information
-
-
name: tuple-proto
type: nest
nested-attributes: tuple-proto-attrs
doc: conntrack l4 information
-
-
name: tuple-zone
type: u16
byte-order: big-endian
@ -213,74 +213,74 @@ attribute-sets:
-
name: protoinfo-tcp-attrs
attributes:
-
-
name: tcp-state
type: u8
enum: nf-ct-tcp-state
doc: tcp connection state
-
-
name: tcp-wscale-original
type: u8
doc: window scaling factor in original direction
-
-
name: tcp-wscale-reply
type: u8
doc: window scaling factor in reply direction
-
-
name: tcp-flags-original
type: binary
struct: nf-ct-tcp-flags-mask
-
-
name: tcp-flags-reply
type: binary
struct: nf-ct-tcp-flags-mask
-
name: protoinfo-dccp-attrs
attributes:
-
-
name: dccp-state
type: u8
doc: dccp connection state
-
-
name: dccp-role
type: u8
-
-
name: dccp-handshake-seq
type: u64
byte-order: big-endian
-
-
name: dccp-pad
type: pad
-
name: protoinfo-sctp-attrs
attributes:
-
-
name: sctp-state
type: u8
doc: sctp connection state
enum: nf-ct-sctp-state
-
-
name: vtag-original
type: u32
byte-order: big-endian
-
-
name: vtag-reply
type: u32
byte-order: big-endian
-
name: protoinfo-attrs
attributes:
-
-
name: protoinfo-tcp
type: nest
nested-attributes: protoinfo-tcp-attrs
doc: conntrack tcp state information
-
-
name: protoinfo-dccp
type: nest
nested-attributes: protoinfo-dccp-attrs
doc: conntrack dccp state information
-
-
name: protoinfo-sctp
type: nest
nested-attributes: protoinfo-sctp-attrs

208
Documentation/netlink/specs/devlink.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: devlink
protocol: genetlink-legacy
@ -744,7 +744,7 @@ attribute-sets:
name: flash-update-overwrite-mask
type: bitfield32
enum: flash-overwrite
enum-as-flags: True
enum-as-flags: true
-
name: reload-action
type: u8
@ -753,12 +753,12 @@ attribute-sets:
name: reload-actions-performed
type: bitfield32
enum: reload-action
enum-as-flags: True
enum-as-flags: true
-
name: reload-limits
type: bitfield32
enum: reload-action
enum-as-flags: True
enum-as-flags: true
-
name: dev-stats
type: nest
@ -812,14 +812,14 @@ attribute-sets:
name: rate-parent-node-name
type: string
-
name: region-max-snapshots
type: u32
name: region-max-snapshots
type: u32
-
name: linecard-index
type: u32
-
name: linecard-state
type: u8
name: linecard-state
type: u8
-
name: linecard-type
type: string
@ -917,7 +917,7 @@ attribute-sets:
name: caps
type: bitfield32
enum: port-fn-attr-cap
enum-as-flags: True
enum-as-flags: true
-
name: dl-dpipe-tables
@ -1139,7 +1139,7 @@ attribute-sets:
-
name: param-type
# TODO: fill in the attribute param-value-list
# TODO: fill in the attribute param-value-list
-
name: dl-region-snapshots
@ -1257,7 +1257,7 @@ operations:
name: get
doc: Get devlink instances.
attribute-set: devlink
dont-validate: [ strict, dump ]
dont-validate: [strict, dump]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1266,7 +1266,7 @@ operations:
attributes: &dev-id-attrs
- bus-name
- dev-name
reply: &get-reply
reply: &get-reply
value: 3
attributes:
- bus-name
@ -1280,7 +1280,7 @@ operations:
name: port-get
doc: Get devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1304,8 +1304,8 @@ operations:
name: port-set
doc: Set devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1321,8 +1321,8 @@ operations:
name: port-new
doc: Create devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1343,8 +1343,8 @@ operations:
name: port-del
doc: Delete devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1355,8 +1355,8 @@ operations:
name: port-split
doc: Split devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1371,8 +1371,8 @@ operations:
name: port-unsplit
doc: Unplit devlink port instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1383,7 +1383,7 @@ operations:
name: sb-get
doc: Get shared buffer instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1405,7 +1405,7 @@ operations:
name: sb-pool-get
doc: Get shared buffer pool instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1428,8 +1428,8 @@ operations:
name: sb-pool-set
doc: Set shared buffer pool instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1446,7 +1446,7 @@ operations:
name: sb-port-pool-get
doc: Get shared buffer port-pool combinations and threshold.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1470,8 +1470,8 @@ operations:
name: sb-port-pool-set
doc: Set shared buffer port-pool combinations and threshold.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1488,7 +1488,7 @@ operations:
name: sb-tc-pool-bind-get
doc: Get shared buffer port-TC to pool bindings and threshold.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1513,8 +1513,8 @@ operations:
name: sb-tc-pool-bind-set
doc: Set shared buffer port-TC to pool bindings and threshold.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1533,8 +1533,8 @@ operations:
name: sb-occ-snapshot
doc: Take occupancy snapshot of shared buffer.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1549,8 +1549,8 @@ operations:
name: sb-occ-max-clear
doc: Clear occupancy watermarks of shared buffer.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1564,8 +1564,8 @@ operations:
name: eswitch-get
doc: Get eswitch attributes.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1584,8 +1584,8 @@ operations:
name: eswitch-set
doc: Set eswitch attributes.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1596,7 +1596,7 @@ operations:
name: dpipe-table-get
doc: Get dpipe table attributes.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1616,7 +1616,7 @@ operations:
name: dpipe-entries-get
doc: Get dpipe entries attributes.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1635,7 +1635,7 @@ operations:
name: dpipe-headers-get
doc: Get dpipe headers attributes.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1653,8 +1653,8 @@ operations:
name: dpipe-table-counters-set
doc: Set dpipe counter attributes.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1669,8 +1669,8 @@ operations:
name: resource-set
doc: Set resource attributes.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1685,7 +1685,7 @@ operations:
name: resource-dump
doc: Get resource attributes.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1704,8 +1704,8 @@ operations:
name: reload
doc: Reload devlink.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-dev-lock
post: devlink-nl-post-doit-dev-lock
@ -1728,7 +1728,7 @@ operations:
name: param-get
doc: Get param instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1748,8 +1748,8 @@ operations:
name: param-set
doc: Set param instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1766,7 +1766,7 @@ operations:
name: region-get
doc: Get region instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1789,8 +1789,8 @@ operations:
name: region-new
doc: Create region snapshot.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1810,8 +1810,8 @@ operations:
name: region-del
doc: Delete region snapshot.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1822,8 +1822,8 @@ operations:
name: region-read
doc: Read region data.
attribute-set: devlink
dont-validate: [ dump-strict ]
flags: [ admin-perm ]
dont-validate: [dump-strict]
flags: [admin-perm]
dump:
request:
attributes:
@ -1847,7 +1847,7 @@ operations:
name: port-param-get
doc: Get port param instances.
attribute-set: devlink
dont-validate: [ strict, dump-strict ]
dont-validate: [strict, dump-strict]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1863,8 +1863,8 @@ operations:
name: port-param-set
doc: Set port param instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port
post: devlink-nl-post-doit
@ -1873,9 +1873,11 @@ operations:
-
name: info-get
doc: Get device information, like driver name, hardware and firmware versions etc.
doc: |
Get device information, like driver name, hardware and firmware versions
etc.
attribute-set: devlink
dont-validate: [ strict, dump ]
dont-validate: [strict, dump]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -1900,7 +1902,7 @@ operations:
name: health-reporter-get
doc: Get health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1921,8 +1923,8 @@ operations:
name: health-reporter-set
doc: Set health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1940,8 +1942,8 @@ operations:
name: health-reporter-recover
doc: Recover health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1952,8 +1954,8 @@ operations:
name: health-reporter-diagnose
doc: Diagnose health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1964,8 +1966,8 @@ operations:
name: health-reporter-dump-get
doc: Dump health reporter instances.
attribute-set: devlink
dont-validate: [ dump-strict ]
flags: [ admin-perm ]
dont-validate: [dump-strict]
flags: [admin-perm]
dump:
request:
attributes: *health-reporter-id-attrs
@ -1978,8 +1980,8 @@ operations:
name: health-reporter-dump-clear
doc: Clear dump of health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -1990,8 +1992,8 @@ operations:
name: flash-update
doc: Flash update devlink instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2007,7 +2009,7 @@ operations:
name: trap-get
doc: Get trap instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2029,8 +2031,8 @@ operations:
name: trap-set
doc: Set trap instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2045,7 +2047,7 @@ operations:
name: trap-group-get
doc: Get trap group instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2067,8 +2069,8 @@ operations:
name: trap-group-set
doc: Set trap group instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2084,7 +2086,7 @@ operations:
name: trap-policer-get
doc: Get trap policer instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2106,8 +2108,8 @@ operations:
name: trap-policer-set
doc: Get trap policer instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2123,8 +2125,8 @@ operations:
name: health-reporter-test
doc: Test health reporter instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit-port-optional
post: devlink-nl-post-doit
@ -2136,7 +2138,7 @@ operations:
name: rate-get
doc: Get rate instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2159,8 +2161,8 @@ operations:
name: rate-set
doc: Set rate instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2179,8 +2181,8 @@ operations:
name: rate-new
doc: Create rate instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2199,8 +2201,8 @@ operations:
name: rate-del
doc: Delete rate instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2214,7 +2216,7 @@ operations:
name: linecard-get
doc: Get line card instances.
attribute-set: devlink
dont-validate: [ strict ]
dont-validate: [strict]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2236,8 +2238,8 @@ operations:
name: linecard-set
doc: Set line card instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2252,7 +2254,7 @@ operations:
name: selftests-get
doc: Get device selftest instances.
attribute-set: devlink
dont-validate: [ strict, dump ]
dont-validate: [strict, dump]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit
@ -2269,8 +2271,8 @@ operations:
name: selftests-run
doc: Run device selftest instances.
attribute-set: devlink
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
pre: devlink-nl-pre-doit
post: devlink-nl-post-doit

14
Documentation/netlink/specs/dpll.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: dpll
doc: DPLL subsystem.
@ -445,7 +445,7 @@ operations:
doc: |
Get id of dpll device that matches given attributes
attribute-set: dpll
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-lock-doit
@ -464,7 +464,7 @@ operations:
doc: |
Get list of DPLL devices (dump) or attributes of a single dpll device
attribute-set: dpll
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-pre-doit
@ -491,7 +491,7 @@ operations:
name: device-set
doc: Set attributes for a DPLL device
attribute-set: dpll
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-pre-doit
@ -519,7 +519,7 @@ operations:
doc: |
Get id of a pin that matches given attributes
attribute-set: pin
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-lock-doit
@ -547,7 +547,7 @@ operations:
a given dpll device
- do request with target dpll and target pin - single pin attributes
attribute-set: pin
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-pin-pre-doit
@ -585,7 +585,7 @@ operations:
name: pin-set
doc: Set attributes of a target pin
attribute-set: pin
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: dpll-pin-pre-doit

70
Documentation/netlink/specs/ethtool.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: ethtool
protocol: genetlink-legacy
@ -12,14 +12,14 @@ definitions:
name: udp-tunnel-type
enum-name:
type: enum
entries: [ vxlan, geneve, vxlan-gpe ]
entries: [vxlan, geneve, vxlan-gpe]
enum-cnt-name: __ethtool-udp-tunnel-type-cnt
render-max: true
-
name: stringset
type: enum
entries: []
header: linux/ethtool.h # skip rendering, no actual definition
header: linux/ethtool.h # skip rendering, no actual definition
-
name: header-flags
type: flags
@ -55,49 +55,51 @@ definitions:
doc: The firmware flashing process was stopped due to an error.
-
name: c33-pse-ext-state
doc: "groups of PSE extended states functions. IEEE 802.3-2022 33.2.4.4 Variables"
doc: |
"groups of PSE extended states functions. IEEE 802.3-2022 33.2.4.4
Variables"
type: enum
name-prefix: ethtool-c33-pse-ext-state-
header: linux/ethtool.h
entries:
-
name: none
doc: none
-
name: error-condition
doc: Group of error_condition states
-
name: mr-mps-valid
doc: Group of mr_mps_valid states
-
name: mr-pse-enable
doc: Group of mr_pse_enable states
-
name: option-detect-ted
doc: Group of option_detect_ted states
-
name: option-vport-lim
doc: Group of option_vport_lim states
-
name: ovld-detected
doc: Group of ovld_detected states
-
name: power-not-available
doc: Group of power_not_available states
-
name: short-detected
doc: Group of short_detected states
-
name: none
doc: none
-
name: error-condition
doc: Group of error_condition states
-
name: mr-mps-valid
doc: Group of mr_mps_valid states
-
name: mr-pse-enable
doc: Group of mr_pse_enable states
-
name: option-detect-ted
doc: Group of option_detect_ted states
-
name: option-vport-lim
doc: Group of option_vport_lim states
-
name: ovld-detected
doc: Group of ovld_detected states
-
name: power-not-available
doc: Group of power_not_available states
-
name: short-detected
doc: Group of short_detected states
-
name: phy-upstream-type
enum-name: phy-upstream
header: linux/ethtool.h
type: enum
name-prefix: phy-upstream
entries: [ mac, phy ]
entries: [mac, phy]
-
name: tcp-data-split
type: enum
entries: [ unknown, disabled, enabled ]
entries: [unknown, disabled, enabled]
-
name: hwtstamp-source
doc: Source of the hardware timestamp
@ -1224,7 +1226,7 @@ attribute-sets:
-
name: stat
type: u64
type-value: [ id ]
type-value: [id]
-
name: hist-rx
type: nest

14
Documentation/netlink/specs/fou.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: fou
protocol: genetlink-legacy
@ -18,7 +18,7 @@ definitions:
name: encap_type
name-prefix: fou-encap-
enum-name:
entries: [ unspec, direct, gue ]
entries: [unspec, direct, gue]
attribute-sets:
-
@ -81,8 +81,8 @@ operations:
doc: Add port.
attribute-set: fou
dont-validate: [ strict, dump ]
flags: [ admin-perm ]
dont-validate: [strict, dump]
flags: [admin-perm]
do:
request: &all_attrs
@ -103,8 +103,8 @@ operations:
doc: Delete port.
attribute-set: fou
dont-validate: [ strict, dump ]
flags: [ admin-perm ]
dont-validate: [strict, dump]
flags: [admin-perm]
do:
request: &select_attrs
@ -122,7 +122,7 @@ operations:
name: get
doc: Get tunnel info.
attribute-set: fou
dont-validate: [ strict, dump ]
dont-validate: [strict, dump]
do:
request: *select_attrs

10
Documentation/netlink/specs/handshake.yaml
View File

@ -4,7 +4,7 @@
#
# Copyright (c) 2023, Oracle and/or its affiliates.
#
---
name: handshake
protocol: genetlink
@ -16,17 +16,17 @@ definitions:
type: enum
name: handler-class
value-start: 0
entries: [ none, tlshd, max ]
entries: [none, tlshd, max]
-
type: enum
name: msg-type
value-start: 0
entries: [ unspec, clienthello, serverhello ]
entries: [unspec, clienthello, serverhello]
-
type: enum
name: auth
value-start: 0
entries: [ unspec, unauth, psk, x509 ]
entries: [unspec, unauth, psk, x509]
attribute-sets:
-
@ -95,7 +95,7 @@ operations:
name: accept
doc: Handler retrieves next queued handshake request
attribute-set: accept
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:

4
Documentation/netlink/specs/lockd.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: lockd
protocol: genetlink
uapi-header: linux/lockd_netlink.h
@ -26,7 +26,7 @@ operations:
name: server-set
doc: set the lockd server parameters
attribute-set: server
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:

192
Documentation/netlink/specs/mptcp_pm.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: mptcp_pm
protocol: genetlink-legacy
doc: Multipath TCP.
@ -17,72 +17,72 @@ definitions:
enum-name: mptcp-event-type
name-prefix: mptcp-event-
entries:
-
name: unspec
doc: unused event
-
name: created
doc: >-
A new MPTCP connection has been created. It is the good time to
allocate memory and send ADD_ADDR if needed. Depending on the
traffic-patterns it can take a long time until the
MPTCP_EVENT_ESTABLISHED is sent.
Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport,
dport, server-side.
-
name: established
doc: >-
A MPTCP connection is established (can start new subflows).
Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport,
dport, server-side.
-
name: closed
doc: >-
A MPTCP connection has stopped.
Attribute: token.
-
name: announced
value: 6
doc: >-
A new address has been announced by the peer.
Attributes: token, rem_id, family, daddr4 | daddr6 [, dport].
-
name: removed
doc: >-
An address has been lost by the peer.
Attributes: token, rem_id.
-
name: sub-established
value: 10
doc: >-
A new subflow has been established. 'error' should not be set.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: sub-closed
doc: >-
A subflow has been closed. An error (copy of sk_err) could be set if an
error has been detected for this subflow.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: sub-priority
value: 13
doc: >-
The priority of a subflow has changed. 'error' should not be set.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: listener-created
value: 15
doc: >-
A new PM listener is created.
Attributes: family, sport, saddr4 | saddr6.
-
name: listener-closed
doc: >-
A PM listener is closed.
Attributes: family, sport, saddr4 | saddr6.
-
name: unspec
doc: unused event
-
name: created
doc: >-
A new MPTCP connection has been created. It is the good time to
allocate memory and send ADD_ADDR if needed. Depending on the
traffic-patterns it can take a long time until the
MPTCP_EVENT_ESTABLISHED is sent.
Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport,
dport, server-side.
-
name: established
doc: >-
A MPTCP connection is established (can start new subflows).
Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6, sport,
dport, server-side.
-
name: closed
doc: >-
A MPTCP connection has stopped.
Attribute: token.
-
name: announced
value: 6
doc: >-
A new address has been announced by the peer.
Attributes: token, rem_id, family, daddr4 | daddr6 [, dport].
-
name: removed
doc: >-
An address has been lost by the peer.
Attributes: token, rem_id.
-
name: sub-established
value: 10
doc: >-
A new subflow has been established. 'error' should not be set.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: sub-closed
doc: >-
A subflow has been closed. An error (copy of sk_err) could be set if
an error has been detected for this subflow.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: sub-priority
value: 13
doc: >-
The priority of a subflow has changed. 'error' should not be set.
Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
daddr6, sport, dport, backup, if_idx [, error].
-
name: listener-created
value: 15
doc: >-
A new PM listener is created.
Attributes: family, sport, saddr4 | saddr6.
-
name: listener-closed
doc: >-
A PM listener is closed.
Attributes: family, sport, saddr4 | saddr6.
attribute-sets:
-
@ -277,8 +277,8 @@ operations:
name: add-addr
doc: Add endpoint
attribute-set: endpoint
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: &add-addr-attrs
request:
attributes:
@ -287,39 +287,39 @@ operations:
name: del-addr
doc: Delete endpoint
attribute-set: endpoint
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: *add-addr-attrs
-
name: get-addr
doc: Get endpoint information
attribute-set: attr
dont-validate: [ strict ]
dont-validate: [strict]
do: &get-addr-attrs
request:
attributes:
- addr
- token
- addr
- token
reply:
attributes:
- addr
- addr
dump:
reply:
attributes:
- addr
attributes:
- addr
-
name: flush-addrs
doc: Flush addresses
attribute-set: endpoint
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: *add-addr-attrs
-
name: set-limits
doc: Set protocol limits
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: &mptcp-limits
request:
attributes:
@ -329,10 +329,10 @@ operations:
name: get-limits
doc: Get protocol limits
attribute-set: attr
dont-validate: [ strict ]
dont-validate: [strict]
do: &mptcp-get-limits
request:
attributes:
attributes:
- rcv-add-addrs
- subflows
reply:
@ -343,8 +343,8 @@ operations:
name: set-flags
doc: Change endpoint flags
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: &mptcp-set-flags
request:
attributes:
@ -355,8 +355,8 @@ operations:
name: announce
doc: Announce new address
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: &announce-add
request:
attributes:
@ -366,19 +366,19 @@ operations:
name: remove
doc: Announce removal
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do:
request:
attributes:
- token
- loc-id
attributes:
- token
- loc-id
-
name: subflow-create
doc: Create subflow
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: &sf-create
request:
attributes:
@ -389,6 +389,6 @@ operations:
name: subflow-destroy
doc: Destroy subflow
attribute-set: attr
dont-validate: [ strict ]
flags: [ uns-admin-perm ]
dont-validate: [strict]
flags: [uns-admin-perm]
do: *sf-create

7
Documentation/netlink/specs/net_shaper.yaml
View File

@ -1,4 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: net-shaper
doc: |
@ -243,7 +244,7 @@ operations:
The set operation can't be used to create a @node scope shaper,
use the @group operation instead.
attribute-set: net-shaper
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: net-shaper-nl-pre-doit
@ -274,7 +275,7 @@ operations:
node with infinite bandwidth. The queue's implicit node
feeds an implicit RR node at the root of the hierarchy.
attribute-set: net-shaper
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: net-shaper-nl-pre-doit
@ -305,7 +306,7 @@ operations:
full identifier, comprising @binding and @handle, is provided
as the reply.
attribute-set: net-shaper
flags: [ admin-perm ]
flags: [admin-perm]
do:
pre: net-shaper-nl-pre-doit

43
Documentation/netlink/specs/netdev.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: netdev
doc:
@ -31,7 +31,7 @@ definitions:
-
name: hw-offload
doc:
This feature informs if netdev supports XDP hw offloading.
This feature informs if netdev supports XDP hw offloading.
-
name: rx-sg
doc:
@ -48,16 +48,19 @@ definitions:
entries:
-
name: timestamp
doc:
Device is capable of exposing receive HW timestamp via bpf_xdp_metadata_rx_timestamp().
doc: |
Device is capable of exposing receive HW timestamp via
bpf_xdp_metadata_rx_timestamp().
-
name: hash
doc:
Device is capable of exposing receive packet hash via bpf_xdp_metadata_rx_hash().
doc: |
Device is capable of exposing receive packet hash via
bpf_xdp_metadata_rx_hash().
-
name: vlan-tag
doc:
Device is capable of exposing receive packet VLAN tag via bpf_xdp_metadata_rx_vlan_tag().
doc: |
Device is capable of exposing receive packet VLAN tag via
bpf_xdp_metadata_rx_vlan_tag().
-
type: flags
name: xsk-flags
@ -77,11 +80,11 @@ definitions:
-
name: queue-type
type: enum
entries: [ rx, tx ]
entries: [rx, tx]
-
name: qstats-scope
type: flags
entries: [ queue ]
entries: [queue]
attribute-sets:
-
@ -205,7 +208,7 @@ attribute-sets:
-
name: alloc-fast
type: uint
value: 8 # reserve some attr ids in case we need more metadata later
value: 8 # reserve some attr ids in case we need more metadata later
-
name: alloc-slow
type: uint
@ -367,7 +370,7 @@ attribute-sets:
For drivers supporting XDP, XDP is considered the first layer
of the stack, so packets consumed by XDP are still counted here.
type: uint
value: 8 # reserve some attr ids in case we need more metadata later
value: 8 # reserve some attr ids in case we need more metadata later
-
name: rx-bytes
doc: Successfully received bytes, see `rx-packets`.
@ -425,9 +428,9 @@ attribute-sets:
-
name: rx-hw-gro-packets
doc: |
Number of packets that were coalesced from smaller packets by the device.
Counts only packets coalesced with the HW-GRO netdevice feature,
LRO-coalesced packets are not counted.
Number of packets that were coalesced from smaller packets by the
device. Counts only packets coalesced with the HW-GRO netdevice
feature, LRO-coalesced packets are not counted.
type: uint
-
name: rx-hw-gro-bytes
@ -436,8 +439,8 @@ attribute-sets:
-
name: rx-hw-gro-wire-packets
doc: |
Number of packets that were coalesced to bigger packetss with the HW-GRO
netdevice feature. LRO-coalesced packets are not counted.
Number of packets that were coalesced to bigger packetss with the
HW-GRO netdevice feature. LRO-coalesced packets are not counted.
type: uint
-
name: rx-hw-gro-wire-bytes
@ -721,7 +724,7 @@ operations:
name: bind-rx
doc: Bind dmabuf to netdev
attribute-set: dmabuf
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:
@ -735,7 +738,7 @@ operations:
name: napi-set
doc: Set configurable NAPI instance settings.
attribute-set: napi
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:
@ -757,7 +760,7 @@ operations:
- id
kernel-family:
headers: [ "net/netdev_netlink.h"]
headers: ["net/netdev_netlink.h"]
sock-priv: struct netdev_nl_sock
mcast-groups:

10
Documentation/netlink/specs/nfsd.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: nfsd
protocol: genetlink
uapi-header: linux/nfsd_netlink.h
@ -151,7 +151,7 @@ operations:
name: threads-set
doc: set the number of running threads
attribute-set: server
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:
@ -174,7 +174,7 @@ operations:
name: version-set
doc: set nfs enabled versions
attribute-set: server-proto
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:
@ -191,7 +191,7 @@ operations:
name: listener-set
doc: set nfs running sockets
attribute-set: server-sock
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:
@ -208,7 +208,7 @@ operations:
name: pool-mode-set
doc: set the current server pool-mode
attribute-set: pool-mode
flags: [ admin-perm ]
flags: [admin-perm]
do:
request:
attributes:

16
Documentation/netlink/specs/nftables.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: nftables
protocol: netlink-raw
protonum: 12
@ -1205,7 +1205,9 @@ operations:
- name
-
name: destroytable
doc: Delete an existing table with destroy semantics (ignoring ENOENT errors).
doc: |
Delete an existing table with destroy semantics (ignoring ENOENT
errors).
attribute-set: table-attrs
fixed-header: nfgenmsg
do:
@ -1249,7 +1251,9 @@ operations:
- name
-
name: destroychain
doc: Delete an existing chain with destroy semantics (ignoring ENOENT errors).
doc: |
Delete an existing chain with destroy semantics (ignoring ENOENT
errors).
attribute-set: chain-attrs
fixed-header: nfgenmsg
do:
@ -1307,7 +1311,8 @@ operations:
- name
-
name: destroyrule
doc: Delete an existing rule with destroy semantics (ignoring ENOENT errors).
doc: |
Delete an existing rule with destroy semantics (ignoring ENOENT errors).
attribute-set: rule-attrs
fixed-header: nfgenmsg
do:
@ -1351,7 +1356,8 @@ operations:
- name
-
name: destroyset
doc: Delete an existing set with destroy semantics (ignoring ENOENT errors).
doc: |
Delete an existing set with destroy semantics (ignoring ENOENT errors).
attribute-set: set-attrs
fixed-header: nfgenmsg
do:

109
Documentation/netlink/specs/nl80211.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: nl80211
protocol: genetlink-legacy
@ -285,7 +285,7 @@ attribute-sets:
type: u16
-
name: sta-flags
type: binary # TODO: nest
type: binary # TODO: nest
-
name: sta-listen-interval
type: u16
@ -297,14 +297,14 @@ attribute-sets:
type: u32
-
name: sta-info
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wiphy-bands
type: nest
nested-attributes: wiphy-bands
-
name: mntr-flags
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mesh-id
type: binary
@ -317,7 +317,7 @@ attribute-sets:
display-hint: mac
-
name: mpath-info
type: binary # TODO: nest
type: binary # TODO: nest
-
name: bss-cts-prot
type: u8
@ -339,16 +339,16 @@ attribute-sets:
type: binary
-
name: reg-rules
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mesh-config
type: binary # TODO: nest
type: binary # TODO: nest
-
name: bss-basic-rates
type: binary
-
name: wiphy-txq-params
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wiphy-freq
type: u32
@ -370,16 +370,16 @@ attribute-sets:
type: u8
-
name: scan-frequencies
type: binary # TODO: nest
type: binary # TODO: nest
-
name: scan-ssids
type: binary # TODO: nest
type: binary # TODO: nest
-
name: generation
type: u32
-
name: bss
type: binary # TODO: nest
type: binary # TODO: nest
-
name: reg-initiator
type: u8
@ -416,10 +416,10 @@ attribute-sets:
display-hint: hex
-
name: freq-before
type: binary # TODO: nest
type: binary # TODO: nest
-
name: freq-after
type: binary # TODO: nest
type: binary # TODO: nest
-
name: freq-fixed
type: flag
@ -483,10 +483,10 @@ attribute-sets:
type: binary
-
name: key
type: binary # TODO: nest
type: binary # TODO: nest
-
name: keys
type: binary # TODO: nest
type: binary # TODO: nest
-
name: pid
type: u32
@ -495,7 +495,7 @@ attribute-sets:
type: u8
-
name: survey-info
type: binary # TODO: nest
type: binary # TODO: nest
-
name: pmkid
type: binary
@ -513,7 +513,7 @@ attribute-sets:
type: u8
-
name: tx-rates
type: binary # TODO: nest
type: binary # TODO: nest
-
name: frame-match
type: binary
@ -525,7 +525,7 @@ attribute-sets:
type: u32
-
name: cqm
type: binary # TODO: nest
type: binary # TODO: nest
-
name: local-state-change
type: flag
@ -575,13 +575,13 @@ attribute-sets:
type: u16
-
name: key-default-types
type: binary # TODO: nest
type: binary # TODO: nest
-
name: max-remain-on-channel-duration
type: u32
-
name: mesh-setup
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wiphy-antenna-avail-tx
type: u32
@ -596,7 +596,7 @@ attribute-sets:
type: u8
-
name: wowlan-triggers
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wowlan-triggers-supported
type: nest
@ -615,7 +615,7 @@ attribute-sets:
nested-attributes: supported-iftypes
-
name: rekey-data
type: binary # TODO: nest
type: binary # TODO: nest
-
name: max-num-sched-scan-ssids
type: u8
@ -624,7 +624,7 @@ attribute-sets:
type: u16
-
name: scan-supp-rates
type: binary # TODO: nest
type: binary # TODO: nest
-
name: hidden-ssid
type: u32
@ -636,7 +636,7 @@ attribute-sets:
type: binary
-
name: sta-wme
type: binary # TODO: nest
type: binary # TODO: nest
-
name: support-ap-uapsd
type: flag
@ -645,13 +645,13 @@ attribute-sets:
type: flag
-
name: sched-scan-match
type: binary # TODO: nest
type: binary # TODO: nest
-
name: max-match-sets
type: u8
-
name: pmksa-candidate
type: binary # TODO: nest
type: binary # TODO: nest
-
name: tx-no-cck-rate
type: flag
@ -680,7 +680,7 @@ attribute-sets:
name: feature-flags
type: u32
enum: feature-flags
enum-as-flags: True
enum-as-flags: true
-
name: probe-resp-offload
type: u32
@ -749,7 +749,7 @@ attribute-sets:
type: u32
-
name: mac-addrs
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mac-acl-max
type: u32
@ -798,7 +798,7 @@ attribute-sets:
type: u16
-
name: coalesce-rule
type: binary # TODO: nest
type: binary # TODO: nest
-
name: ch-switch-count
type: u32
@ -807,7 +807,7 @@ attribute-sets:
type: flag
-
name: csa-ies
type: binary # TODO: nest
type: binary # TODO: nest
-
name: cntdwn-offs-beacon
type: binary
@ -929,13 +929,13 @@ attribute-sets:
type: u32
-
name: sched-scan-plans
type: binary # TODO: nest
type: binary # TODO: nest
-
name: pbss
type: flag
-
name: bss-select
type: binary # TODO: nest
type: binary # TODO: nest
-
name: sta-support-p2p-ps
type: u8
@ -944,7 +944,7 @@ attribute-sets:
type: binary
-
name: iftype-ext-capa
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mu-mimo-group-data
type: binary
@ -975,10 +975,10 @@ attribute-sets:
type: u32
-
name: nan-func
type: binary # TODO: nest
type: binary # TODO: nest
-
name: nan-match
type: binary # TODO: nest
type: binary # TODO: nest
-
name: fils-kek
type: binary
@ -1067,16 +1067,16 @@ attribute-sets:
type: binary
-
name: ftm-responder
type: binary # TODO: nest
type: binary # TODO: nest
-
name: ftm-responder-stats
type: binary # TODO: nest
type: binary # TODO: nest
-
name: timeout
type: u32
-
name: peer-measurements
type: binary # TODO: nest
type: binary # TODO: nest
-
name: airtime-weight
type: u16
@ -1094,7 +1094,7 @@ attribute-sets:
type: flag
-
name: he-obss-pd
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wiphy-edmg-channels
type: u8
@ -1106,13 +1106,13 @@ attribute-sets:
type: u16
-
name: he-bss-color
type: binary # TODO: nest
type: binary # TODO: nest
-
name: iftype-akm-suites
type: binary # TODO: nest
type: binary # TODO: nest
-
name: tid-config
type: binary # TODO: nest
type: binary # TODO: nest
-
name: control-port-no-preauth
type: flag
@ -1133,16 +1133,16 @@ attribute-sets:
type: u32
-
name: scan-freq-khz
type: binary # TODO: nest
type: binary # TODO: nest
-
name: he-6ghz-capability
type: binary
-
name: fils-discovery
type: binary # TOOD: nest
type: binary # TOOD: nest
-
name: unsol-bcast-probe-resp
type: binary # TOOD: nest
type: binary # TOOD: nest
-
name: s1g-capability
type: binary
@ -1173,13 +1173,13 @@ attribute-sets:
type: u8
-
name: color-change-elems
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mbssid-config
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mbssid-elems
type: binary # TODO: nest
type: binary # TODO: nest
-
name: radar-background
type: flag
@ -1194,7 +1194,7 @@ attribute-sets:
type: flag
-
name: mlo-links
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mlo-link-id
type: u8
@ -1234,7 +1234,7 @@ attribute-sets:
type: flag
-
name: ema-rnr-elems
type: binary # TODO: nest
type: binary # TODO: nest
-
name: mlo-link-disabled
type: flag
@ -1252,10 +1252,10 @@ attribute-sets:
type: flag
-
name: wiphy-radios
type: binary # TODO: nest
type: binary # TODO: nest
-
name: wiphy-interface-combinations
type: binary # TODO: nest
type: binary # TODO: nest
-
name: vif-radio-mask
type: u32
@ -1799,8 +1799,9 @@ operations:
-
name: get-wiphy
doc: |
Get information about a wiphy or dump a list of all wiphys. Requests to dump get-wiphy
should unconditionally include the split-wiphy-dump flag in the request.
Get information about a wiphy or dump a list of all wiphys. Requests to
dump get-wiphy should unconditionally include the split-wiphy-dump flag
in the request.
attribute-set: nl80211-attrs
do:
request:

6
Documentation/netlink/specs/nlctrl.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: nlctrl
protocol: genetlink-legacy
uapi-header: linux/genetlink.h
@ -76,12 +76,12 @@ attribute-sets:
-
name: policy
type: nest-type-value
type-value: [ policy-id, attr-id ]
type-value: [policy-id, attr-id]
nested-attributes: policy-attrs
-
name: op-policy
type: nest-type-value
type-value: [ op-id ]
type-value: [op-id]
nested-attributes: op-policy-attrs
-
name: op

26
Documentation/netlink/specs/ovpn.yaml
View File

@ -4,7 +4,7 @@
#
# Copyright (c) 2024-2025, OpenVPN Inc.
#
---
name: ovpn
protocol: genetlink
@ -19,7 +19,7 @@ definitions:
-
type: enum
name: cipher-alg
entries: [ none, aes-gcm, chacha20-poly1305 ]
entries: [none, aes-gcm, chacha20-poly1305]
-
type: enum
name: del-peer-reason
@ -32,7 +32,7 @@ definitions:
-
type: enum
name: key-slot
entries: [ primary, secondary ]
entries: [primary, secondary]
attribute-sets:
-
@ -42,8 +42,8 @@ attribute-sets:
name: id
type: u32
doc: >-
The unique ID of the peer in the device context. To be used to identify
peers during operations for a specific device
The unique ID of the peer in the device context. To be used to
identify peers during operations for a specific device
checks:
max: 0xFFFFFF
-
@ -241,7 +241,7 @@ operations:
-
name: peer-new
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Add a remote peer
do:
pre: ovpn-nl-pre-doit
@ -253,7 +253,7 @@ operations:
-
name: peer-set
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: modify a remote peer
do:
pre: ovpn-nl-pre-doit
@ -265,7 +265,7 @@ operations:
-
name: peer-get
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Retrieve data about existing remote peers (or a specific one)
do:
pre: ovpn-nl-pre-doit
@ -287,7 +287,7 @@ operations:
-
name: peer-del
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Delete existing remote peer
do:
pre: ovpn-nl-pre-doit
@ -305,7 +305,7 @@ operations:
-
name: key-new
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Add a cipher key for a specific peer
do:
pre: ovpn-nl-pre-doit
@ -317,7 +317,7 @@ operations:
-
name: key-get
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Retrieve non-sensitive data about peer key and cipher
do:
pre: ovpn-nl-pre-doit
@ -332,7 +332,7 @@ operations:
-
name: key-swap
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Swap primary and secondary session keys for a specific peer
do:
pre: ovpn-nl-pre-doit
@ -351,7 +351,7 @@ operations:
-
name: key-del
attribute-set: ovpn
flags: [ admin-perm ]
flags: [admin-perm]
doc: Delete cipher key for a specific peer
do:
pre: ovpn-nl-pre-doit

2
Documentation/netlink/specs/ovs_datapath.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: ovs_datapath
version: 2
protocol: genetlink-legacy

16
Documentation/netlink/specs/ovs_flow.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: ovs_flow
version: 1
protocol: genetlink-legacy
@ -293,9 +293,10 @@ definitions:
enum-name: ovs-hash-alg
type: enum
doc: |
Data path hash algorithm for computing Datapath hash. The algorithm type only specifies
the fields in a flow will be used as part of the hash. Each datapath is free to use its
own hash algorithm. The hash value will be opaque to the user space daemon.
Data path hash algorithm for computing Datapath hash. The algorithm type
only specifies the fields in a flow will be used as part of the hash. Each
datapath is free to use its own hash algorithm. The hash value will be
opaque to the user space daemon.
entries:
- ovs-hash-alg-l4
@ -615,7 +616,9 @@ attribute-sets:
name: set
type: nest
nested-attributes: key-attrs
doc: Replaces the contents of an existing header. The single nested attribute specifies a header to modify and its value.
doc: |
Replaces the contents of an existing header. The single nested
attribute specifies a header to modify and its value.
-
name: push-vlan
type: binary
@ -630,7 +633,8 @@ attribute-sets:
type: nest
nested-attributes: sample-attrs
doc: |
Probabilistically executes actions, as specified in the nested attributes.
Probabilistically executes actions, as specified in the nested
attributes.
-
name: recirc
type: u32

4
Documentation/netlink/specs/ovs_vport.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: ovs_vport
version: 2
protocol: genetlink-legacy
@ -21,7 +21,7 @@ definitions:
type: enum
enum-name: ovs-vport-type
name-prefix: ovs-vport-type-
entries: [ unspec, netdev, internal, gre, vxlan, geneve ]
entries: [unspec, netdev, internal, gre, vxlan, geneve]
-
name: ovs-vport-stats
type: struct

2
Documentation/netlink/specs/rt-addr.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: rt-addr
protocol: netlink-raw
uapi-header: linux/rtnetlink.h

2
Documentation/netlink/specs/rt-link.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: rt-link
protocol: netlink-raw
uapi-header: linux/rtnetlink.h

2
Documentation/netlink/specs/rt-neigh.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: rt-neigh
protocol: netlink-raw
uapi-header: linux/rtnetlink.h

10
Documentation/netlink/specs/rt-route.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: rt-route
protocol: netlink-raw
uapi-header: linux/rtnetlink.h
@ -117,7 +117,7 @@ attribute-sets:
name: multipath
type: binary
-
name: protoinfo # not used
name: protoinfo # not used
type: binary
-
name: flow
@ -127,10 +127,10 @@ attribute-sets:
type: binary
struct: rta-cacheinfo
-
name: session # not used
name: session # not used
type: binary
-
name: mp-algo # not used
name: mp-algo # not used
type: binary
-
name: table
@ -155,7 +155,7 @@ attribute-sets:
type: u16
-
name: encap
type: binary # tunnel specific nest
type: binary # tunnel specific nest
-
name: expires
type: u32

2
Documentation/netlink/specs/rt-rule.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: rt-rule
protocol: netlink-raw
uapi-header: linux/fib_rules.h

27
Documentation/netlink/specs/tc.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: tc
protocol: netlink-raw
uapi-header: linux/pkt_cls.h
@ -76,7 +76,8 @@ definitions:
name: overlimits
type: u32
doc: |
Number of throttle events when this flow goes out of allocated bandwidth
Number of throttle events when this flow goes out of allocated
bandwidth
-
name: bps
type: u32
@ -751,7 +752,9 @@ definitions:
-
name: count
type: u32
doc: How many drops we've done since the last time we entered dropping state
doc: |
How many drops we've done since the last time we entered dropping
state
-
name: lastcount
type: u32
@ -1161,7 +1164,7 @@ definitions:
-
name: keys
type: binary
struct: tc-u32-key # TODO: array
struct: tc-u32-key # TODO: array
-
name: tc-u32-pcnt
type: struct
@ -1174,7 +1177,7 @@ definitions:
type: u64
-
name: kcnts
type: u64 # TODO: array
type: u64 # TODO: array
-
name: tcf-t
type: struct
@ -1336,7 +1339,7 @@ definitions:
-
name: keys
type: binary
struct: tc-pedit-key # TODO: array
struct: tc-pedit-key # TODO: array
-
name: tc-pedit-key
type: struct
@ -2885,7 +2888,7 @@ attribute-sets:
attributes:
-
name: parms
type: binary # array of struct: tc-gred-qopt
type: binary # array of struct: tc-gred-qopt
-
name: stab
type: binary
@ -3335,10 +3338,10 @@ attribute-sets:
struct: tc-police
-
name: rate
type: binary # TODO
type: binary # TODO
-
name: peakrate
type: binary # TODO
type: binary # TODO
-
name: avrate
type: u32
@ -3698,7 +3701,7 @@ sub-messages:
value: choke
attribute-set: choke-attrs
-
value: clsact # no content
value: clsact # no content
-
value: codel
attribute-set: codel-attrs
@ -3742,12 +3745,12 @@ sub-messages:
value: htb
attribute-set: htb-attrs
-
value: ingress # no content
value: ingress # no content
-
value: matchall
attribute-set: matchall-attrs
-
value: mq # no content
value: mq # no content
-
value: mqprio
fixed-header: tc-mqprio-qopt

8
Documentation/netlink/specs/tcp_metrics.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: tcp_metrics
protocol: genetlink-legacy
@ -133,7 +133,7 @@ operations:
doc: Retrieve metrics.
attribute-set: tcp-metrics
dont-validate: [ strict, dump ]
dont-validate: [strict, dump]
do:
request: &sel_attrs
@ -162,8 +162,8 @@ operations:
doc: Delete metrics.
attribute-set: tcp-metrics
dont-validate: [ strict, dump ]
flags: [ admin-perm ]
dont-validate: [strict, dump]
flags: [admin-perm]
do:
request: *sel_attrs

16
Documentation/netlink/specs/team.yaml
View File

@ -1,5 +1,5 @@
# SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)
---
name: team
protocol: genetlink-legacy
@ -152,7 +152,7 @@ operations:
doc: No operation
value: 0
attribute-set: team
dont-validate: [ strict ]
dont-validate: [strict]
do:
# Actually it only reply the team netlink family
@ -164,8 +164,8 @@ operations:
name: options-set
doc: Set team options
attribute-set: team
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
request: &option_attrs
@ -178,8 +178,8 @@ operations:
name: options-get
doc: Get team options info
attribute-set: team
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
request:
@ -191,8 +191,8 @@ operations:
name: port-list-get
doc: Get team ports info
attribute-set: team
dont-validate: [ strict ]
flags: [ admin-perm ]
dont-validate: [strict]
flags: [admin-perm]
do:
request: