atexit(3) - NetBSD Manual Pages

ATEXIT(3)                 NetBSD Programmer's Manual                 ATEXIT(3)


NAME

     atexit - register a function to be called on exit


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <stdlib.h>

     int
     atexit(void (*function)(void));


DESCRIPTION

     The atexit() function registers the given function to be called at pro-
     gram exit, whether via exit(3) or via return from the program's main.
     Functions so registered are called in reverse order; no arguments are
     passed.  At least 32 functions can always be registered, and more are al-
     lowed as long as sufficient memory can be allocated.


RETURN VALUES

     The atexit() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.


ERRORS

     [ENOMEM]      No memory was available to add the function to the list.
                   The existing list of functions is unmodified.


SEE ALSO

     exit(3)


STANDARDS

     The atexit() function conforms to ANSI X3.159-1989 (``ANSI C'').

NetBSD 1.6                       June 4, 1993                                1