mbox series

[v3,0/3] man2: Document RWF_ATOMIC

Message ID 20240708114227.211195-1-john.g.garry@oracle.com (mailing list archive)
Headers show
Series man2: Document RWF_ATOMIC | expand

Message

John Garry July 8, 2024, 11:42 a.m. UTC
Document RWF_ATOMIC flag for pwritev2().

RWF_ATOMIC atomic is used for enabling torn-write protection.

We use RWF_ATOMIC as this is legacy name for similar feature proposed in
the past.

Kernel support has now been queued in
https://lore.kernel.org/linux-block/20240620125359.2684798-1-john.g.garry@oracle.com/

Differences to v2:
- rebase

Differences to v1:
- Add statx max segments param
- Expand readv.2 description
- Document EINVAL

Himanshu Madhani (2):
  statx.2: Document STATX_WRITE_ATOMIC
  readv.2: Document RWF_ATOMIC flag

John Garry (1):
  io_submit.2: Document RWF_ATOMIC

 man/man2/io_submit.2 | 17 +++++++++++
 man/man2/readv.2     | 73 +++++++++++++++++++++++++++++++++++++++++++-
 man/man2/statx.2     | 29 ++++++++++++++++++
 3 files changed, 118 insertions(+), 1 deletion(-)

Comments

Alejandro Colomar July 9, 2024, 4:43 p.m. UTC | #1
Hi John,

On Mon, Jul 08, 2024 at 11:42:24AM GMT, John Garry wrote:
> Document RWF_ATOMIC flag for pwritev2().
> 
> RWF_ATOMIC atomic is used for enabling torn-write protection.
> 
> We use RWF_ATOMIC as this is legacy name for similar feature proposed in
> the past.
> 
> Kernel support has now been queued in
> https://lore.kernel.org/linux-block/20240620125359.2684798-1-john.g.garry@oracle.com/
> 
> Differences to v2:
> - rebase
> 
> Differences to v1:
> - Add statx max segments param
> - Expand readv.2 description
> - Document EINVAL

I don't remember having seen v1 or v2.  This is the first iteration sent
to linux-man@, right?  (No problem with that; just to confirm.)

Cheers,
Alex

> 
> Himanshu Madhani (2):
>   statx.2: Document STATX_WRITE_ATOMIC
>   readv.2: Document RWF_ATOMIC flag
> 
> John Garry (1):
>   io_submit.2: Document RWF_ATOMIC
> 
>  man/man2/io_submit.2 | 17 +++++++++++
>  man/man2/readv.2     | 73 +++++++++++++++++++++++++++++++++++++++++++-
>  man/man2/statx.2     | 29 ++++++++++++++++++
>  3 files changed, 118 insertions(+), 1 deletion(-)
> 
> -- 
> 2.31.1
>
John Garry July 10, 2024, 10:07 a.m. UTC | #2
On 09/07/2024 17:43, Alejandro Colomar wrote:
> Hi John,
> 
> On Mon, Jul 08, 2024 at 11:42:24AM GMT, John Garry wrote:
>> Document RWF_ATOMIC flag for pwritev2().
>>
>> RWF_ATOMIC atomic is used for enabling torn-write protection.
>>
>> We use RWF_ATOMIC as this is legacy name for similar feature proposed in
>> the past.
>>
>> Kernel support has now been queued in
>> https://lore.kernel.org/linux-block/20240620125359.2684798-1-john.g.garry@oracle.com/
>>
>> Differences to v2:
>> - rebase
>>
>> Differences to v1:
>> - Add statx max segments param
>> - Expand readv.2 description
>> - Document EINVAL
> 
> I don't remember having seen v1 or v2.  This is the first iteration sent
> to linux-man@, right?  (No problem with that; just to confirm.)

Yes, first for linux-man@. An oversight on my part (not to include for 
previous iterations), sorry. Please see v1 and v2 at:

https://lore.kernel.org/linux-api/20230929093717.2972367-1-john.g.garry@oracle.com/
https://lore.kernel.org/linux-api/20240124112731.28579-1-john.g.garry@oracle.com/

Thanks,
John

> 
>>
>> Himanshu Madhani (2):
>>    statx.2: Document STATX_WRITE_ATOMIC
>>    readv.2: Document RWF_ATOMIC flag
>>
>> John Garry (1):
>>    io_submit.2: Document RWF_ATOMIC
>>
>>   man/man2/io_submit.2 | 17 +++++++++++
>>   man/man2/readv.2     | 73 +++++++++++++++++++++++++++++++++++++++++++-
>>   man/man2/statx.2     | 29 ++++++++++++++++++
>>   3 files changed, 118 insertions(+), 1 deletion(-)
>>
>> -- 
>> 2.31.1
>>
>