2004-11-03 13:51:07 +00:00
|
|
|
.\" Hey Emacs! This file is -*- nroff -*- source.
|
|
|
|
.\"
|
|
|
|
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
|
|
|
|
.\" 1993 Michael Haardt, Ian Jackson.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to make and distribute verbatim copies of this
|
|
|
|
.\" manual provided the copyright notice and this permission notice are
|
|
|
|
.\" preserved on all copies.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
|
.\" manual under the conditions for verbatim copying, provided that the
|
|
|
|
.\" entire resulting derived work is distributed under the terms of a
|
|
|
|
.\" permission notice identical to this one.
|
|
|
|
.\"
|
|
|
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
|
|
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
|
|
|
.\" responsibility for errors or omissions, or for damages resulting from
|
|
|
|
.\" the use of the information contained herein. The author(s) may not
|
|
|
|
.\" have taken the same level of care in the production of this manual,
|
|
|
|
.\" which is licensed free of charge, as they might when working
|
|
|
|
.\" professionally.
|
|
|
|
.\"
|
|
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
|
|
|
.\"
|
|
|
|
.\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu>
|
|
|
|
.\" Modified 2001-11-17, aeb
|
|
|
|
.\"
|
|
|
|
.TH _EXIT 2 2001-11-17 Linux "Linux Programmer's Manual"
|
|
|
|
.SH NAME
|
|
|
|
_exit, _Exit \- terminate the current process
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B #include <unistd.h>
|
|
|
|
.sp
|
|
|
|
.BI "void _exit(int " status );
|
|
|
|
.sp
|
|
|
|
.B #include <stdlib.h>
|
|
|
|
.sp
|
|
|
|
.BI "void _Exit(int " status );
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The function
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR _exit ()
|
2004-11-03 13:51:07 +00:00
|
|
|
terminates the calling process "immediately". Any open file descriptors
|
|
|
|
belonging to the process are closed; any children of the process are
|
2005-06-14 11:20:57 +00:00
|
|
|
inherited by process 1,
|
|
|
|
.IR init ,
|
|
|
|
and the process's parent is sent a
|
2004-11-03 13:51:07 +00:00
|
|
|
.B SIGCHLD
|
|
|
|
signal.
|
|
|
|
.LP
|
|
|
|
The value
|
|
|
|
.I status
|
|
|
|
is returned to the parent process as the process's exit status, and
|
|
|
|
can be collected using one of the
|
2005-10-19 07:29:28 +00:00
|
|
|
.BR wait ()
|
2004-11-03 13:51:07 +00:00
|
|
|
family of calls.
|
|
|
|
.LP
|
|
|
|
The function
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR _Exit ()
|
2004-11-03 13:51:07 +00:00
|
|
|
is equivalent to
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR _exit ().
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "RETURN VALUE"
|
|
|
|
These functions do not return.
|
|
|
|
.SH "CONFORMING TO"
|
2006-08-03 13:57:17 +00:00
|
|
|
SVr4, POSIX.1-2001, 4.3BSD.
|
2005-10-19 07:07:02 +00:00
|
|
|
The function \fB_Exit\fP() was introduced by C99.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NOTES
|
|
|
|
For a discussion on the effects of an exit, the transmission of
|
|
|
|
exit status, zombie processes, signals sent, etc., see
|
|
|
|
.BR exit (3).
|
|
|
|
.LP
|
|
|
|
The function
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR _exit ()
|
|
|
|
is like \fBexit\fP(), but does not call any
|
2005-06-14 11:20:57 +00:00
|
|
|
functions registered with
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR atexit ()
|
2005-06-14 11:20:57 +00:00
|
|
|
or
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR on_exit ().
|
2005-06-14 11:20:57 +00:00
|
|
|
Whether it flushes
|
2004-11-03 13:51:07 +00:00
|
|
|
standard I/O buffers and removes temporary files created with
|
|
|
|
.BR tmpfile (3)
|
2005-06-14 11:20:57 +00:00
|
|
|
is implementation dependent.
|
2004-11-03 13:51:07 +00:00
|
|
|
On the other hand,
|
2005-10-19 07:07:02 +00:00
|
|
|
.BR _exit ()
|
2004-11-03 13:51:07 +00:00
|
|
|
does close open file descriptors, and this may cause an unknown delay,
|
|
|
|
waiting for pending output to finish. If the delay is undesired,
|
2005-10-19 07:07:02 +00:00
|
|
|
it may be useful to call functions like \fItcflush\fP() before
|
|
|
|
calling \fB_exit\fP().
|
2004-11-03 13:51:07 +00:00
|
|
|
Whether any pending I/O is cancelled, and which pending I/O may be
|
2005-10-19 07:07:02 +00:00
|
|
|
cancelled upon \fB_exit\fP(), is implementation-dependent.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR execve (2),
|
2006-05-29 04:56:29 +00:00
|
|
|
.BR exit_group (2),
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR fork (2),
|
|
|
|
.BR kill (2),
|
|
|
|
.BR wait (2),
|
|
|
|
.BR wait4 (2),
|
|
|
|
.BR waitpid (2),
|
2005-06-14 11:20:57 +00:00
|
|
|
.BR atexit (3),
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR exit (3),
|
2005-06-14 11:20:57 +00:00
|
|
|
.BR on_exit (3),
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR termios (3)
|