Re: [PATCH v2] readv.2: document RWF_NOWAIT

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 10 November 2017 at 22:54, Christoph Hellwig <hch@xxxxxx> wrote:
> Signed-off-by: Christoph Hellwig <hch@xxxxxx>
> ---

Thanks, Christoph. (And thanks, Matthew, for the help.)

Patch applied.

Cheers,

Michael

> Changes since V1:
>  - better wording provided by Matthew Wilcox
>
>  man2/readv.2 | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
>
> diff --git a/man2/readv.2 b/man2/readv.2
> index 831cf6260..880435edf 100644
> --- a/man2/readv.2
> +++ b/man2/readv.2
> @@ -232,6 +232,25 @@ This flag is meaningful only for
>  .BR pwritev2 (),
>  and its effect applies only to the data range written by the system call.
>  .\" commit e864f39569f4092c2b2bc72c773b6e486c7e3bd9
> +.TP
> +.BR RWF_NOWAIT " (since Linux 4.14)"
> +Do not wait for data which is not immediately available.
> +If this flag is specified the
> +.BR preadv2 ()
> +system call will return instantly if it would have to read data from
> +the backing storage or wait for a lock.
> +If some data was successfully read, it will return the number of bytes read.
> +If no bytes were read, it will return -1 and set
> +.IR errno
> +to
> +.BR EAGAIN .
> +This flag is meaningful only for
> +.BR preadv2 ()
> +at the moment.
> +.\" commit 3239d834847627b6634a4139cf1dc58f6f137a46
> +.\" commit 91f9943e1c7b6638f27312d03fe71fcc67b23571
> +
> +
>  .SH RETURN VALUE
>  On success,
>  .BR readv (),
> --
> 2.14.2
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-man" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html



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



[Index of Archives]     [Linux Ext4 Filesystem]     [Union Filesystem]     [Filesystem Testing]     [Ceph Users]     [Ecryptfs]     [AutoFS]     [Kernel Newbies]     [Share Photos]     [Security]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux Cachefs]     [Reiser Filesystem]     [Linux RAID]     [Samba]     [Device Mapper]     [CEPH Development]
  Powered by Linux