Open System Services System Calls Reference Manual (G06.25+, H06.03+)

writev(2) OSS System Calls Reference Manual
Upon successful completion, the writev() function marks the st_ctime and st_mtime fields of
the file for update and clears the set-user-ID and set-group-ID attributes if the file is a regular file.
The fcntl() function provides more information about record locks.
If it is interrupted by a signal before it writes any data, the writev() function returns the value -1
with errno set to [EINTR]. If it is interrupted by a signal after it has successfully written some
data, the writev() function returns the number of bytes that it has written.
Use on Guardian Objects
Attempting to write to a Guardian file (that is, a file in /G) that is locked causes the writev( )
function to return -1 and set errno to [EGUARDIANLOCKED].
RETURN VALUES
Upon successful completion, the writev() function returns the number of bytes that were actually
written. Otherwise, the value -1 is returned, and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the writev() function sets errno to the corresponding value:
[EAGAIN] One of these conditions occurred:
• An attempt was made to write to a file descriptor that cannot accept data,
and the O_NONBLOCK flag is set.
• A write to a pipe (FIFO file) of PIPE_BUF bytes or less is requested,
O_NONBLOCK is set, and not enough free space is available.
• The O_NONBLOCK flag is set on this file, and the process would be
delayed in the write operation.
[EBADF] The filedes parameter is not a valid file descriptor open for writing.
[ECONNRESET]
One of these conditions occurred:
• The transport-provider process for this socket is no longer available.
• The TCP/IP subsystem for this socket is no longer available.
• The connection was forcibly closed by the peer socket.
The file descriptor specified by the filedes parameter can only be closed.
[EFAULT] Part of the iov parameter points to a location outside of the allocated address
space of the process.
[EFBIG] An attempt was made to write a file that exceeds the maximum file size.
[EGUARDIANLOCKED]
A writev() operation was attempted to a file in the Guardian file system (that is,
a file in /G) that is locked.
[EINTR] A writev() operation was interrupted by a signal before any data was written.
[EINVAL] One of these conditions occurred:
• The file position pointer associated with the file specified by the filedes
parameter was negative.
• The value of the iov_count parameter was less than or equal to 0 (zero),
or greater than IOV_MAX.
10−20 Hewlett-Packard Company 527186-003