Re: [PATCH v1 05/10] man/man2/statmount.2: Document STATMOUNT_OPT_ARRAY

Alejandro Colomar <[email protected]> Wed, 11 Feb 2026 14:45:08 +0100

Newsgroups	dev.linux.lists.criu,org.kernel.vger.linux-man
Message-ID	<aYyHt246ioAg2X3k@devuan>

On 2026-02-10T02:47:38+0530, Bhavik Sachdev wrote:
> Document STATMOUNT_OPT_ARRAY flag and the corresponding fields
> introduced by it. This text is based on this commit message [1].
> 
> Retrieve only file system options, separated by null bytes. For security
> opts STATMOUNT_OPT_SEC_ARRAY is used.
> 
> Link [1]:
> <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=2f4d4503e9e5ab765a7948f98bc5deef7850f607>
> 
> Signed-off-by: Bhavik Sachdev <[email protected]>
> ---
>  man/man2/statmount.2 | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
> 
> diff --git a/man/man2/statmount.2 b/man/man2/statmount.2
> index dd1f1f17d..e47af22c3 100644
> --- a/man/man2/statmount.2
> +++ b/man/man2/statmount.2
> @@ -52,6 +52,8 @@ .SH SYNOPSIS
>  .B "    __u64  mnt_ns_id;"
>  .B "    __u32  fs_subtype;"
>  .B "    __u32  sb_source;"
> +.B "    __u32  opt_num;"
> +.B "    __u32  opt_array;"
>  .B "    char   str[];"
>  .B };
>  .EE
> @@ -114,6 +116,7 @@ .SS The mnt_id_req structure
>  STATMOUNT_MNT_OPTS	/* Want/got mnt_opts */
>  STATMOUNT_FS_SUBTYPE	/* Want/got fs_subtype */
>  STATMOUNT_SB_SOURCE	/* Want/got sb_source */
> +STATMOUNT_OPT_ARRAY	/* Want/got opt_... */
>  .TE
>  .in
>  .P
> @@ -274,6 +277,16 @@ .SS The returned information
>  .I smbuf.str
>  the source for the mount.
>  It is a null-terminated string.
> +.TP
> +.I smbuf.opt_num
> +The number of filesystem options set on the mount.
> +.TP
> +.I smbuf.opt_array
> +The offset to the location in the
> +.I smbuf.str
> +buffer that contains file system options separated by null bytes.
> +They can be iterated over the help of

Missing word? "iterated over _with_ the help of"


Cheers,
Alex

> +.IR smbuf.opt_num .
>  .SH RETURN VALUE
>  On success, zero is returned.
>  On error, \-1 is returned, and
> -- 
> 2.53.0
> 
> 

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

signature.asc (application/pgp-signature, 833 B)