Skip to content

Netlink protocol specs

Jakub Kicinski linux-doc netdev 4 versions – Applied

Status from this message: This series was applied to netdev/net-next.git (master)

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v4 Latest8 patches 5 repliesApplied 8/8
  2. v38 patches 22 repliesSuperseded
  3. v27 patches 4 repliesSuperseded
Earlier versions · 1
VersionPostedPatchesRepliesStatus
v16 patches10 repliesSuperseded

Changes in v4 from the cover letter

- spec improvements (patch 2)
- Python cleanup (patch 3)
- rename auto-gen files and use the right comment style

Patches in v4 All 8 applied

#Subject and filesSizeRepliesApplied
1/8docs: add more netlink docs (incl. spec docs)Documentation/core-api/index.rst Documentation/core-api/netlink.rst Documentation/userspace-api/netlink/c-code-gen.rst +4 more+734 -00 repliesApplied
2/8netlink: add schemas for YAML specsDocumentation/netlink/genetlink-c.yaml Documentation/netlink/genetlink-legacy.yaml Documentation/netlink/genetlink.yaml+987 -00 repliesApplied
3/8net: add basic C code generators for NetlinkMAINTAINERS tools/net/ynl/ynl-gen-c.py tools/net/ynl/ynl-regen.sh+2404 -00 repliesApplied
4/8netlink: add a proto specification for FOUDocumentation/netlink/specs/fou.yaml+128 -00 repliesApplied
5/8net: fou: regenerate the uAPI from the specinclude/uapi/linux/fou.h+26 -284 repliesApplied
6/8net: fou: rename the source for linkingnet/ipv4/Makefile net/ipv4/fou_core.c+1 -00 repliesApplied
7/8net: fou: use policy and operation tables generated from the specnet/ipv4/Makefile net/ipv4/fou_core.c net/ipv4/fou_nl.c +1 more+81 -410 repliesApplied
8/8tools: ynl: add a completely generic clienttools/net/ynl/samples/cli.py tools/net/ynl/samples/ynl.py+581 -00 repliesApplied

Reviews trailers per patch

All 8 patches have a Reviewed-by or Acked-by.

PatchNicolas DichtelBagas SanjayaStanislav Fomichev
1/8R-b R-b A-b
2/8A-b
3/8A-b
4/8A-b
5/8A-b
6/8A-b
7/8A-b
8/8A-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes. Scroll the table sideways for all 3 reviewers.

Read the v4 thread

Cover letter [PATCH net-next v4 0/8] Netlink protocol specs

I think the Netlink proto specs are far along enough to merge. Filling in all attribute types and quirks will be an ongoing effort but we have enough to cover FOU so it's somewhat complete.

I fully intend to continue polishing the code but at the same time I'd like to start helping others base their work on the specs (e.g. DPLL) and need to start working on some new families myself.

That's the progress / motivation for merging. The RFC [1] has more of a high level blurb, plus I created a lot of documentation, I'm not going to repeat it here. There was also the talk at LPC [2].

[1] https://lore.kernel.org/all/[email protected]/
[2] https://youtu.be/9QkXIQXkaQk?t=2562
v2: https://lore.kernel.org/all/[email protected]/
v3: https://lore.kernel.org/all/[email protected]/1

v4:
- spec improvements (patch 2)
- Python cleanup (patch 3)
- rename auto-gen files and use the right comment style

Jakub Kicinski (8):
docs: add more netlink docs (incl. spec docs)
netlink: add schemas for YAML specs
net: add basic C code generators for Netlink
netlink: add a proto specification for FOU
net: fou: regenerate the uAPI from the spec
net: fou: rename the source for linking
net: fou: use policy and operation tables generated from the spec
tools: ynl: add a completely generic client

 Documentation/core-api/index.rst              |    1 +
 Documentation/core-api/netlink.rst            |  101 +
 Documentation/netlink/genetlink-c.yaml        |  333 +++
 Documentation/netlink/genetlink-legacy.yaml   |  356 +++
 Documentation/netlink/genetlink.yaml          |  298 +++
 Documentation/netlink/specs/fou.yaml          |  128 +
 .../userspace-api/netlink/c-code-gen.rst      |  107 +
 .../netlink/genetlink-legacy.rst              |   96 +
 Documentation/userspace-api/netlink/index.rst |    5 +
 Documentation/userspace-api/netlink/specs.rst |  422 +++
 MAINTAINERS                                   |    3 +
 include/uapi/linux/fou.h                      |   54 +-
 net/ipv4/Makefile                             |    1 +
 net/ipv4/{fou.c => fou_core.c}                |   47 +-
 net/ipv4/fou_nl.c                             |   48 +
 net/ipv4/fou_nl.h                             |   25 +
 tools/net/ynl/samples/cli.py                  |   47 +
 tools/net/ynl/samples/ynl.py                  |  534 ++++
 tools/net/ynl/ynl-gen-c.py                    | 2373 +++++++++++++++++
 tools/net/ynl/ynl-regen.sh                    |   30 +
 20 files changed, 4941 insertions(+), 68 deletions(-)
 create mode 100644 Documentation/core-api/netlink.rst
 create mode 100644 Documentation/netlink/genetlink-c.yaml
 create mode 100644 Documentation/netlink/genetlink-legacy.yaml
 create mode 100644 Documentation/netlink/genetlink.yaml
 create mode 100644 Documentation/netlink/specs/fou.yaml
 create mode 100644 Documentation/userspace-api/netlink/c-code-gen.rst
 create mode 100644 Documentation/userspace-api/netlink/genetlink-legacy.rst
 create mode 100644 Documentation/userspace-api/netlink/specs.rst
 rename net/ipv4/{fou.c => fou_core.c} (94%)
 create mode 100644 net/ipv4/fou_nl.c
 create mode 100644 net/ipv4/fou_nl.h
 create mode 100755 tools/net/ynl/samples/cli.py
 create mode 100644 tools/net/ynl/samples/ynl.py
 create mode 100755 tools/net/ynl/ynl-gen-c.py
 create mode 100755 tools/net/ynl/ynl-regen.sh
Signature · 1 line
2.39.0