diff options
| author |  Donald Hunter <donald.hunter@gmail.com>
| 2024-01-29 22:34:48 +0000 |
|---|---|---|
| committer |  Jakub Kicinski <kuba@kernel.org>
| 2024-01-31 21:19:18 -0800 |
| commit | 78d23416979500c749049d5d20bac457bcca2fb5 (patch) | |
| tree | 4f2d2874c75e689617182c12c3ff6d8728d04784 /Documentation/userspace-api | |
| parent | tools/net/ynl: Support sub-messages in nested attribute spaces (diff) | |
| download | linux-78d23416979500c749049d5d20bac457bcca2fb5.tar.gz linux-78d23416979500c749049d5d20bac457bcca2fb5.tar.bz2 linux-78d23416979500c749049d5d20bac457bcca2fb5.zip | |
doc/netlink: Describe sub-message selector resolution
Update the netlink-raw docs to add a description of sub-message selector
resolution to explain that selector resolution is constrained by the
spec.
Signed-off-by: Donald Hunter <donald.hunter@gmail.com>
Reviewed-by: Jiri Pirko <jiri@nvidia.com>
Link: https://lore.kernel.org/r/20240129223458.52046-4-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
Diffstat (limited to 'Documentation/userspace-api')
| -rw-r--r-- | Documentation/userspace-api/netlink/netlink-raw.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/userspace-api/netlink/netlink-raw.rst b/Documentation/userspace-api/netlink/netlink-raw.rst index 1e14f5f22b8e..32197f3cb40e 100644 --- a/Documentation/userspace-api/netlink/netlink-raw.rst +++ b/Documentation/userspace-api/netlink/netlink-raw.rst @@ -150,3 +150,11 @@ attributes from an ``attribute-set``. For example the following Note that a selector attribute must appear in a netlink message before any sub-message attributes that depend on it. + +If an attribute such as ``kind`` is defined at more than one nest level, then a +sub-message selector will be resolved using the value 'closest' to the selector. +For example, if the same attribute name is defined in a nested ``attribute-set`` +alongside a sub-message selector and also in a top level ``attribute-set``, then +the selector will be resolved using the value 'closest' to the selector. If the +value is not present in the message at the same level as defined in the spec +then this is an error. |