exit - Man Page

terminate a process

Prolog

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

Synopsis

#include <stdlib.h>

void exit(int status);

Description

The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2017 defers to the ISO C standard.

The value of status may be 0, EXIT_SUCCESS, EXIT_FAILURE, or any other value, though only the least significant 8 bits (that is, status & 0377) shall be available from wait() and waitpid(); the full value shall be available from waitid() and in the siginfo_t passed to a signal handler for SIGCHLD.

The exit() function shall first call all functions registered by atexit(), in the reverse order of their registration, except that a function is called after any previously registered functions that had already been called at the time it was registered. Each function is called as many times as it was registered. If, during the call to any such function, a call to the longjmp() function is made that would terminate the call to the registered function, the behavior is undefined.

If a function registered by a call to atexit() fails to return, the remaining registered functions shall not be called and the rest of the exit() processing shall not be completed. If exit() is called more than once, the behavior is undefined.

The exit() function shall then flush all open streams with unwritten buffered data and close all open streams. Finally, the process shall be terminated with the same consequences as described in Consequences of Process Termination.

Return Value

The exit() function does not return.

Errors

No errors are defined.

The following sections are informative.

Examples

None.

Application Usage

None.

Rationale

See _Exit().

Future Directions

None.

See Also

_Exit(), atexit(), exec, longjmp(), tmpfile(), wait(), waitid()

The Base Definitions volume of POSIX.1-2017, <stdlib.h>

Referenced By

abort(3p), aio_error(3p), aio_read(3p), aio_return(3p), aio_write(3p), atexit(3p), close(3p), exec(3p), _Exit(3p), flockfile(3p), getrusage(3p), lio_listio(3p), mlock(3p), mlockall(3p), posix_spawn(3p), pthread_exit(3p), semop(3p), sh(1p), shmat(3p), shmdt(3p), stdlib.h(0p), wait(3p), waitid(3p).

2017 IEEE/The Open Group POSIX Programmer's Manual