posix_fallocate.3: Document POSIX.1-2001 and POSIX.1-2008 specifications for EINVAL...

See http://bugzilla.kernel.org/show_bug.cgi?id=12919

Reported-by:  Eelco Dolstra <dolstra@tudelft.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3
index df83e1c982cd879179d701c6b37b0a5986ecda3c..fa8815e01098b45c0e6b1c25de678ed02c6ad626 100644 (file)
--- a/man3/posix_fallocate.3
+++ b/man3/posix_fallocate.3
@@ -89,6 +89,29 @@ refers to a pipe of file descriptor.
 is available since glibc 2.1.94.
 .SH "CONFORMING TO"
 POSIX.1-2001.
+
+POSIX.1-2001 says that an implementation
+.I shall
+give the
+.B EINVAL
+error if
+.I len
+was 0, or
+.I offset
+was less than 0.
+POSIX.1-2001 says that an implementation
+.I shall
+give the
+.B EINVAL
+error if
+.I len
+is less than 0, or
+.I offset
+was less than 0, and
+.I may
+give the error if
+.I len
+equals zero.
 .SH "SEE ALSO"
 .BR fallocate (2),
 .BR lseek (2),