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 d'enregistrer au moins ATEXIT_MAX (32) de ces fonctions. La limite actuelle de l'implémentation peut être obtenue avec sysconf(3).

Lorsqu'un processus fils est créé avec fork(2), il hérite d'une copie des enregistrements de son père. À la suite d'un appel réussi à l'une de ces fonctions, tous les enregistrements sont supprimé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
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.

  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.

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");
        exit(EXIT_FAILURE);
    }
    exit(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 juillet 2008.

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.