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