xref: /csrg-svn/lib/libc/stdlib/atexit.3 (revision 42098)
Copyright (c) 1990 The Regents of the University of California.
All rights reserved.

This code is derived from software contributed to Berkeley by
Chris Torek.

%sccs.include.redist.man%

@(#)atexit.3 5.1 (Berkeley) 05/15/90

ATEXIT 3 ""
C 7
NAME
atexit - register a function to be called on exit
SYNOPSIS
#include <stdlib.h>

"atexit(void (*function)())

DESCRIPTION
Atexit registers the given function to be called at program 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 allowed as long as sufficient memory can be allocated.
RETURN VALUE
Atexit returns 0 on success, -1 on 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
Atexit conforms to ANSI X3.159-1989 (``ANSI C'').