Available in

(3) (7) (3)/de (3)/es (3)/fr (3)/ja (3)/ko (3)/pl (3)/pt

Contents

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 (voir 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. 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. Par défaut, Linux/glibc suit le comportement de System V, mais le comportement BSD est fournit si la macro de test de fonctionnalités _BSD_SOURCE est définie et aucune des macros _POSIX_SOURCE, _POSIX_C_SOURCE, _XOPEN_SOURCE, _XOPEN_SOURCE_EXTENDED, _GNU_SOURCE ou _SVID_SOURCE n’est définie.

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

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.23 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

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/>; entre 1996 et 2003, puis par Alain Portal <aportal AT univ−montp2 DOT fr> jusqu’en 2006, et mise à disposition sur http://manpagesfr.free.fr/.

Les mises à jour et corrections de la version présente dans Debian sont directement gérées par Nicolas François <nicolas.francois [AT] centraliens.net> et l’équipe francophone de traduction de Debian.

Veuillez signaler toute erreur de traduction en écrivant à <debian−l10n−french [AT] lists.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> ».

COMMENTS

blog comments powered by Disqus