Module Name: src
Committed By: dholland
Date: Mon Jan 2 15:55:30 UTC 2012
Modified Files:
src/lib/libc/stdlib: exit.3
Log Message:
Clarify the behavior of exit(x) for out-of-range x. PR 45769
To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/lib/libc/stdlib/exit.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/stdlib/exit.3
diff -u src/lib/libc/stdlib/exit.3:1.14 src/lib/libc/stdlib/exit.3:1.15
--- src/lib/libc/stdlib/exit.3:1.14 Thu Aug 7 16:43:39 2003
+++ src/lib/libc/stdlib/exit.3 Mon Jan 2 15:55:29 2012
@@ -1,4 +1,4 @@
-.\" $NetBSD: exit.3,v 1.14 2003/08/07 16:43:39 agc Exp $
+.\" $NetBSD: exit.3,v 1.15 2012/01/02 15:55:29 dholland Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" from: @(#)exit.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd August 11, 2002
+.Dd January 2, 2012
.Dt EXIT 3
.Os
.Sh NAME
@@ -78,11 +78,19 @@ Following this,
.Fn exit
calls
.Xr _exit 2 .
-Note that typically
-.Xr _exit 2
-only passes the lower 8 bits of
+.Sh RESTRICTIONS
+Standard C guarantees only that the values zero,
+.Dv EXIT_SUCCESS ,
+and
+.Dv EXIT_FAILURE
+produce meaningful results.
+POSIX extends this to guarantee that the
+least significant 8 bits of
.Fa status
-on to the parent, thus negative values have less meaning.
+are preserved and returned to the parent via
+.Xr wait 2 .
+Values outside the supported range 0-255 are bitwise-truncated; therefore,
+negative values should not be used.
.Sh RETURN VALUES
The
.Fn exit
