readv.2: Document RWF_NOWAIT added in Linux 4.14

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Christoph Hellwig 2017-11-10 22:54:10 +01:00 committed by Michael Kerrisk
parent 534113fffd
commit fe20da96cf
1 changed files with 19 additions and 0 deletions

View File

@ -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 (),