[src/trunk]: src/lib/libc/sys PR/49617: Kirk Russell: Describe the posix_fall...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8d3a39b9086e
branches:  trunk
changeset: 335946:8d3a39b9086e
user:      christos <christos%NetBSD.org@localhost>
date:      Sun Feb 01 15:24:15 2015 +0000

description:
PR/49617: Kirk Russell: Describe the posix_fallocate return values correctly.

diffstat:

 lib/libc/sys/fdiscard.2 |  16 ++++++++++++----
 1 files changed, 12 insertions(+), 4 deletions(-)

diffs (37 lines):

diff -r 7e23290bfb08 -r 8d3a39b9086e lib/libc/sys/fdiscard.2
--- a/lib/libc/sys/fdiscard.2   Sun Feb 01 10:19:00 2015 +0000
+++ b/lib/libc/sys/fdiscard.2   Sun Feb 01 15:24:15 2015 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: fdiscard.2,v 1.2 2014/07/25 08:47:42 wiz Exp $
+.\"    $NetBSD: fdiscard.2,v 1.3 2015/02/01 15:24:15 christos Exp $
 .\"
 .\" Copyright (c) 2014 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 25, 2014
+.Dd February 1, 2015
 .Dt FDISCARD 2
 .Os
 .Sh NAME
@@ -127,8 +127,16 @@
 may not be persistent after a crash or reboot if the space reserved
 has not yet been written to.
 .Sh RETURN VALUES
-On success these calls return 0.
-On error, \-1 is returned, and the global variable
+If successful, the
+.Fn posix_fallocate
+function will return zero.
+Otherwise an error number will be returned, without setting
+.Va errno .
+.Pp
+If successful, the
+.Fn fdiscard
+function will return zero.
+Otherwise the value \-1 is returned and the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS