NAME
posix_fallocate - allocate file space
SYNOPSIS
#define _XOPEN_SOURCE 600
#include <stdlib.h>
I int posix_fallocate(int fd , off_t offset , off_t len );
DESCRIPTION
The function
R posix_fallocate ()
ensures that disk space is allocated for the file referred to by the
descriptor
fd
for the bytes in the range starting at
R offset
and continuing for
len
bytes.
After a successful call to
R posix_fallocate (),
subsequent writes to bytes in the specified range are
guaranteed not to fail because of lack of disk space.
If the size of the file is less than
R offset + len ,
then the file is increased to this size;
otherwise the file size is left unchanged.
RETURN VALUE
R posix_fallocate ()
returns zero on success, or an error number on failure.
Note that
R errno
is not set.
ERRORS
EBADF
fd
is not a valid file descriptor, or is not opened for writing.
EFBIG
offset+len
exceeds the maximum file size.
EINVAL
offset
or
len
was less than 0.
ENODEV
fd
does not refer to a regular file.
ENOSPC
There is not enough space left on the device containing the file
referred to by
R fd.
ESPIPE
fd
refers to a pipe of file descriptor.
VERSIONS
R posix_fallocate ()
is available since glibc 2.1.94.
CONFORMING TO
POSIX.1-2001.
SEE ALSO