]> git.ipfire.org Git - thirdparty/nftables.git/commitdiff
doc: note meta cgroup returns zero on cgroupv2-only hosts master
authorAvinash H. Duduskar <avinashhd@protonmail.com>
Fri, 17 Apr 2026 19:41:32 +0000 (19:41 +0000)
committerFlorian Westphal <fw@strlen.de>
Sat, 18 Apr 2026 11:29:48 +0000 (13:29 +0200)
Commit 2ff29969 ("doc: Clarify cgroup meta variable") corrected the
terminology and pointed readers to socket cgroupv2. The man page still
gives no indication that meta cgroup silently returns zero on
cgroupv2-only hosts with CONFIG_CGROUP_NET_CLASSID=y (the distribution
default) and no active net_cls hierarchy, the common configuration
on modern systems. Rules load without error and match nothing.

Make the behaviour explicit in the meta expression types table.

Signed-off-by: Avinash H. Duduskar <avinashhd@protonmail.com>
Signed-off-by: Florian Westphal <fw@strlen.de>
doc/primary-expression.txt

index bd80cd7f92fda5777eaed7b31ce2058c0788ef00..f09817fee8799f7943d524d6e99114023b8bf07a 100644 (file)
@@ -117,7 +117,8 @@ devgroup
 outgoing device group|
 devgroup
 |cgroup|
-control group net_cls.classid (for matching on cgroupv2, see *socket cgroupv2*)|
+control group net_cls.classid; reads zero on cgroupv2-only hosts without an
+active net_cls hierarchy (for matching on cgroupv2, see *socket cgroupv2*)|
 integer (32 bit)
 |random|
 pseudo-random number|