linux.git/tools/net, branch v6.8-rc2

tools/net/ynl-gen-rst: Remove extra indentation from generated docs

2023-12-18T22:39:44+00:00

The output from ynl-gen-rst.py has extra indentation that causes extra
 elements to be generated in the HTML output.

Reduce the indentation so that sphinx doesn't generate unnecessary
 elements.

Reviewed-by: Breno Leitao 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-14-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl-gen-rst: Remove bold from attribute-set headings

2023-12-18T22:39:44+00:00

The generated .rst for attribute-sets currently uses a sub-sub-heading
for each attribute, with the attribute name in bold. This makes
attributes stand out more than the attribute-set sub-headings they are
part of.

Remove the bold markup from attribute sub-sub-headings.

Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-13-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl-gen-rst: Sort the index of generated netlink specs

2023-12-18T22:39:44+00:00

The index of netlink specs was being generated unsorted. Sort the output
before generating the index entries.

Reviewed-by: Jakub Kicinski 
Reviewed-by: Breno Leitao 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-12-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl-gen-rst: Add sub-messages to generated docs

2023-12-18T22:39:44+00:00

Add a section for sub-messages to the generated .rst files.

Reviewed-by: Breno Leitao 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-11-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl: Add binary and pad support to structs for tc

2023-12-18T22:39:43+00:00

The tc netlink-raw family needs binary and pad types for several
qopt C structs. Add support for them to ynl.

Reviewed-by: Jakub Kicinski 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-6-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl: Add 'sub-message' attribute decoding to ynl

2023-12-18T22:39:43+00:00

Implement the 'sub-message' attribute type in ynl.

Encode support is not yet implemented. Support for sub-message selectors
at a different nest level from the key attribute is not yet supported.

Reviewed-by: Jakub Kicinski 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-5-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools/net/ynl: Use consistent array index expression formatting

2023-12-18T22:39:43+00:00

Use expression formatting that conforms to the python style guide.

Reviewed-by: Jakub Kicinski 
Signed-off-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231215093720.18774-2-donald.hunter@gmail.com
Signed-off-by: Jakub Kicinski

tools: ynl-gen: print prototypes for recursive stuff

2023-12-15T01:51:21+00:00

We avoid printing forward declarations and prototypes for most
types by sorting things topologically. But if structs nest we
do need the forward declarations, there's no other way.

Reviewed-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231213231432.2944749-9-kuba@kernel.org
Signed-off-by: Jakub Kicinski

tools: ynl-gen: store recursive nests by a pointer

2023-12-15T01:51:21+00:00

To avoid infinite nesting store recursive structs by pointer.
If recursive struct is placed in the op directly - the first
instance can be stored by value. That makes the code much
less of a pain for majority of practical uses.

Reviewed-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231213231432.2944749-8-kuba@kernel.org
Signed-off-by: Jakub Kicinski

tools: ynl-gen: re-sort ignoring recursive nests

2023-12-15T01:51:21+00:00

We try to keep the structures and helpers "topologically sorted",
to avoid forward declarations. When recursive nests are at play
we need to sort twice, because structs which end up being marked
as recursive will get a full set of forward declarations, so we
should ignore them for the purpose of sorting.

Reviewed-by: Donald Hunter 
Link: https://lore.kernel.org/r/20231213231432.2944749-7-kuba@kernel.org
Signed-off-by: Jakub Kicinski