]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
landlock: Fix kernel-doc for the nested quiet layer flag
authorMickaël Salaün <mic@digikod.net>
Fri, 3 Jul 2026 14:17:09 +0000 (16:17 +0200)
committerMickaël Salaün <mic@digikod.net>
Fri, 10 Jul 2026 10:59:09 +0000 (12:59 +0200)
kernel-doc emits "Excess struct member 'quiet' description in
'landlock_layer'" because "quiet" is a bitfield inside the named nested
struct "flags", but its inline comment used the bare member name
"@quiet:", which kernel-doc attributes to the enclosing landlock_layer.

Use the canonical dotted notation "@flags.quiet:" so kernel-doc resolves
the nested member, and include it in the generated documentation.

Cc: Justin Suess <utilityemal77@gmail.com>
Cc: Tingmao Wang <m@maowtm.org>
Fixes: a260c0055665 ("landlock: Add a place for flags to layer rules")
Link: https://patch.msgid.link/20260703141711.2016964-1-mic@digikod.net
Signed-off-by: Mickaël Salaün <mic@digikod.net>
security/landlock/ruleset.h

index 61f3c253d5c90dcc4a88fec953b3fded403c97b6..0437adf1742876ca7405880d498e171f0855ce97 100644 (file)
@@ -35,8 +35,8 @@ struct landlock_layer {
         */
        struct {
                /**
-                * @quiet: Suppresses denial logs for the object covered by this
-                * rule in this domain.  For filesystem rules, this inherits
+                * @flags.quiet: Suppresses denial logs for the object covered by
+                * this rule in this domain.  For filesystem rules, this inherits
                 * down the file hierarchy.
                 */
                u8 quiet : 1;