termios.3: Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME

POSIX leaves the behavior open.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-21 11:45:42 +01:00
parent 4b985dd60a
commit 5ee2d3c5d6
1 changed files with 19 additions and 0 deletions

View File

@ -761,6 +761,25 @@ MIN byte have been read,
or when the interbyte timeout expires.
Because the timer is started only after the initial byte
becomes available, at least one byte will be read.
.PP
POSIX
.\" POSIX.1-2008 XBD 11.1.7
does not specify whether the setting of the
.B O_NONBLOCK
file status flag takes precedence over the MIN and TIME settings.
If
.B O_NONBLOCK
is set, a
.BR read ()
in noncanonical mode may return immediately,
regardless of the setting of MIN or TIME.
Furthermore, if no data is available,
POSIX permits a
.BR read ()
in noncanonical mode to return either 0, or \-1 with
.I errno
set to
.BR EAGAIN .
.SS Raw mode
.LP
.BR cfmakeraw ()