pwrite(), pwrite64()

Write into a file without changing the file pointer

Synopsis:

#include <unistd.h>

ssize_t pwrite( int filedes,
                const void* buff,
                size_t nbytes,
                off_t offset );

ssize_t pwrite64( int filedes,
                  const void* buff,
                  size_t nbytes,
                  off64_t offset );

Arguments:

filedes
The file descriptor for the file you want to write in.
buff
A pointer to a buffer that contains the data you want to write.
nbytes
The number of bytes to write.
offset
The desired position inside the file.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pwrite() and pwrite64() functions perform the same action as write(), except that they write into a given position without changing the file pointer. The pwrite64() function is a large-file support version of pwrite().

Returns:

The number of bytes actually written, or -1 if an error occurred (errno is set).

Errors:

EAGAIN
The O_NONBLOCK flag is set for the file descriptor, and the process would be delayed in the write operation.
EBADF
The file descriptor, fildes, isn't a valid file descriptor open for writing.
EFBIG
One of the following occurred:
EINTR
The write operation was interrupted by a signal, and either no data was transferred, or the resource manager responsible for that file doesn't report partial transfers.
EINVAL
The offset argument is invalid; the value is negative. The file pointer remains unchanged.
EIO
One of the following occurred:
ENOBUFS
Insufficient resources were available in the system to perform the operation.
ENOSPC
There's no free space remaining on the device containing the file.
ENOSYS
The pwrite() function isn't implemented for the filesystem specified by filedes.
ENXIO
One of the following occurred:
EPIPE
An attempt was made to write to a pipe (or FIFO) that isn't open for reading by any process. A SIGPIPE signal is also sent to the process.
ERANGE
The transfer request size was outside the range supported by the STREAMS file associated with fildes.
ESPIPE
The fildes is associated with a pipe or FIFO. The file pointer remains unchanged.

Classification:

pwrite() is POSIX 1003.1 XSI; pwrite64() is Large-file support

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

close(), creat(), dup(), dup2(), errno, fcntl(), lseek(), open(), pipe(), pread(), read(), readv(), select(), write(), writev()