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)