NOM

       strsignal, sigabbrev_np, sigdescr_np, sys_siglist - Renvoyer une chaîne décrivant un signal

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <string.h>

       char *strsignal(int sig);
       const char *sigdescr_np(int sig);
       const char *sigabbrev_np(int sig);

       [[obsolète]] extern const char *const sys_siglist[];

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

       sigabbrev_np(), sigdescr_np() :
           _GNU_SOURCE

       strsignal() :
           De la glibc 2.10 à la glibc 2.31 :
               _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _GNU_SOURCE

       sys_siglist :
           Depuis la glibc 2.19 :
               _DEFAULT_SOURCE
           glibc 2.19 et antérieures :
               _BSD_SOURCE

DESCRIPTION

       La fonction strsignal() renvoie une chaîne décrivant le signal numéro sig passé en argument. La chaîne ne
       peut  être  utilisée  que  jusqu'à l'appel suivant de strsignal(). La chaîne renvoyée par strsignal() est
       localisée en fonction de la catégorie LC_MESSAGES des paramètres régionaux en vigueur.

       La fonction sigdescr_np() renvoie une chaîne décrivant le signal numéro  sig  passé  en  argument.  À  la
       différence de strsignal(), cette chaîne ne tient pas compte des paramètres régionaux en vigueur.

       La  fonction  sigabbrev_np() renvoie le nom abrégé du signal sig. Si par exemple, la valeur spécifiée est
       SIGINT, elle renvoie la chaîne « INT ».

       Le tableau sys_siglist (obsolète) contient les chaînes de description des signaux indexées par le  numéro
       de  signal.  Dans  la  mesure  du  possible,  il  est préférable d'utiliser les fonctions  strsignal() ou
       sigdescr_np() ; voir aussi VERSIONS.

VALEUR RENVOYÉE

       La fonction strsignal() renvoie la chaîne de description appropriée ou un  message  indiquant  un  signal
       inconnu  si  le numéro du signal n’est pas valable. Sur certains systèmes (pas sur Linux), NULL peut être
       renvoyé pour un numéro de signal non valable.

       Les fonctions sigdescr_np() et sigabbrev_np() renvoient la chaîne de description  appropriée.  La  chaîne
       renvoyée  est  allouée statiquement et valable pour la durée de vie du programme. Ces fonctions renvoient
       NULL pour un numéro de signal non valable.

VERSIONS

       Les fonctions sigdescr_np() et sigabbrev_np() sont apparues dans la glibc 2.32.

       À partir de la glibc 2.32, le symbole sys_siglist n'est plus pris exporté par la glibc.

ATTRIBUTS

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

STANDARDS

       strsignal() : POSIX.1-2008. Présente sur Solaris et les BSD.

       Les fonctions sigdescr_np() et sigabbrev_np() sont des extensions GNU.

       sys_siglist n'est pas un symbole standard, mais il est présent sur de nombreux autres systèmes.

NOTES

       Les fonctions sigdescr_np() et sigabbrev_np() sont sûres vis-à-vis des threads et dans un contexte de si‐
       gnal asynchrone (« async-signal-safe »).

VOIR AUSSI

       psignal(3), strerror(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 <tvi‐
       gnaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe  Guérard  <fe‐
       vrier@tigreraye.org>,  Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@de‐
       bian.org>,  Thomas  Huriaux  <thomas.huriaux@gmail.com>,   Nicolas   François   <nicolas.francois@centra‐
       liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
       Denis   Barbier   <barbier@debian.org>,   David  Prévot  <david@tilapin.org>,  Frédéric  Hantrais  <fhan‐
       trais@gmail.com> et Lucien Gentis <lucien.gentis@waika9.com>

       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 à de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    5 février 2023                                     strsignal(3)