HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

497

498

499

500

501

502

503

504

505

506

write(2) write(2)

RETURN VALUE

Upon successful completion, write() and pwrite() will return the number of bytes actually written to

the ﬁle associated with ﬁldes. This number will never be greater than nbyte. Otherwise, −1 is returned

and

errno is set to indicate the error.

Upon successful completion, writev() returns the number of bytes actually written. Otherwise, it

returns a value of −1, the ﬁle-pointer remains unchanged, and

errno is set to indicate an error.

ERRORS

The

write(), pwrite() and writev() functions will fail if:

[EAGAIN] The

O_NONBLOCK ﬂag is set for the ﬁle descriptor and the process would be delayed

in the

write() operation.

[EBADF] The ﬁldes argument is not a valid ﬁle descriptor open for writing.

[EFBIG] An attempt was made to write a ﬁle that exceeds the implementation-dependent max-

imum ﬁle size or the process’ ﬁle size limit.

[EINTR] The write operation was terminated due to the receipt of a signal, and no data was

transferred.

[EIO] A physical I/O error has occurred.

[EIO] The process is a member of a background process group attempting to write to its con-

trolling terminal, TOSTOP is set, the process is neither ignoring nor blocking

SIGTTOU and the process group of the process is orphaned. This error may also be

returned under implementation-dependent conditions.

[ENOSPC] There was no free space remaining on the device containing the ﬁle.

[EPIPE] An attempt is made to write to a pipe or FIFO that is not open for reading by any pro-

cess, or that only has one end open. A SIGPIPE signal will also be sent to the pro-

cess.

[ERANGE] The transfer request size was outside the range supported by the

STREAMS ﬁle asso-

ciated with ﬁldes.

The

writev() function will fail if:

[EINVAL] The sum of the iov_len values in the iov array would overﬂow an ssize_t.

The

write(), pwrite() and writev() functions may fail if:

[EINVAL] The STREAM or multiplexer referenced by ﬁldes is linked (directly or indirectly)

downstream from a multiplexer.

[ENXIO] A request was made of a non-existent device, or the request was outside the capabili-

ties of the device.

[ENXIO] A hangup occurred on the

STREAM being written to.

A write to a STREAMS ﬁle may fail if an error message has been received at the

STREAM head. In this

case,

errno is set to the value included in the error message.

The writev() function may fail and set errno to:

[EINVAL] The iovcnt argument was less than or equal to 0, or greater than {IOV_MAX}.

The pwrite() function fails and the ﬁle pointer remains unchanged if:

[EINVAL] The offset argument is invalid, The value is negative. [ESPIPE] ﬁldes is associated

with a pipe or FIFO.