Linux Manual Pages development
 help / color / mirror / Atom feed
From: Alejandro Colomar <alx@kernel.org>
To: "Štěpán Němec" <stepnem@smrk.net>
Cc: linux-man@vger.kernel.org, "Mike Rapoport" <rppt@linux.ibm.com>,
	"Mickaël Salaün" <mic@digikod.net>,
	"Günther Noack" <gnoack@google.com>
Subject: Re: [PATCH 1/3] man/: tfix
Date: Fri, 10 Jul 2026 18:44:19 +0200	[thread overview]
Message-ID: <alEfVXgJBmtlCtH0@devuan> (raw)
In-Reply-To: <20260709153422.210312-1-stepnem@smrk.net>

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

[CC += Mike]
[CC += Mickaël, Günther]

Hi Štěpán!

On 2026-07-09T17:34:20+0200, Štěpán Němec wrote:
> Signed-off-by: Štěpán Němec <stepnem@smrk.net>
> ---
>  man/man2/dup.2               | 2 +-
>  man/man2/memfd_secret.2      | 2 +-
>  man/man2/sched_setaffinity.2 | 2 +-
>  man/man2/seccomp_unotify.2   | 2 +-
>  man/man2/select.2            | 2 +-
>  man/man2/send.2              | 2 +-
>  man/man2/sigsuspend.2        | 2 +-
>  man/man5/proc_meminfo.5      | 2 +-
>  man/man7/landlock.7          | 4 ++--
>  man/man7/pipe.7              | 2 +-
>  man/man7/socket.7            | 2 +-
>  11 files changed, 12 insertions(+), 12 deletions(-)
> 

[...]

> diff --git a/man/man2/memfd_secret.2 b/man/man2/memfd_secret.2
> index 0ea4b8e93c37..4033adc75772 100644
> --- a/man/man2/memfd_secret.2
> +++ b/man/man2/memfd_secret.2
> @@ -119,7 +119,7 @@ .SH ERRORS
>  .B EMFILE
>  The per-process limit on the number of open file descriptors has been reached.
>  .TP
> -.B EMFILE
> +.B ENFILE

I think I'd fix this typo in a separate commit, since it's a meaningful
typo (both EMFILE and ENFILE exist, and they have a slightly different
meaning).

In the fix, please include the following tags:

	Fixes: ac5edfeb1dd6 (2021-08-27; "memfd_secret.2: New page describing memfd_secret() system call")
	Cc: Mike Rapoport <rppt@linux.ibm.com>

>  The system-wide limit on the total number of open files has been reached.
>  .TP
>  .B ENOMEM

[...]

> diff --git a/man/man7/landlock.7 b/man/man7/landlock.7
> index 55cd002d5789..293374ed9b46 100644
> --- a/man/man7/landlock.7
> +++ b/man/man7/landlock.7
> @@ -21,7 +21,7 @@ .SH DESCRIPTION
>  and unexpected or malicious behaviors in applications.
>  .P
>  A Landlock security policy is a set of access rights
> -(e.g., open a file in read-only, make a directory, etc.)
> +(e.g., open a file read-only, make a directory, etc.)
>  tied to a file hierarchy.
>  Such policy can be configured and enforced by processes for themselves
>  using three system calls:
> @@ -334,7 +334,7 @@ .SS Bind mounts and OverlayFS
>  contains its own set of files and directories,
>  which is different from a bind mount.
>  A policy restricting an OverlayFS layer will not restrict
> -the resulted merged hierarchy, and vice versa.
> +the resulting merged hierarchy, and vice versa.
>  Landlock users should then only think about file hierarchies they want to
>  allow access to, regardless of the underlying filesystem.
>  .\"

This seems to also exist in the kernel internal documentation.  I've
CCd the maintainers of that documentation.

	$ find Documentation/ | grep landlock | xargs grep OverlayFS
	Documentation/userspace-api/landlock.rst:Bind mounts and OverlayFS
	Documentation/userspace-api/landlock.rst:An OverlayFS mount point consists of upper and lower layers.  These layers are
	Documentation/userspace-api/landlock.rst:on the upper layer.  From a Landlock policy point of view, all OverlayFS layers
	Documentation/userspace-api/landlock.rst:OverlayFS layer will not restrict the resulted merged hierarchy, and vice versa.

[...]


Have a lovely day!
Alex

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

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

  parent reply	other threads:[~2026-07-10 16:44 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-07-09 15:34 [PATCH 1/3] man/: tfix Štěpán Němec
2026-07-09 15:34 ` [PATCH 2/3] man/man7/pipe.7: Note kernel commit of the soft limit triggered cap increase Štěpán Němec
2026-07-10 16:46   ` Alejandro Colomar
2026-07-09 15:34 ` [PATCH 3/3] man/man7/landlock.7: wfix Štěpán Němec
2026-07-10 16:48   ` Alejandro Colomar
2026-07-13 11:48     ` Štěpán Němec
2026-07-10 16:44 ` Alejandro Colomar [this message]
2026-07-13 12:11   ` [PATCH] man/man2/memfd_secret.2: tfix Štěpán Němec

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=alEfVXgJBmtlCtH0@devuan \
    --to=alx@kernel.org \
    --cc=gnoack@google.com \
    --cc=linux-man@vger.kernel.org \
    --cc=mic@digikod.net \
    --cc=rppt@linux.ibm.com \
    --cc=stepnem@smrk.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox