Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       sigaltstack - Consultez ou fixer la pile de signal

SYNOPSIS

       #include <signal.h>

       int sigaltstack(const stack_t *ss, stack_t *oss);

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

       sigaltstack() :
           _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
           || /* Depuis la glibc 2.12 : */ _POSIX_C_SOURCE >= 200809L

DESCRIPTION

       sigaltstack() permet à un processus de définir  une  nouvelle  pile  spécifique  pour  les
       gestionnaires  de  signaux  et/ou de récupérer l'état d'une pile spécifique de signal déjà
       existante. Une pile spécifique de signal est utilisée durant l'exécution d'un gestionnaire
       de signal si la mise en place de ce gestionnaire (consultez sigaction(2)) le spécifiait.

       La  séquence  d'actions  nominale  pour  utiliser  une  pile  spécifique  de signal est la
       suivante :

       1. Allouer une zone mémoire qui sera utilisée comme pile spécifique de signal.

       2. Utiliser sigaltstack() afin d'informer le système de l'existence et de la  position  de
          la pile spécifique de signal.

       3. Lors  de la mise en place du gestionnaire de signal en utilisant sigaction(2), informer
          le système que ce gestionnaire de signal doit être exécuté sur la  pile  spécifique  de
          signal en positionnant le drapeau SA_ONSTACK.

       L'argument  ss  est utilisé afin de définir une nouvelle pile spécifique de signal, tandis
       que l'argument oss est utilisé afin de récupérer des informations sur la  pile  de  signal
       actuellement  en place. Si une seule de ces actions vous intéresse, alors l'autre argument
       peut être positionné à NULL. Chacun de ces paramètres est une structure du type suivant :

           typedef struct {
               void  *ss_sp;     /* Adresse de base de la pile*/
               int    ss_flags;  /* drapeaux */
               size_t ss_size;   /* Nombre d'octets dans la pile */
           } stack_t;

       Afin de mettre en place une nouvelle pile spécifique de signal, ss.ss_flags est positionné
       à  zéro,  et ss.ss_sp et ss.ss_size spécifient l'adresse de début et la taille de la pile.
       La constante SIGSTKSZ est définie de façon à être suffisamment  grande  pour  couvrir  les
       besoins  typiques  en  espace  mémoire  d'une  pile  spécifique de signal, et la constante
       MINSIGSTKSZ définit la taille  minimum  nécessaire  à  l'exécution  d'un  gestionnaire  de
       signal.

       Lorsqu'un  gestionnaire  de  signal  est  invoqué  sur la pile spécifique, le noyau aligne
       automatiquement l'adresse donnée dans ss.ss_sp sur une valeur correcte pour l'architecture
       matérielle utilisée.

       Afin  de désactiver une pile existante, positionnez ss.ss_flags à SS_DISABLE. Dans ce cas,
       les autres champs de ss sont ignorés.

       Si oss ne vaut pas NULL, alors il est utilisé afin de renvoyer  des  informations  sur  la
       pile  spécifique  de  signal  qui était utilisée avant l'appel à sigaltstack(). Les champs
       oss.ss_sp et oss.ss_size renvoient l'adresse de départ et la  taille  de  cette  pile.  Le
       champ oss.ss_flags peut renvoyer l'une des valeurs suivantes :

       SS_ONSTACK
              Le  processus  s'exécute  actuellement sur la pile spécifique de signal. (Remarquez
              qu'il n'est pas possible de changer la pile spécifique de signal  si  le  processus
              est en train de s'exécuter sur cette dernière.)

       SS_DISABLE
              La pile spécifique de signal est actuellement désactivée.

VALEUR RENVOYÉE

       sigaltstack() renvoie 0 en cas de succès, ou -1 en cas d'échec en positionnant alors errno
       pour préciser l'erreur.

ERREURS

       EFAULT L'un des paramètres ss ou oss ne vaut pas NULL et  pointe  vers  une  zone  mémoire
              n'appartenant pas à l'espace d'adressage du processus.

       EINVAL ss  ne  vaut pas NULL et le champ ss_flags contient une valeur non nulle différente
              de SS_DISABLE.

       ENOMEM La taille de la nouvelle  pile  spécifique  de  signal  indiquée  (ss.ss_size)  est
              inférieure à MINSTKSZ.

       EPERM  On  a  essayé  de  modifier  la  pile spécifique de signal alors que celle-ci était
              active (c'est-à-dire, le processus était déjà en train de s'exécuter  sur  la  pile
              spécifique de signal courante).

CONFORMITÉ

       SUSv2, SVr4, POSIX.1-2001.

NOTES

       Le  cas  le plus courant d'utilisation d'une pile spécifique est pour la gestion du signal
       SIGSEGV qui est généré si la place disponible  pour  la  pile  normale  du  processus  est
       épuisée. Dans ce cas, un gestionnaire pour SIGSEGV ne peut pas être exécuté sur la pile du
       processus ; si l'on souhaite l'intercepter, on doit utiliser une pile spécifique.

       La mise en place d'une pile spécifique de signal est utile si un processus soupçonne qu'il
       est susceptible d'épuiser sa pile standard. Cela peut se produire, par exemple, lorsque la
       pile grossit au point de rencontrer la limite supérieure du tas, ou si  elle  atteint  une
       limite  établie  par  un  appel  à setrlimit(RLIMIT_STACK, &rlim). Si la pile standard est
       épuisée, le noyau envoie au processus un signal SIGSEGV. Dans ces circonstances, la  seule
       façon d'intercepter ce signal est d'utiliser une pile spécifique de signal.

       Sur  la  plupart  des  architectures  supportées  par Linux, les piles s'étendent vers les
       adresses décroissantes. sigaltstack() prend automatiquement en charge le sens  d'expansion
       de la pile.

       Les  fonctions  appelées  depuis  un  gestionnaire  de  signal  s'exécutant  sur  une pile
       spécifique de signal utilisent également cette pile. (Cela s'applique également à tous les
       gestionnaires  invoqués pour d'autres signaux alors que le processus s'exécute sur la pile
       spécifique de signal.)  Contrairement  à  la  pile  standard,  le  système  n'accroît  pas
       automatiquement  la  pile  spécifique  de  signal. Dépasser la taille allouée pour la pile
       spécifique de signal conduit à des résultats imprévisibles.

       Un appel execve(2) réussi détruit  toutes  piles  spécifiques  de  signal  existantes.  Un
       processus  fils  créé avec fork(2) hérite d'une copie des paramètres de la pile spécifique
       de signal de son père.

       sigaltstack() succède à l'ancien appel sigstack(). Pour des raisons de  compatibilité,  la
       glibc  implémente  sigstack(). Toutes les nouvelles applications devraient être écrites en
       utilisant sigaltstack().

   Historique
       BSD 4.2 possédait un appel système  sigstack().  Il  utilisait  une  structure  légèrement
       différente, et avait comme désavantage principal la nécessité pour l'appelant de connaître
       le sens d'expansion de la pile.

EXEMPLE

       Le segment de code suivant donne un exemple d'utilisation de sigaltstack() :

           stack_t ss;

           ss.ss_sp = malloc(SIGSTKSZ);
           if (ss.ss_sp == NULL)
               /* Traitement de l'erreur */;
           ss.ss_size = SIGSTKSZ;
           ss.ss_flags = 0;
           if (sigaltstack(&ss, NULL) == -1)
               /* Traitement de l'erreur */;

VOIR AUSSI

       execve(2), setrlimit(2), sigaction(2), siglongjmp(3), sigsetjmp(3), signal(7)

COLOPHON

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

TRADUCTION

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

       Stéphan Rafin (2002), Alain Portal <URL:http://manpagesfr.free.fr/> (2006). Julien Cristau
       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> ».