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>
This commit is contained in:
committed by
Jakub Kicinski
parent
bf8b832374
commit
78d2341697
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user