Documentation Archive Developer
Search
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



ATEXIT(3)                BSD Library Functions 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 (*func)(void));

DESCRIPTION
     The atexit() function registers the function func to be called at program
     exit, whether via exit(3) or via return from the program's main().  Func-tions Functions
     tions so registered are called in reverse order; no arguments are passed.

     These functions must not call exit(); if it should be necessary to termi-nate terminate
     nate the process while in such a function, the _exit(2) function should
     be used.  (Alternatively, the function may cause abnormal process termi-nation, termination,
     nation, for example by calling abort(3).)

     At least 32 functions can always be registered; more are allowed 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 ISO/IEC 9899:1990 (``ISO C90'').

BSD                            September 6, 2002                           BSD