Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (s and S) spt_readx(2)
setting of O_NONBLOCK.
When attempting to read from an empty pipe (or FIFO file):
• If no process has the pipe open for writing, the spt_readx() function returns the value 0
(zero) to indicate EOF.
• If some process has the pipe open for writing:
— If the O_NONBLOCK flag is not set, the spt_readx() function blocks until
either some data is written or the pipe is closed by all processes that had opened
the pipe for writing.
— If the O_NONBLOCK flag is set, the spt_readx() function returns the value -1
and sets errno to [EAGAIN].
When attempting to read from a socket and no data is currently available:
• If the O_NONBLOCK flag is not set, the spt_readx() function blocks until data
becomes available.
• If the O_NONBLOCK flag is set, the spt_readx() function returns the value -1 and sets
errno to [EAGAIN]. The O_NONBLOCK flag has no effect if data is available.
When attempting to read from a character special file that supports nonblocking reads, such as a
terminal, and no data is currently available:
• If the O_NONBLOCK flag is not set, the spt_readx() function blocks until data
becomes available.
• If the O_NONBLOCK flag is set, the spt_readx() function returns the value -1 and sets
errno to [EAGAIN]. The O_NONBLOCK flag has no effect if data is available.
If it is interrupted by a signal before it reads any data, the read() function returns the value -1
with errno set to [EINTR]. If it is interrupted by a signal after it has successfully read some
data, the read() function returns the number of bytes read.
The spt_readx() function returns the number of bytes with the value 0 (zero) for any unwritten
portion of a regular file before the EOF indication.
When reading from a device special file, the return of EOF has no effect on subsequent calls to
the spt_readx() function. When modem disconnect is detected, an EOF indication is returned.
The errno variable is not set to [EIO].
Upon successful completion, the spt_readx() function marks the st_atime field of the file for
update.
Use on Guardian Objects
After a call to the fork(), tdm_fork(),ortdm_spawn() function, the initial position within a
Guardian EDIT file (a file in /G
with file code 101) is the same for both parent and child
processes.
However, the position is not shared. Moving the current position from within one
process does not move it in the other process.
NOTES
For C applications, a macro to map read() to spt_readx() is available when you use the #define
SPT_THREAD_AWARE_NONBLOCK preprocessor directive before including spthread.h or
when you use an equivalent compiler command option to compile the application.
527186-023 Hewlett-Packard Company 7−355