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

spt_readz(2) OSS System Calls Reference Manual
RELATED INFORMATION
Functions: creat(2), creat64(2), dup(2), fcntl(2), ioctl(2), lseek(2), lseek64(2), open(2),
open64(2), opendir(3), pipe(2), socket(2).
STANDARDS CONFORMANCE
This function is an extension to the UNIX 98 specification. Interfaces documented on this refer-
ence page conform to IEEE Std 1003.1c-1995, POSIX System Application Program Interface,
with these exceptions:
• The use of the header file spthread.h is an HP exception to the POSIX standard.
• When a signal arrives during a call to the spt_readz() function, instead of returning an
EINTR error to the application, the spt_readz() retries the I/O operation, except in this
case: If the fork() function is called by a signal handler that is running on a thread per-
forming an spt_readz() call, the spt_readz() call in the child process returns an EINTR
error to the application.
The POSIX standards leave some features to the implementing vendor to define. These features
are affected in the HP implementation:
• The value of the file pointer returned for a device that is incapable of seeking is always 0
(zero).
• When reading from a device special file, the return of EOF has no effect on subsequent
calls to the spt_readz() function.
• Specifying a value for the nbytes parameter that is greater than SSIZE_MAX causes the
spt_readz() function to return -1 and set errno to [EINVAL].
• errno can be set to [EIO] if a physical I/O error occurs.
HP extensions to the XPG4 Version 2 specification are:
• The errno values [ECONNRESET], [EFAULT], [EFILEBAD], [EINVAL], [EISDIR],
[EISGUARDIAN], [ENETDOWN], [ENOTCONN], [ETIMEDOUT], and [EWRON-
GID] can be returned.
7−362 Hewlett-Packard Company 527186-023