explain_exit(3) [debian man page]

explain_exit(3) 					     Library Functions Manual						   explain_exit(3)

NAME

       explain_exit - print an explanation of exit status before exiting

SYNOPSIS

       #include <libexplain/libexplain.h>
       void explain_exit_on_exit(void);
       void explain_exit_on_error(void);
       void explain_exit_cancel(void);

DESCRIPTION

       The  explain_exit_on_exit  function  may  be  used to have the calling program print an explanation of its exit status (the value passed to
       exit(3) or the return value from main) immediately before it terminates.

       The explain_exit_on_error function may be used to have the calling program print an explanation of its exit status  immediately	before	it
       terminates, if that exit status is not EXIT_SUCCESS.

       The explain_exit_cancel function may be used to cancel the effect of the explain_exit_on_exit or explain_exit_on_error function.

       These  functions  may  be  called multiple times, and in any order.  The last called has precedence.  The explanation will never be printed
       more than once.

   Call Exit As Normal
       In order to have the explanation printed, simply call exit(3) as normal, or return from main as normal.	Do not call any of these functions
       in order to exit your program, they are called before you exit your program.

   Caveat
       This  functionality  is	only available on systems with the on_exit(3) system call.  Unfortunately, the atexit(3) system call is not suffi-
       ciently capable, as it does not pass the exit status to the registered function.

SEE ALSO

       exit(3) cause normal process termination

       atexit(3)
	       register a function to be called at normal process termination

       on_exit(3)
	       register a function to be called at normal process termination

COPYRIGHT

       libexplain version 0.52
       Copyright (C) 2009 Peter Miller

AUTHOR

       Written by Peter Miller <pmiller@opensource.org.au>

																   explain_exit(3)

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():
	   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.15 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)