NOM

       setjmp, sigsetjmp - Sauver le contexte de pile pour un saut non local

SYNOPSIS

       #include <setjmp.h>

       int setjmp(jmp_buf env);

       int sigsetjmp(sigjmp_buf env, int savesigs);

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

       setjmp() : consultez la section NOTES.
       sigsetjmp() : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_C_SOURCE

DESCRIPTION

       Les  fonctions  setjmp()  et  longjmp(3)  sont  utiles  pour  gérer  les  erreurs  et  les
       interruptions rencontrées dans des routines bas-niveau. setjmp() sauvegarde le contexte de
       pile et d'environnement dans env afin de l'utiliser  ultérieurement  avec  longjmp(3).  Le
       contexte de pile sera invalide si la fonction qui appelle setjmp() se termine.

       sigsetjmp() est semblable à setjmp(). Si, et seulement si, savesigs est non nul, le masque
       de signaux  actuel  du  processus  est  sauvegardé  dans  env,  et  sera  rétabli  lorsque
       siglongjmp(3) sera invoqué avec ce contexte env.

VALEUR RENVOYÉE

       setjmp() et sigsetjmp() renvoient 0 lorsqu'elles reviennent directement, et une valeur non
       nulle si elles reviennent à travers un appel à longjmp(3) ou siglongjmp(3) en utilisant le
       contexte sauvegardé.

CONFORMITÉ

       C89, C99 et POSIX.1-2001 spécifient setjmp(). POSIX.1-2001 spécifie sigsetjmp().

NOTES

       POSIX  ne  spécifie pas si setjmp() sauve le masque de signaux (pour être ensuite restauré
       lors de longjmp(3)). Sous System V, ce n'est pas le cas.  Sous  BSD 4.3,  le  masque  sera
       sauvé et il y a une fonction _setjmp qui ne fait pas la copie. Sous Linux avec glibc avant
       la  version 2.19,  setjmp()  suit  le  comportement  de  System V  par  défaut,  mais   le
       comportement  BSD  est  fournit  si  la  macro  de test de fonctionnalités _BSD_SOURCE est
       définie  et  qu’aucune   des   macros   _POSIX_SOURCE,   _POSIX_C_SOURCE,   _XOPEN_SOURCE,
       _XOPEN_SOURCE_EXTENDED,  _GNU_SOURCE  ou  _SVID_SOURCE  n'est  définie. Depuis glibc 2.19,
       <setjmp.h> n’expose que la version System V de setjmp(). Les programmes ayant besoin de le
       sémantique  BSD  devraient  remplacer les appels de setjmp() par des appels de sigsetjmp()
       avec un argument savesigs non nul.

       Si vous souhaitez sauver et restaurer le masque de signaux  de  façon  portable,  utilisez
       sigsetjmp() et siglongjmp(3).

       setjmp()  et sigsetjmp() rendent les programmes difficiles à comprendre et à maintenir. Si
       possible, essayez d'utiliser une autre méthode.

VOIR AUSSI

       longjmp(3), siglongjmp(3)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Nicolas  François  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».

                                          7 janvier 2014                                SETJMP(3)