HP-UX Reference (11i v2 04/09) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

509

510

511

512

513

514

515

516

517

518

write(2) write(2)

[ENOSPC] Not enough space on the ﬁle system. The process does not possess the

limit

effective privilege to override this restriction.

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

ities of the device.

[ENXIO] A hangup occurred on the

STREAM

being written to.

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

process, or that only has one end open. A

SIGPIPE signal will also be sent to the

process.

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

STREAMS ﬁle

associated with ﬁldes.

Under the following conditions,

writev() fails and sets

errno to:

[EFAULT] iov_base or iov points outside of the allocated address space. The reliable detection

of this error is implementation dependent.

[EINVAL] One of the iov_len values in the iov array is negative.

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

Under the following conditions, 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}.

Under the following conditions, the

pwrite() function fails, the ﬁle pointer remains unchanged and

errno is set to:

[EINVAL] The offset argument is invalid, and the value is negative.

[ESPIPE] The ﬁldes argument is associated with a pipe or FIFO.

Under the following conditions, write() or writev() fails, the ﬁle offset is updated to reﬂect the

amount of data transferred and errno is set to:

[EFAULT] buf points outside the process’s allocated address space. The reliable detection of

this error is implementation dependent.

EXAMPLES

Assuming a process opened a ﬁle for writing, the following call to

write() attempts to write mybufsize

bytes to the ﬁle from the buffer to which mybuf points.

#include <string.h>

int fildes;

size_t mybufsize;

ssize_t nbytes;

char *mybuf = "aeiou and sometimes y";

mybufsize = (size_t)strlen (mybuf);

nbytes = write (fildes, (void *)mybuf, mybufsize);

WARNINGS

Check signal (5) for the appropriateness of signal references on systems that support sigvector(). See

the sigvector (2) manpage.

sigvector() can affect the behavior of the write(), writev() and pwrite() functions described here.

Character special devices, and raw disks in particular, apply constraints on how

write() can be used.

See speciﬁc Section 7 manual entries for details on particular devices.

AUTHOR

write() was developed by HP, AT&T, and the University of California, Berkeley.