[v1] man2: Document RWF_ATOMIC

[PATCH 4/4] io_submit.2: Document RWF_ATOMIC

Posted by John Garry 2 years, 2 months ago

Document RWF_ATOMIC for asynchronous I/O.

Signed-off-by: John Garry <john.g.garry@oracle.com>
---
 man2/io_submit.2 | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/man2/io_submit.2 b/man2/io_submit.2
index 1030bb6cd965..beba8865ac2a 100644
--- a/man2/io_submit.2
+++ b/man2/io_submit.2
@@ -140,6 +140,11 @@ as well the description of
 .B O_SYNC
 in
 .BR open (2).
+.TP
+.BR RWF_ATOMIC " (since Linux 6.7)"
+Write a block of data such that a write will never be
+torn from power fail or similar. See See the description
+of the flag of the same name in pwritev2(2).
 .RE
 .TP
 .I aio_lio_opcode
-- 
2.31.1

Re: [PATCH 4/4] io_submit.2: Document RWF_ATOMIC

Posted by Darrick J. Wong 2 years, 2 months ago

On Fri, Sep 29, 2023 at 09:37:17AM +0000, John Garry wrote:
> Document RWF_ATOMIC for asynchronous I/O.
> 
> Signed-off-by: John Garry <john.g.garry@oracle.com>
> ---
>  man2/io_submit.2 | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/man2/io_submit.2 b/man2/io_submit.2
> index 1030bb6cd965..beba8865ac2a 100644
> --- a/man2/io_submit.2
> +++ b/man2/io_submit.2
> @@ -140,6 +140,11 @@ as well the description of
>  .B O_SYNC
>  in
>  .BR open (2).
> +.TP
> +.BR RWF_ATOMIC " (since Linux 6.7)"
> +Write a block of data such that a write will never be
> +torn from power fail or similar. See See the description

Nit: Double 'See' here.

--D

> +of the flag of the same name in pwritev2(2).
>  .RE
>  .TP
>  .I aio_lio_opcode
> -- 
> 2.31.1
>

Re: [PATCH 4/4] io_submit.2: Document RWF_ATOMIC

Posted by John Garry 2 years, 1 month ago

On 09/10/2023 18:45, Darrick J. Wong wrote:
> On Fri, Sep 29, 2023 at 09:37:17AM +0000, John Garry wrote:
>> Document RWF_ATOMIC for asynchronous I/O.
>>
>> Signed-off-by: John Garry<john.g.garry@oracle.com>
>> ---
>>   man2/io_submit.2 | 5 +++++
>>   1 file changed, 5 insertions(+)
>>
>> diff --git a/man2/io_submit.2 b/man2/io_submit.2
>> index 1030bb6cd965..beba8865ac2a 100644
>> --- a/man2/io_submit.2
>> +++ b/man2/io_submit.2
>> @@ -140,6 +140,11 @@ as well the description of
>>   .B O_SYNC
>>   in
>>   .BR open (2).
>> +.TP
>> +.BR RWF_ATOMIC " (since Linux 6.7)"
>> +Write a block of data such that a write will never be
>> +torn from power fail or similar. See See the description
> Nit: Double 'See' here.

A bit more than a nit, it's something that needs fixing :)

Thanks,
John

[PATCH 1/4] statx.2: Document STATX_WRITE_ATOMIC
[PATCH 2/4] readv.2: Document RWF_ATOMIC flag
[PATCH 3/4] man2/open.2: Document RWF_ATOMIC
[PATCH 4/4] io_submit.2: Document RWF_ATOMIC