NOM

       on_exit - Programmer une fonction à appeler à la fin normale du programme

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <stdlib.h>

       int on_exit(void (*fonction)(int, void *), void *arg);

   Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

       on_exit() :
           Depuis la glibc 2.19 :
               _DEFAULT_SOURCE
           glibc 2.19 et antérieures :
               _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION

       La  fonction on_exit() enregistre la fonction à appeler à la fin normale du programme, soit par l'appel à
       exit(3), soit lors du retour de la fonction main() du programme. La fonction reçoit le  paramètre  d'état
       transmis au dernier appel à exit(3) et le paramètre arg transmis à on_exit().

       La  même  fonction  peut  être  enregistrée  plusieurs  fois  :  elle  sera  appelée une fois pour chaque
       enregistrement.

       Lorsqu'un processus enfant est créé avec fork(2), il  hérite  d'une  copie  des  enregistrements  de  son
       parent.  À  la  suite  d'un  appel  réussi  à  l'une des fonctions exec(3), tous les enregistrements sont
       supprimés.

VALEUR RENVOYÉE

       La fonction on_exit() renvoie 0 si elle réussit ; sinon elle renvoie une valeur non nulle.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ on_exit()                                                            │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       Aucun.

HISTORIQUE

       SunOS 4, glibc. Supprimé dans Solaris (SunOS 5). Utiliser la fonction standard atexit(3) à la place.

AVERTISSEMENTS

       Au moment où fonction est exécutée, les variables de la pile (auto) peuvent déjà  être  hors  de  portée.
       Ainsi,  arg  ne  doit  pas  être  un  pointeur sur une variable de pile ; mais il peut par contre être un
       pointeur sur une variable du tas ou une variable globale.

VOIR AUSSI

       _exit(2), atexit(3), exit(3)

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>, François Micaux, Alain Portal  <aportal@univ-montp2.fr>,  Jean-Philippe  Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,     Thomas     Huriaux      <thomas.huriaux@gmail.com>,      Nicolas      François
       <nicolas.francois@centraliens.net>,     Florentin     Duneau    <fduneau@gmail.com>,    Simon    Paillard
       <simon.paillard@resel.enst-bretagne.fr>,   Denis   Barbier   <barbier@debian.org>   et    David    Prévot
       <david@tilapin.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                         on_exit(3)