.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\" May be distributed under the GNU General Public License
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Fri Apr  2 18:41:36 1993, David Metcalfe
.\" Modified Sun Jul 25 10:53:14 1993, Rik Faith (faith@cs.unc.edu)
.TH ON_EXIT 3  "April 2, 1993" "GNU" "Linux Programmer's Manual"
.SH NAME
on_exit \- register a function to be called at normal program termination.
.SH SYNOPSIS
.nf
.B #include <stdlib.h>
.sp
.BI "int on_exit(void (*" function ")(int , void *), void *" arg );
.fi
.SH DESCRIPTION
The \fBon_exit()\fP function registers the given \fIfunction\fP to be
called at normal program termination, whether via
.BR exit (2)
or via return
from the program's \fBmain\fP.  The \fIfunction\fP is passed the argument 
to
.BR exit (3)
and the \fIarg\fP argument from \fBon_exit()\fP.
.SH "RETURN VALUE"
The \fBon_exit()\fP function returns the value 0 if successful; otherwise
the value -1 is returned.
.SH SEE ALSO
.BR exit "(3), " atexit (3)