[PATCH] man/man7/landlock.7: Document whiteout object peculiarities

[PATCH] man/man7/landlock.7: Document whiteout object peculiarities

[Günther Noack]

Bring documentation for LANDLOCK_ACCESS_FS_MAKE_REG in line with the
Landlock whiteout patch [1].

Link: [1] <https://lore.kernel.org/all/20260813093157.1436894-3-gnoack@google.com/>
Link: [2] <https://github.com/landlock-lsm/linux/issues/66>
---
 man/man7/landlock.7 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/man/man7/landlock.7 b/man/man7/landlock.7
index 880dd50582f3..3642a64ff1f6 100644
--- a/man/man7/landlock.7
+++ b/man/man7/landlock.7
@@ -204,6 +204,9 @@ Create (or rename) a directory.
 .TP
 .B LANDLOCK_ACCESS_FS_MAKE_REG
 Create (or rename or link) a regular file.
+.IP
+This also guards the creation of whiteout objects
+as used in OverlayFS.
 .TP
 .B LANDLOCK_ACCESS_FS_MAKE_SOCK
 Create (or rename or link) a UNIX domain socket.
-- 
2.55.0

Re: [PATCH] man/man7/landlock.7: Document whiteout object peculiarities

[Günther Noack]

Hello Alejandro!

On Fri, Aug 28, 2026 at 06:03:41PM +0200, Günther Noack wrote:
> Bring documentation for LANDLOCK_ACCESS_FS_MAKE_REG in line with the
> Landlock whiteout patch [1].
> 
> Link: [1] <https://lore.kernel.org/all/20260813093157.1436894-3-gnoack@google.com/>
> Link: [2] <https://github.com/landlock-lsm/linux/issues/66>

Small out of band remark: This patch was sent for Linux 7.3, but is
CC'd to stable@ (should get backported).

https://lore.kernel.org/all/20260828160340.11238-2-gnoack3000@gmail.com/

–Günther

Re: [PATCH] man/man7/landlock.7: Document whiteout object peculiarities

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1164 bytes --]

Hi Günther,

> Date: 2026-08-28 18:03:41+0200
> From: Günther Noack <gnoack3000@gmail.com>
>
> Bring documentation for LANDLOCK_ACCESS_FS_MAKE_REG in line with the
> Landlock whiteout patch [1].
> 
> Link: [1] <https://lore.kernel.org/all/20260813093157.1436894-3-gnoack@google.com/>
> Link: [2] <https://github.com/landlock-lsm/linux/issues/66>
> ---
>  man/man7/landlock.7 | 3 +++
>  1 file changed, 3 insertions(+)
> 
> diff --git a/man/man7/landlock.7 b/man/man7/landlock.7
> index 880dd50582f3..3642a64ff1f6 100644
> --- a/man/man7/landlock.7
> +++ b/man/man7/landlock.7
> @@ -204,6 +204,9 @@ Create (or rename) a directory.
>  .TP
>  .B LANDLOCK_ACCESS_FS_MAKE_REG
>  Create (or rename or link) a regular file.
> +.IP
> +This also guards the creation of whiteout objects
> +as used in OverlayFS.

Reviewed-by: Alejandro Colomar <alx@kernel.org>


I guess this should not be applied yet, right?  If it's ready, please
let me know.


Have a lovely night!
Alex

>  .TP
>  .B LANDLOCK_ACCESS_FS_MAKE_SOCK
>  Create (or rename or link) a UNIX domain socket.
> -- 
> 2.55.0
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]