OSDN Git Service

(split) LDP: Update original to LDP v3.65
[linuxjm/LDP_man-pages.git] / original / man3 / posix_fallocate.3
index 7ce53a3..9026cd5 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (c) 2006, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" 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.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH POSIX_FALLOCATE 3  2009-09-30 "GNU" "Linux Programmer's Manual"
+.TH POSIX_FALLOCATE 3  2013-02-12 "GNU" "Linux Programmer's Manual"
 .SH NAME
 posix_fallocate \- allocate file space
 .SH SYNOPSIS
 .nf
-.B #define _XOPEN_SOURCE 600
 .B #include <fcntl.h>
 .sp
 .BI "int posix_fallocate(int " fd ", off_t " offset ", off_t " len );
 .fi
+.sp
+.ad l
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.BR posix_fallocate ():
+.RS 4
+_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
+.RE
+.ad
 .SH DESCRIPTION
 The function
 .BR posix_fallocate ()
@@ -50,13 +63,13 @@ 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"
+.SH RETURN VALUE
 .BR posix_fallocate ()
 returns zero on success, or an error number on failure.
 Note that
 .I errno
 is not set.
-.SH "ERRORS"
+.SH ERRORS
 .TP
 .B EBADF
 .I fd
@@ -83,11 +96,11 @@ referred to by
 .TP
 .B ESPIPE
 .I fd
-refers to a pipe of file descriptor.
+refers to a pipe.
 .SH VERSIONS
 .BR posix_fallocate ()
 is available since glibc 2.1.94.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 POSIX.1-2001.
 
 POSIX.1-2008 says that an implementation
@@ -112,8 +125,16 @@ was less than 0, and
 give the error if
 .I len
 equals zero.
-.SH "SEE ALSO"
+.SH SEE ALSO
+.BR fallocate (1),
 .BR fallocate (2),
 .BR lseek (2),
-.BR posix_fadvise (2),
-.BR feature_test_macros (7)
+.BR posix_fadvise (2)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.