2023-09-29 09:40:41

by John Garry

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

Document RWF_ATOMIC for asynchronous I/O.

Signed-off-by: John Garry <[email protected]>
---
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

2023-10-09 17:46:13

by Darrick J. Wong

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

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 <[email protected]>
> ---
> 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
>

2023-10-24 11:52:12

by John Garry

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

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<[email protected]>
>> ---
>> 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