|
Packit |
7cfc04 |
'\" et
|
|
Packit |
7cfc04 |
.TH EXIT "1P" 2013 "IEEE/The Open Group" "POSIX Programmer's Manual"
|
|
Packit |
7cfc04 |
.SH PROLOG
|
|
Packit |
7cfc04 |
This manual page is part of the POSIX Programmer's Manual.
|
|
Packit |
7cfc04 |
The Linux implementation of this interface may differ (consult
|
|
Packit |
7cfc04 |
the corresponding Linux manual page for details of Linux behavior),
|
|
Packit |
7cfc04 |
or the interface may not be implemented on Linux.
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
.SH NAME
|
|
Packit |
7cfc04 |
exit
|
|
Packit |
7cfc04 |
\(em cause the shell to exit
|
|
Packit |
7cfc04 |
.SH SYNOPSIS
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
exit \fB[\fIn\fB]\fR
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.SH DESCRIPTION
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR exit
|
|
Packit |
7cfc04 |
utility shall cause the shell to exit with the exit status specified
|
|
Packit |
7cfc04 |
by the unsigned decimal integer
|
|
Packit |
7cfc04 |
.IR n .
|
|
Packit |
7cfc04 |
If
|
|
Packit |
7cfc04 |
.IR n
|
|
Packit |
7cfc04 |
is specified, but its value is not between 0 and 255 inclusively, the
|
|
Packit |
7cfc04 |
exit status is undefined.
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
A
|
|
Packit |
7cfc04 |
.IR trap
|
|
Packit |
7cfc04 |
on
|
|
Packit |
7cfc04 |
.BR EXIT
|
|
Packit |
7cfc04 |
shall be executed before the shell terminates, except when the
|
|
Packit |
7cfc04 |
.IR exit
|
|
Packit |
7cfc04 |
utility is invoked in that
|
|
Packit |
7cfc04 |
.IR trap
|
|
Packit |
7cfc04 |
itself, in which case the shell shall exit immediately.
|
|
Packit |
7cfc04 |
.SH OPTIONS
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH OPERANDS
|
|
Packit |
7cfc04 |
See the DESCRIPTION.
|
|
Packit |
7cfc04 |
.SH STDIN
|
|
Packit |
7cfc04 |
Not used.
|
|
Packit |
7cfc04 |
.SH "INPUT FILES"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "ENVIRONMENT VARIABLES"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "ASYNCHRONOUS EVENTS"
|
|
Packit |
7cfc04 |
Default.
|
|
Packit |
7cfc04 |
.SH STDOUT
|
|
Packit |
7cfc04 |
Not used.
|
|
Packit |
7cfc04 |
.SH STDERR
|
|
Packit |
7cfc04 |
The standard error shall be used only for diagnostic messages.
|
|
Packit |
7cfc04 |
.SH "OUTPUT FILES"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "EXTENDED DESCRIPTION"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "EXIT STATUS"
|
|
Packit |
7cfc04 |
The exit status shall be
|
|
Packit |
7cfc04 |
.IR n ,
|
|
Packit |
7cfc04 |
if specified. Otherwise, the value shall be the exit value of the last
|
|
Packit |
7cfc04 |
command executed, or zero if no command was executed. When
|
|
Packit |
7cfc04 |
.IR exit
|
|
Packit |
7cfc04 |
is executed in a
|
|
Packit |
7cfc04 |
.IR trap
|
|
Packit |
7cfc04 |
action, the last command is considered to be the command that executed
|
|
Packit |
7cfc04 |
immediately preceding the
|
|
Packit |
7cfc04 |
.IR trap
|
|
Packit |
7cfc04 |
action.
|
|
Packit |
7cfc04 |
.SH "CONSEQUENCES OF ERRORS"
|
|
Packit |
7cfc04 |
Default.
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.IR "The following sections are informative."
|
|
Packit |
7cfc04 |
.SH "APPLICATION USAGE"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH EXAMPLES
|
|
Packit |
7cfc04 |
Exit with a
|
|
Packit |
7cfc04 |
.IR true
|
|
Packit |
7cfc04 |
value:
|
|
Packit |
7cfc04 |
.sp
|
|
Packit |
7cfc04 |
.RS 4
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
\fB
|
|
Packit |
7cfc04 |
exit 0
|
|
Packit |
7cfc04 |
.fi \fR
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
.RE
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
Exit with a
|
|
Packit |
7cfc04 |
.IR false
|
|
Packit |
7cfc04 |
value:
|
|
Packit |
7cfc04 |
.sp
|
|
Packit |
7cfc04 |
.RS 4
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
\fB
|
|
Packit |
7cfc04 |
exit 1
|
|
Packit |
7cfc04 |
.fi \fR
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
.RE
|
|
Packit |
7cfc04 |
.SH "RATIONALE"
|
|
Packit |
7cfc04 |
As explained in other sections, certain exit status values have been
|
|
Packit |
7cfc04 |
reserved for special uses and should be used by applications only for
|
|
Packit |
7cfc04 |
those purposes:
|
|
Packit |
7cfc04 |
.IP "\0126" 8
|
|
Packit |
7cfc04 |
A file to be executed was found, but it was not an executable utility.
|
|
Packit |
7cfc04 |
.IP "\0127" 8
|
|
Packit |
7cfc04 |
A utility to be executed was not found.
|
|
Packit |
7cfc04 |
.IP >128 8
|
|
Packit |
7cfc04 |
A command was interrupted by a signal.
|
|
Packit |
7cfc04 |
.SH "FUTURE DIRECTIONS"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "SEE ALSO"
|
|
Packit |
7cfc04 |
.IR "Section 2.14" ", " "Special Built-In Utilities"
|
|
Packit |
7cfc04 |
.SH COPYRIGHT
|
|
Packit |
7cfc04 |
Portions of this text are reprinted and reproduced in electronic form
|
|
Packit |
7cfc04 |
from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology
|
|
Packit |
7cfc04 |
-- Portable Operating System Interface (POSIX), The Open Group Base
|
|
Packit |
7cfc04 |
Specifications Issue 7, Copyright (C) 2013 by the Institute of
|
|
Packit |
7cfc04 |
Electrical and Electronics Engineers, Inc and The Open Group.
|
|
Packit |
7cfc04 |
(This is POSIX.1-2008 with the 2013 Technical Corrigendum 1 applied.) In the
|
|
Packit |
7cfc04 |
event of any discrepancy between this version and the original IEEE and
|
|
Packit |
7cfc04 |
The Open Group Standard, the original IEEE and The Open Group Standard
|
|
Packit |
7cfc04 |
is the referee document. The original Standard can be obtained online at
|
|
Packit |
7cfc04 |
http://www.unix.org/online.html .
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
Any typographical or formatting errors that appear
|
|
Packit |
7cfc04 |
in this page are most likely
|
|
Packit |
7cfc04 |
to have been introduced during the conversion of the source files to
|
|
Packit |
7cfc04 |
man page format. To report such errors, see
|
|
Packit |
7cfc04 |
https://www.kernel.org/doc/man-pages/reporting_bugs.html .
|