atexit man page

Section 3 - openSUSE 10.2 Man Pages

Other operating system man pages available here

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!

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



NAME
       atexit - register a function to be called at normal process termination

SYNOPSIS
       #include <stdlib.h>

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

DESCRIPTION
       The atexit() function registers the given function to be called at nor-
       mal process termination, either via exit(3) or via return from the pro-
       gram's main().  Functions so registered are called in the reverse order
       of their registration; no arguments are passed.

       POSIX.1-2001  requires that an implementation allow at least ATEXIT_MAX
       (32) such functions to be registered.  The actual limit supported by an
       implementation can be obtained using sysconf(3).

       When  a  child process is created via fork(), it inherits copies of its
       parents registrations.  Upon a successful call to  one  of  the  exec()
       functions, all registrations are removed.

RETURN VALUE
       The  atexit()  function returns the value 0 if successful; otherwise it
       returns a non-zero value.

EXAMPLE
       #include <stdio.h>
       #include <stdlib.h>
       #include <unistd.h>

       void bye(void) {
               printf("That was all, folks\n");
       }

       int main(){
               long a;
               int i;

               a = sysconf(_SC_ATEXIT_MAX);
               printf("ATEXIT_MAX = %ld\n", a);

               i = atexit(bye);
               if (i != 0) {
                       fprintf(stderr, "cannot set exit function\n");
                       return EXIT_FAILURE;
               }
               return EXIT_SUCCESS;
       }

NOTES
       Since glibc 2.2.3, atexit() (and on_exit()) can be  used  to  within  a
       shared  library  to establish functions that are called when the shared
       library is unloaded.

       Functions registered using atexit() (and on_exit()) are not called if a
       process terminates abnormally because of the delivery of a signal.

CONFORMING TO
       SVr4, 4.3BSD, C89, C99, POSIX.1-2001.

SEE ALSO
       _exit(3), exit(3), on_exit(3)



                                  2003-11-01                         ATEXIT(3)

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

svn man page (6139 hits)
(FreeBSD 6.2)

sqlite3 man page (5592 hits)
(openSUSE 10.2)

adv_cap_autoneg man page (5041 hits)
(Solaris 10 11_06)

CPAN man page (4786 hits)
(Suse Linux 10.1)

ssh man page (4438 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (3505 hits)
(Solaris 10 11_06)

signal man page (3362 hits)
(Suse Linux 10.1)

netcat man page (3359 hits)
(Suse Linux 10.1)

pprosetup man page (2871 hits)
(Solaris 10 11_06)

startproc man page (2730 hits)
(Suse Linux 10.1)