ATEXIT(3)

NOM
atexit - Enregistrer une fonction à invoquer à la fin du processus

SYNOPSIS
#include <stdlib.h>

int atexit (void (*fonction)(void));

DESCRIPTION
La fonction atexit() enregistre la fonction donnée pour que celle-ci soit automatiquement invoquée lorsque le processus se termine normalement avec exit(3) ou par un retour de la fonction main(). Les fonctions ainsi enregistrées sont invoquées en ordre inverse de leur enregistrement, aucun argument n'est transmis.

POSIX.1-2001 réclame qu'une implémentation permette qu'au moins ATEXIT_MAX (32) fonctions puissent être enregistrées. La limite actuellement supportée par une implémentation peut être obtenue en utilisant sysconf(3).

Lorsqu'un processus fils est créé avec fork(2), il hérite d'une copie des enregistrements de son père. Avec un appel réussi à l'une de ces fonctions, tous les enregistrements sont annulés

VALEUR RENVOYÉE
La fonction atexit() renvoie 0 si elle réussit, et une valeur non-nulle si elle échoue.

CONFORMITÉ
SVr4, BSD 4.3, C89, C99, POSIX.1-2001.

NOTES

  Notes Linux
Depuis la glibc 2.2.3, atexit() (et on_exit(3)) peuvent être utilisée dans une bibliothèque partagée pour établir des fonctions qui sont appelées lorsque la bibliothèque partagée est déchargée.

Les fonctions enregistrées avec atexit() (et on_exit(3)) ne sont pas appelées si un processus se termine de manière anormale à cause de la délivrance d'un signal.

EXEMPLE
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
void
bye(void) {
    printf("That was all, folks\n");
}
int
main(void)
{
    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;
}

VOIR AUSSI
_exit(2), exit(3), on_exit(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 22 octobre 1996 et révisée le 17 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 atexit ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.