diff mbox series

statx.2: Update STATX_WRITE_ATOMIC filesystem support

Message ID 20241203145359.2691972-1-john.g.garry@oracle.com (mailing list archive)
State New
Headers show
Series statx.2: Update STATX_WRITE_ATOMIC filesystem support | expand

Commit Message

John Garry Dec. 3, 2024, 2:53 p.m. UTC
Linux v6.13 will include atomic write support for xfs and ext4, so update
STATX_WRITE_ATOMIC commentary to mention that.

Signed-off-by: John Garry <john.g.garry@oracle.com>

Comments

Darrick J. Wong Dec. 4, 2024, 4:55 a.m. UTC | #1
On Tue, Dec 03, 2024 at 02:53:59PM +0000, John Garry wrote:
> Linux v6.13 will include atomic write support for xfs and ext4, so update
> STATX_WRITE_ATOMIC commentary to mention that.
> 
> Signed-off-by: John Garry <john.g.garry@oracle.com>
> 
> diff --git a/man/man2/statx.2 b/man/man2/statx.2
> index c5b5a28ec..2d33998c5 100644
> --- a/man/man2/statx.2
> +++ b/man/man2/statx.2
> @@ -482,6 +482,15 @@ The minimum and maximum sizes (in bytes) supported for direct I/O
>  .RB ( O_DIRECT )
>  on the file to be written with torn-write protection.
>  These values are each guaranteed to be a power-of-2.
> +.IP
> +.B STATX_WRITE_ATOMIC
> +.RI ( stx_atomic_write_unit_min,
> +.RI stx_atomic_write_unit_max,
> +and
> +.IR stx_atomic_write_segments_max )
> +is supported on block devices since Linux 6.11.
> +The support on regular files varies by filesystem;
> +it is supported by xfs and ext4 since Linux 6.13.

woot!

Reviewed-by: "Darrick J. Wong" <djwong@kernel.org>

--D

>  .TP
>  .I stx_atomic_write_segments_max
>  The maximum number of elements in an array of vectors
> -- 
> 2.31.1
>
Alejandro Colomar Dec. 4, 2024, 8:45 p.m. UTC | #2
Hi John,

On Tue, Dec 03, 2024 at 02:53:59PM +0000, John Garry wrote:
> Linux v6.13 will

Is this already in Linus's tree?

> include atomic write support for xfs and ext4, so update
> STATX_WRITE_ATOMIC commentary to mention that.
> 
> Signed-off-by: John Garry <john.g.garry@oracle.com>

Thanks for the patch!  Please see some small comment below.

Have a lovely night!
Alex

> 
> diff --git a/man/man2/statx.2 b/man/man2/statx.2
> index c5b5a28ec..2d33998c5 100644
> --- a/man/man2/statx.2
> +++ b/man/man2/statx.2
> @@ -482,6 +482,15 @@ The minimum and maximum sizes (in bytes) supported for direct I/O
>  .RB ( O_DIRECT )
>  on the file to be written with torn-write protection.
>  These values are each guaranteed to be a power-of-2.
> +.IP
> +.B STATX_WRITE_ATOMIC
> +.RI ( stx_atomic_write_unit_min,
> +.RI stx_atomic_write_unit_max,

There should be a space before the ','.

> +and
> +.IR stx_atomic_write_segments_max )
> +is supported on block devices since Linux 6.11.
> +The support on regular files varies by filesystem;
> +it is supported by xfs and ext4 since Linux 6.13.
>  .TP
>  .I stx_atomic_write_segments_max
>  The maximum number of elements in an array of vectors
> -- 
> 2.31.1
>
John Garry Dec. 5, 2024, 9:33 a.m. UTC | #3
On 04/12/2024 20:45, Alejandro Colomar wrote:
> Hi John,
> 
> On Tue, Dec 03, 2024 at 02:53:59PM +0000, John Garry wrote:
>> Linux v6.13 will
> 
> Is this already in Linus's tree?

The code to support xfs and ext4 is in Linus' tree from v6.13-rc1, but 
v6.13 final is not released yet.

So maybe you want to hold off on this patch until v6.13 final is released.

> 
>> include atomic write support for xfs and ext4, so update
>> STATX_WRITE_ATOMIC commentary to mention that.
>>
>> Signed-off-by: John Garry <john.g.garry@oracle.com>
> 
> Thanks for the patch!  Please see some small comment below.
> 
> Have a lovely night!
> Alex
> 
>>
>> diff --git a/man/man2/statx.2 b/man/man2/statx.2
>> index c5b5a28ec..2d33998c5 100644
>> --- a/man/man2/statx.2
>> +++ b/man/man2/statx.2
>> @@ -482,6 +482,15 @@ The minimum and maximum sizes (in bytes) supported for direct I/O
>>   .RB ( O_DIRECT )
>>   on the file to be written with torn-write protection.
>>   These values are each guaranteed to be a power-of-2.
>> +.IP
>> +.B STATX_WRITE_ATOMIC
>> +.RI ( stx_atomic_write_unit_min,
>> +.RI stx_atomic_write_unit_max,
> 
> There should be a space before the ','.
> 
>> +and
>> +.IR stx_atomic_write_segments_max )

How about this:

.B STATX_WRITE_ATOMIC
.RI ( stx_atomic_write_unit_min,
.I stx_atomic_write_unit_max,
and
.IR stx_atomic_write_segments_max )

I think that this looks right.

Thanks,
John
Alejandro Colomar Dec. 5, 2024, 10:02 a.m. UTC | #4
Hi John,

On Thu, Dec 05, 2024 at 09:33:18AM +0000, John Garry wrote:
> On 04/12/2024 20:45, Alejandro Colomar wrote:
> > Hi John,
> > 
> > On Tue, Dec 03, 2024 at 02:53:59PM +0000, John Garry wrote:
> > > Linux v6.13 will
> > 
> > Is this already in Linus's tree?
> 
> The code to support xfs and ext4 is in Linus' tree from v6.13-rc1, but v6.13
> final is not released yet.
> 
> So maybe you want to hold off on this patch until v6.13 final is released.

Nah, we can apply it already.  Just let me know if anything changes
before the release.

> > > diff --git a/man/man2/statx.2 b/man/man2/statx.2
> > > index c5b5a28ec..2d33998c5 100644
> > > --- a/man/man2/statx.2
> > > +++ b/man/man2/statx.2
> > > @@ -482,6 +482,15 @@ The minimum and maximum sizes (in bytes) supported for direct I/O
> > >   .RB ( O_DIRECT )
> > >   on the file to be written with torn-write protection.
> > >   These values are each guaranteed to be a power-of-2.
> > > +.IP
> > > +.B STATX_WRITE_ATOMIC
> > > +.RI ( stx_atomic_write_unit_min,
> > > +.RI stx_atomic_write_unit_max,
> > 
> > There should be a space before the ','.
> > 
> > > +and
> > > +.IR stx_atomic_write_segments_max )
> 
> How about this:
> 
> .B STATX_WRITE_ATOMIC
> .RI ( stx_atomic_write_unit_min,
> .I stx_atomic_write_unit_max,
> and
> .IR stx_atomic_write_segments_max )
> 
> I think that this looks right.

No; the comma shouldn't be in italics.

.B STATX_WRITE_ATOMIC
.RI ( stx_atomic_write_unit_min ,
.IR stx_atomic_write_unit_max ,
and
.IR stx_atomic_write_segments_max )


Cheers,
Alex
diff mbox series

Patch

diff --git a/man/man2/statx.2 b/man/man2/statx.2
index c5b5a28ec..2d33998c5 100644
--- a/man/man2/statx.2
+++ b/man/man2/statx.2
@@ -482,6 +482,15 @@  The minimum and maximum sizes (in bytes) supported for direct I/O
 .RB ( O_DIRECT )
 on the file to be written with torn-write protection.
 These values are each guaranteed to be a power-of-2.
+.IP
+.B STATX_WRITE_ATOMIC
+.RI ( stx_atomic_write_unit_min,
+.RI stx_atomic_write_unit_max,
+and
+.IR stx_atomic_write_segments_max )
+is supported on block devices since Linux 6.11.
+The support on regular files varies by filesystem;
+it is supported by xfs and ext4 since Linux 6.13.
 .TP
 .I stx_atomic_write_segments_max
 The maximum number of elements in an array of vectors