]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
landlock: Add missing kernel-doc "Return:" sections
authorMickaël Salaün <mic@digikod.net>
Wed, 4 Mar 2026 19:31:25 +0000 (20:31 +0100)
committerMickaël Salaün <mic@digikod.net>
Tue, 7 Apr 2026 16:51:03 +0000 (18:51 +0200)
commite89dea254dce44c629d98639c05fe5ca7add7241
treecfbea0ba69ba9ed60adab4cb00e07209796793ff
parenta060ac0b8c3345639f5f4a01e2c435d34adf7e3d
landlock: Add missing kernel-doc "Return:" sections

The kernel-doc -Wreturn check warns about functions with documentation
comments that lack a "Return:" section.  Add "Return:" documentation to
all functions missing it so that kernel-doc -Wreturn passes cleanly.

Convert existing function descriptions into a formal "Return:" section.
Also fix the inaccurate return documentation for
landlock_merge_ruleset() which claimed to return @parent directly, and
document the previously missing ERR_PTR() error return path.  Document
the ABI version and errata return paths for landlock_create_ruleset()
which were previously only implied by the prose.

Cc: Günther Noack <gnoack@google.com>
Reviewed-by: Günther Noack <gnoack3000@gmail.com>
Link: https://lore.kernel.org/r/20260304193134.250495-2-mic@digikod.net
Signed-off-by: Mickaël Salaün <mic@digikod.net>
security/landlock/domain.c
security/landlock/fs.c
security/landlock/ruleset.c
security/landlock/syscalls.c
security/landlock/task.c