fallocate.2: Note lack of glibc wrapper; caller must use syscall(2)

Glibc doesn't (and quite probably won't) include a wrapper for this
system call.  Therefore, point out that potential callers will need
to use syscall(2), and rewrite the RETURN VALUE text to show things
as they would be if syscall() is used.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/fallocate.2 b/man2/fallocate.2
index 2f898420bbf5724ff378e6a0ec8a079b33181ead..eea5c84f7b23c85ffd521461bb551a0b1ddd9a40 100644 (file)
--- a/man2/fallocate.2
+++ b/man2/fallocate.2
@@ -2,7 +2,7 @@
 .\" Written by Dave Chinner <dgc@sgi.com>
 .\" May be distributed as per GNU General Public License version 2.
 .\"
-.TH FALLOCATE 2 2007-07-20 "Linux" "Linux Programmer's Manual"
+.TH FALLOCATE 2 2008-10-06 "Linux" "Linux Programmer's Manual"
 .SH NAME
 fallocate \- manipulate file space
 .SH SYNOPSIS
@@ -80,12 +80,7 @@ Because allocation is done in block size chunks,
 may allocate a larger range than that which was specified.
 .SH RETURN VALUE
 .BR fallocate ()
-returns zero on success, or an error number on failure.
-Note that
-.\" FIXME . the library wrapper function will do the right
-.\" thing, returning -1 on error and setting errno.
-.I errno
-is not set.
+returns zero on success, and -1 on failure.
 .SH ERRORS
 .TP
 .B EBADF
@@ -136,6 +131,9 @@ is available on Linux since kernel 2.6.23.
 .SH CONFORMING TO
 .BR fallocate ()
 is Linux-specific.
+.SH NOTES
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
 .SH SEE ALSO
 .BR ftruncate (2),
 .BR posix_fadvise (3),