| on_exit(3) - phpMan
ON_EXIT(3) Linux Programmer's Manual ON_EXIT(3)
NAME
on_exit - register a function to be called at normal process termination
SYNOPSIS
#include <stdlib.h>
int on_exit(void (*function)(int , void *), void *arg);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
on_exit(): _BSD_SOURCE || _SVID_SOURCE
DESCRIPTION
The on_exit() function registers the given function to be called at normal process termi‐
nation, whether via exit(3) or via return from the program's main(). The function is
passed the status argument given to the last call to exit(3) and the arg argument from
on_exit().
The same function may be registered multiple times: it is called once for each registra‐
tion.
When a child process is created via fork(2), it inherits copies of its parent's registra‐
tions. Upon a successful call to one of the exec(3) functions, all registrations are
removed.
RETURN VALUE
The on_exit() function returns the value 0 if successful; otherwise it returns a nonzero
value.
CONFORMING TO
This function comes from SunOS 4, but is also present in glibc. It no longer occurs in
Solaris (SunOS 5). Portable application should avoid this function, and use the standard
atexit(3) instead.
SEE ALSO
_exit(2), atexit(3), exit(3)
COLOPHON
This page is part of release 3.74 of the Linux man-pages project. A description of the
project, information about reporting bugs, and the latest version of this page, can be
found at http://www.kernel.org/doc/man-pages/.
GNU 2014-08-19 ON_EXIT(3)
|