posix_fallocate(3c) [opensolaris man page]

posix_fallocate(3C)					   Standard C Library Functions 				       posix_fallocate(3C)

NAME

       posix_fallocate - file space control

SYNOPSIS

       #include <fcntl.h>

       int posix_fallocate(int fd, off_t offset, off_t len);

DESCRIPTION

       The  posix_fallocate()  function ensures that any required storage for regular file data starting at offset and continuing for len bytes is
       allocated on the file system storage media. If posix_fallocate() returns successfully, subsequent writes to the specified  file	data  will
       not fail due to the lack of free space on the file system storage media.

       If  the offset+len is beyond the current file size, then posix_fallocate() adjusts the file size to offset+len. Otherwise, the file size is
       not changed.

       Space allocated with posix_fallocate() is freed by a successful call to creat(2) or open(2) that truncates the  size  of  the  file.  Space
       allocated  with posix_fallocate() may be freed by a successful call to ftruncate(3C) that reduces the file size to a size smaller than off-
       set+len.

RETURN VALUES

       Upon successful completion, posix_fallocate() returns zero. Otherwise, an error number is returned to indicate the error.

ERRORS

       The posix_fallocate() function will fail if:

       EBADF	 The fd argument is not a valid file descriptor or references a file that was opened without write permission.

       EFBIG	 The value of offset+len is greater than the maximum file size.

       EINTR	 A signal was caught during execution.

       EINVAL	 The len argument is less than or equal to zero, or the offset argument is less than zero, or the underlying file system does  not
		 support this operation.

       EIO	 An I/O error occurred while reading from or writing to a file system.

       ENODEV	 The fd argument does not refer to a regular file.

       ENOSPC	 There is insufficient free space remaining on the file system storage media.

       ESPIPE	 The fd argument is associated with a pipe or FIFO.

USAGE

       The posix_fallocate() function has a transitional interface for 64-bit file offsets. See lf64(5).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+
       |Standard		     |See standards(5). 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       creat(2), open(2), unlink(2), ftruncate(3C), attributes(5), standards(5)

SunOS 5.11							    14 Jul 2008 					       posix_fallocate(3C)

Check Out this Related Man Page

POSIX_FALLOCATE(3)					     Linux Programmer's Manual						POSIX_FALLOCATE(3)

NAME

       posix_fallocate - allocate file space

SYNOPSIS

       #include <fcntl.h>

       int posix_fallocate(int fd, off_t offset, off_t len);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       posix_fallocate():
	   _XOPEN_SOURCE >= 600 || _POSIX_C_SOURCE >= 200112L

DESCRIPTION

       The  function  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 offset and continuing for len bytes.  After a successful call to 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 offset+len, then the file is increased to this size; otherwise the file size is left unchanged.

RETURN VALUE

       posix_fallocate() returns zero on success, or an error number on failure.  Note that 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 was less than 0, or len was less than or equal to 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 fd.

       ESPIPE fd refers to a pipe.

VERSIONS

       posix_fallocate() is available since glibc 2.1.94.

CONFORMING TO

       POSIX.1-2001.

       POSIX.1-2008  says  that  an implementation shall give the EINVAL error if len was 0, or offset was less than 0.  POSIX.1-2001 says that an
       implementation shall give the EINVAL error if len is less than 0, or offset was less than 0, and may give the error if len equals zero.

SEE ALSO

       fallocate(2), lseek(2), posix_fadvise(2)

COLOPHON

       This page is part of release 3.44 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU
								    2010-09-20							POSIX_FALLOCATE(3)

Linux and UNIX Man Pages

posix_fallocate(3c) [opensolaris man page]

Check Out this Related Man Page