diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2006-03-01 04:10:55 +0000 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2006-03-01 04:10:55 +0000 |
| commit | 1cd27447fe5b0cdfeff54bed068716a251852b95 (patch) | |
| tree | ca4765b8254e12b2f9890b5fca5df6e9f43a1ab5 | |
| parent | efb2cf158be87d888b6db33c547828bed9a98ac3 (diff) | |
| download | man-pages-1cd27447fe5b0cdfeff54bed068716a251852b95.tar.gz | |
New page.
| -rw-r--r-- | man3/posix_fallocate.3 | 95 |
1 files changed, 95 insertions, 0 deletions
diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3 new file mode 100644 index 0000000000..8076a41a13 --- /dev/null +++ b/man3/posix_fallocate.3 @@ -0,0 +1,95 @@ +.\" (c) 2006, Michael Kerrisk <mtk-manpages@gmx.net> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.TH POSIX_FALLOCATE 3 2006-03-01 "GNU" "Linux Programmer's Manual" +.SH NAME +posix_fallocate \- allocate file space +.SH SYNOPSIS +.nf +.B #define _XOPEN_SOURCE 600 +.B #include <stdlib.h> +.sp +.BI "int posix_fallocate(int " fd ", off_t " offset ", off_t " len ); +.nl +.fi +.SH DESCRIPTION +The function +.BR posix_fallocate () +ensures that disk space is allocated for the file referred to by the +descriptor +.I fd +for the bytes in the range starting at +.IR offset +and continuing for +.I len +bytes. +After a successful call to +.BR 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 +.IR offset + len , +then the file is increased to this size; +otherwise the file size is left unchanged. +.SH "RETURN VALUE" +.BR posix_fallocate () +returns zero on success, or an error number on failure. +Note that +.IR errno +is not set. +.SH "ERRORS" +.TP +.B EBADF +.I fd +is not a valid file descriptor, or is not opened for writing. +.TP +.B EFBIG +.I offset+len +exceeds the maximum file size. +.TP +.B EINVAL +.I offset +or +.I len +was less than 0. +.TP +.B ENODEV +.I fd +does not refer to a regular file. +.TP +.B ENOSPC +There is not enough space left on the device containing the file +referred to by +.IR fd. +.TP +.B ESPIPE +.I fd +refers to a pipe of file descriptor. +.SH AVAILABILITY +.BR posix_fallocate () +is available since glibc 2.1.94. +.SH "CONFORMING TO" +POSIX.1-2001. +.SH "SEE ALSO" +.BR lseek (2), +.BR posix_fadvise (2) |