linux/Documentation/netlink/specs
Remy D. Farley 109f8b5154 doc/netlink: Fix typos in operation attributes
I'm trying to generate Rust bindings for netlink using the yaml spec.

It looks like there's a typo in conntrack spec: attribute set conntrack-attrs
defines attributes "counters-{orig,reply}" (plural), while get operation
references "counter-{orig,reply}" (singular). The latter should be fixed, as it
denotes multiple counters (packet and byte). The corresonding C define is
CTA_COUNTERS_ORIG.

Also, dump request references "nfgen-family" attribute, which neither exists in
conntrack-attrs attrset nor ctattr_type enum. There's member of nfgenmsg struct
with the same name, which is where family value is actually taken from.

> static int ctnetlink_dump_exp_ct(struct net *net, struct sock *ctnl,
>                struct sk_buff *skb,
>                const struct nlmsghdr *nlh,
>                const struct nlattr * const cda[],
>                struct netlink_ext_ack *extack)
> {
>   int err;
>   struct nfgenmsg *nfmsg = nlmsg_data(nlh);
>   u_int8_t u3 = nfmsg->nfgen_family;
                         ^^^^^^^^^^^^

Signed-off-by: Remy D. Farley <one-d-wide@protonmail.com>
Fixes: 23fc9311a5 ("netlink: specs: add conntrack dump and stats dump support")
Link: https://patch.msgid.link/20250913140515.1132886-1-one-d-wide@protonmail.com
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
2025-09-16 16:30:06 -07:00
..
conntrack.yaml doc/netlink: Fix typos in operation attributes 2025-09-16 16:30:06 -07:00
devlink.yaml devlink: Fix excessive stack usage in rate TC bandwidth parsing 2025-07-23 17:07:35 -07:00
dpll.yaml dpll: add reference-sync netlink attribute 2025-06-27 16:38:02 -07:00
ethtool.yaml netlink: specs: ethtool: fix module EEPROM input/output arguments 2025-07-31 10:57:02 -07:00
fou.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-06-26 10:40:50 -07:00
handshake.yaml net/handshake: Add new parameter 'HANDSHAKE_A_ACCEPT_KEYRING' 2025-07-08 15:31:44 +02:00
lockd.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00
mptcp_pm.yaml mptcp: pm: nl: announce deny-join-id0 flag 2025-09-15 18:12:05 -07:00
net_shaper.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00
netdev.yaml net: define an enum for the napi threaded state 2025-07-24 18:34:55 -07:00
nfsd.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-06-26 10:40:50 -07:00
nftables.yaml netlink: specs: wrap long doc lines (>80 chars) 2025-06-11 14:01:19 -07:00
nl80211.yaml netlink: specs: wrap long doc lines (>80 chars) 2025-06-11 14:01:19 -07:00
nlctrl.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00
ovpn.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-07-17 11:00:33 -07:00
ovs_datapath.yaml netlink: specs: add doc start markers to yaml 2025-06-11 14:01:19 -07:00
ovs_flow.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-06-26 10:40:50 -07:00
ovs_vport.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00
rt-addr.yaml netlink: specs: add doc start markers to yaml 2025-06-11 14:01:19 -07:00
rt-link.yaml Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net 2025-06-26 10:40:50 -07:00
rt-neigh.yaml neighbor: Add NTF_EXT_VALIDATED flag for externally validated entries 2025-06-30 18:14:23 -07:00
rt-route.yaml netlink: specs: fix up spaces before comments 2025-06-11 14:01:19 -07:00
rt-rule.yaml netlink: specs: add doc start markers to yaml 2025-06-11 14:01:19 -07:00
tc.yaml Documentation: netlink: specs: tc: Add DualPI2 specification 2025-07-23 17:52:09 -07:00
tcp_metrics.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00
team.yaml netlink: specs: clean up spaces in brackets 2025-06-11 14:01:19 -07:00