Open System Services System Calls Reference Manual (G06.25+, H06.03+)
System Functions (w) write(2)
Use on Guardian Objects
Attempting to write to a Guardian file (that is, a file in /G) that is locked causes the write( ) func-
tion to return -1 and set errno to [EGUARDIANLOCKED].
RETURN VALUES
Upon successful completion, the write() 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 write() function sets errno to the corresponding value:
[EAGAIN] One of these conditions exists:
• 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 fewer than nbytes of free space are avail-
able.
• The O_NONBLOCK flag is set on this file, and the process would be
delayed in the write operation.
[EBADF] The filedes parameter does not specify 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] The buffer 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 write() operation was attempted to a file in the Guardian file system (that is, a
file in /G) that is locked.
[EINTR] A write() 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 nbytes parameter is greater than SSIZE_MAX.
[EIO] One of these conditions occurred:
• The process is a member of a background process group attempting to
write to its controlling terminal, the TOSTOP flag is set, the process is
neither ignoring nor blocking the SIGTTOU signal, and the process
group of the process is orphaned.
527186-003 Hewlett-Packard Company 10−15