Re: [PATCH v1 02/10] man/man2/statmount.2: Document STATMOUNT_MNT_OPTS

Alejandro Colomar <[email protected]> Wed, 11 Feb 2026 14:43:02 +0100
Newsgroups dev.linux.lists.criu,org.kernel.vger.linux-man
Message-ID <aYyGsFC5xew1S5MW@devuan>
Hi Bhavik,

On 2026-02-10T02:47:35+0530, Bhavik Sachdev wrote:
> Document STATMOUNT_MNT_OPTS flag and the corresponding field introduced
> by it.
> 
> STATMOUNT_MNT_OPTS is used to get all mount options on the mount
> separated by commas. Similiar to how they are displayed in
> /proc/[pid]/mountinfo.
> 
> This text is based on this commit [1].
> 
> Link [1]:
> <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=f9af549d1fd31487bbbc666b5b158cfc940ccc17>
> 
> Signed-off-by: Bhavik Sachdev <[email protected]>
> ---
>  man/man2/statmount.2 | 9 +++++++++
>  1 file changed, 9 insertions(+)
> 
> diff --git a/man/man2/statmount.2 b/man/man2/statmount.2
> index f5c4da122..fee37069a 100644
> --- a/man/man2/statmount.2
> +++ b/man/man2/statmount.2
> @@ -31,6 +31,7 @@ .SH SYNOPSIS
>  .P
>  .B struct statmount {
>  .B "    __u32  size;"
> +.B "    __u32  mnt_opts;"
>  .B "    __u64  mask;"
>  .B "    __u32  sb_dev_major;"
>  .B "    __u32  sb_dev_minor;"
> @@ -108,6 +109,7 @@ .SS The mnt_id_req structure
>  STATMOUNT_MNT_POINT	/* Want/got mnt_point */
>  STATMOUNT_FS_TYPE	/* Want/got fs_type */
>  STATMOUNT_MNT_NS_ID	/* Want/got mnt_ns_id */
> +STATMOUNT_MNT_OPTS	/* Want/got mnt_opts */
>  .TE
>  .in
>  .P
> @@ -159,6 +161,13 @@ .SS The returned information
>  structure,
>  including any of the strings fields that were filled.
>  .TP
> +.I smbuf.mnt_opts
> +The offset to the location in the
> +.I smbuf.str
> +buffer that contains a comma separated list of mount options,
> +similiar to those in /proc/[pid]/mountinfo.

The path should be marked up:

	.IR /proc/ pid /mountinfo .

Though you may want to refer to proc_pid_mountinfo(5).


Cheers,
Alex

> +It is a null-terminated string.
> +.TP
>  .I smbuf.mask
>  The ORed combination of
>  .BI STATMOUNT_ *
> -- 
> 2.53.0
> 

-- 
<https://www.alejandro-colomar.es>
signature.asc (application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmmMh2YACgkQ64mZXMKQ
wqlihQ//axG23wFzS8eY2QBhIdCrxU1gGKqXKBKf3oD6pCBt8EUzTSIPwsxdEQc+
Nqsscf2IJfNSXy0pGenvq//AGwyh/TOvF0whoh3biU+yhFkRGt8uA0nwVwamViGx
vj31nUEbfZ9irE7aiygGVep4JhaTLI/zj3wWOnZf/RnI2Xd9MbAn51TKLtArbQwq
zb3OjCEhodmfCvJWma8EYKOYB11ZDIlvh378RcXy2ltEu3oUQbnQxxVE5mCN13Nb
5U+TPN7ZXyaTel5QhXRkIWw0k6tfBusR9lokSXK0XSc1R/Rdwx1thHOe/SiV9qwf
5bd15b9rwv+163Ww8gWo+47o7fWg5bFWIraYu2eRg7J3/HuIPEl2gfNIgebjEjjb
azsyNGBdLNQz6huAG3/RwCtcKBmoGwnrc3Q6oeNsxUDSI352rHtetslBYclKsdoE
8gT8dU5sQwhfQGzHYFTHHdR53d5Wz8tcV+PEp7u28iGGlmz2KAvlDM+Wyaw4JXHh
y3tzei1Ky+GEtn6lwc+nmrM6L/gez+XDpdYQHj7AMV7R74u9klrFH/b2EvXCr0rx
+W0XrkfWGJTz3PZRGx+sXjCPcx92LNZeSbNNKHeZDZrwYLAV5Nnr1iPg3UPws3WP
4FPW6sWEXfBaGnE1HUnHSweUNhL5a7/kFeoukzgBETqCPC7RHOo=
=xt8/
-----END PGP SIGNATURE-----