GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:on_exit

ON_EXIT(3) Linux Programmer's Manual ON_EXIT(3)

NAME

     on_exit  -  register a function to be called at normal process termina-
     tion

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():
         Since glibc 2.19:
             _DEFAULT_SOURCE
         Glibc 2.19 and earlier:
             _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

     The on_exit() function registers the given function  to  be  called  at
     normal  process termination, 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 registration.
     When a child process is created via fork(2), it inherits copies of  its
     parent's  registrations.   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.

ATTRIBUTES

     For   an   explanation   of   the  terms  used  in  this  section,  see
     attributes(7).
     +----------+---------------+---------+
     |Interface | Attribute     | Value   |
     +----------+---------------+---------+
     |on_exit() | Thread safety | MT-Safe |
     +----------+---------------+---------+

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 4.16 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
     https://www.kernel.org/doc/man-pages/.

GNU 2017-09-15 ON_EXIT(3)

/data/webs/external/dokuwiki/data/pages/man/on_exit.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki