atexit

Autres langues

Langue: fr

Version: 1er novembre 2003 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

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 27 novembre 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.