This patchset adds support for netlink-raw families such as rtnetlink.
Patch 1 contains the schema definition
Patches 2 & 3 update the schema documentation
Patches 4 - 7 extends ynl
Patches 8 - 10 add several netlink-raw specs
The netlink-raw schema is very similar to genetlink-legacy and I thought
about making the changes there and symlinking to it. On balance I
thought that might be problematic for accurate schema validation.
rtnetlink doesn't seem to fit into unified or directional message
enumeration models. It seems like an 'explicit' model would be useful,
to force the schema author to specify the message ids directly.
There is not yet support for notifications because ynl currently doesn't
support defining 'event' properties on a 'do' operation. I plan to look
at this in a future patch.
The link and route messages contain different nested attributes
dependent on the type of link or route. Decoding these will need some
kind of attr-space selection that uses the value of another attribute as
the selector key. These nested attributes have been left with type
'binary' for now.
v1 -> v2:
- Put mcast-group changes in separate patch
- Put decode_fixed_header refactoring in separate patch
- Avoid refactoring decode_enum
- Rename NetlinkProtocolFamily -> NetlinkProtocol and
GenlProtocolFamily -> GenlProtocol and store in self.nlproto
- Add spec for rt link.
Donald Hunter (10):
doc/netlink: Add a schema for netlink-raw families
doc/netlink: Document the genetlink-legacy schema extensions
doc/netlink: Document the netlink-raw schema extensions
tools/ynl: Add mcast-group schema parsing to ynl
tools/net/ynl: Refactor decode_fixed_header into NlMsg
tools/net/ynl: Add support for netlink-raw families
tools/net/ynl: Implement nlattr array-nest decoding in ynl
doc/netlink: Add spec for rt addr messages
doc/netlink: Add spec for rt link messages
doc/netlink: Add spec for rt route messages
Documentation/netlink/netlink-raw.yaml | 414 +++++
Documentation/netlink/specs/rt_addr.yaml | 179 +++
Documentation/netlink/specs/rt_link.yaml | 1374 +++++++++++++++++
Documentation/netlink/specs/rt_route.yaml | 288 ++++
Documentation/userspace-api/netlink/intro.rst | 2 +
Documentation/userspace-api/netlink/specs.rst | 64 +
tools/net/ynl/lib/nlspec.py | 26 +
tools/net/ynl/lib/ynl.py | 153 +-
8 files changed, 2461 insertions(+), 39 deletions(-)
create mode 100644 Documentation/netlink/netlink-raw.yaml
create mode 100644 Documentation/netlink/specs/rt_addr.yaml
create mode 100644 Documentation/netlink/specs/rt_link.yaml
create mode 100644 Documentation/netlink/specs/rt_route.yaml
--
2.41.0
