[PATCH man-pages] statx.2: Add STATX_MNT_ID

[PATCH man-pages] statx.2: Add STATX_MNT_ID

[NeilBrown]

Linux 5.8 adds STATX_MNT_ID and stx_mnt_id.
Add description to statx.2

Signed-off-by: NeilBrown <neilb@suse.de>
---
 man2/statx.2 | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/man2/statx.2 b/man2/statx.2
index 9e3aeaa36fa3..c41ee45f9bc4 100644
--- a/man2/statx.2
+++ b/man2/statx.2
@@ -77,6 +77,7 @@ struct statx {
        containing the filesystem where the file resides */
     __u32 stx_dev_major;   /* Major ID */
     __u32 stx_dev_minor;   /* Minor ID */
+    __u64 stx_mnt_id;      /* Mount ID */
 };
 .EE
 .in
@@ -258,6 +259,7 @@ STATX_SIZE	Want stx_size
 STATX_BLOCKS	Want stx_blocks
 STATX_BASIC_STATS	[All of the above]
 STATX_BTIME	Want stx_btime
+STATX_MNT_ID	Want stx_mnt_id (since Linux 5.8)
 STATX_ALL	[All currently available fields]
 .TE
 .in
@@ -411,6 +413,13 @@ The device on which this file (inode) resides.
 .IR stx_rdev_major " and "  stx_rdev_minor
 The device that this file (inode) represents if the file is of block or
 character device type.
+.TP
+.I stx_mnt_id
+.\" commit fa2fcf4f1df1559a0a4ee0f46915b496cc2ebf60
+The mount ID of the mount containing the file.  This is the same number reported by
+.BR name_to_handle_at (2)
+and corresponds to the number in the first field in one of the records in
+.IR /proc/self/mountinfo .
 .PP
 For further information on the above fields, see
 .BR inode (7).
@@ -573,9 +582,11 @@ is Linux-specific.
 .BR access (2),
 .BR chmod (2),
 .BR chown (2),
+.BR name_to_handle_at (2),
 .BR readlink (2),
 .BR stat (2),
 .BR utime (2),
+.BR proc (5),
 .BR capabilities (7),
 .BR inode (7),
 .BR symlink (7)
-- 
2.32.0

Re: [PATCH man-pages] statx.2: Add STATX_MNT_ID

[Michael Kerrisk (man-pages)]

Hello Neil,

On 8/13/21 12:46 AM, NeilBrown wrote:
> 
> Linux 5.8 adds STATX_MNT_ID and stx_mnt_id.
> Add description to statx.2
> 
> Signed-off-by: NeilBrown <neilb@suse.de>

Thanks. Patch applied.

Cheers,

Michael

> ---
>  man2/statx.2 | 11 +++++++++++
>  1 file changed, 11 insertions(+)
> 
> diff --git a/man2/statx.2 b/man2/statx.2
> index 9e3aeaa36fa3..c41ee45f9bc4 100644
> --- a/man2/statx.2
> +++ b/man2/statx.2
> @@ -77,6 +77,7 @@ struct statx {
>         containing the filesystem where the file resides */
>      __u32 stx_dev_major;   /* Major ID */
>      __u32 stx_dev_minor;   /* Minor ID */
> +    __u64 stx_mnt_id;      /* Mount ID */
>  };
>  .EE
>  .in
> @@ -258,6 +259,7 @@ STATX_SIZE	Want stx_size
>  STATX_BLOCKS	Want stx_blocks
>  STATX_BASIC_STATS	[All of the above]
>  STATX_BTIME	Want stx_btime
> +STATX_MNT_ID	Want stx_mnt_id (since Linux 5.8)
>  STATX_ALL	[All currently available fields]
>  .TE
>  .in
> @@ -411,6 +413,13 @@ The device on which this file (inode) resides.
>  .IR stx_rdev_major " and "  stx_rdev_minor
>  The device that this file (inode) represents if the file is of block or
>  character device type.
> +.TP
> +.I stx_mnt_id
> +.\" commit fa2fcf4f1df1559a0a4ee0f46915b496cc2ebf60
> +The mount ID of the mount containing the file.  This is the same number reported by
> +.BR name_to_handle_at (2)
> +and corresponds to the number in the first field in one of the records in
> +.IR /proc/self/mountinfo .
>  .PP
>  For further information on the above fields, see
>  .BR inode (7).
> @@ -573,9 +582,11 @@ is Linux-specific.
>  .BR access (2),
>  .BR chmod (2),
>  .BR chown (2),
> +.BR name_to_handle_at (2),
>  .BR readlink (2),
>  .BR stat (2),
>  .BR utime (2),
> +.BR proc (5),
>  .BR capabilities (7),
>  .BR inode (7),
>  .BR symlink (7)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/