strsignal(3) Library Functions Manual strsignal(3)
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égio-
naux 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 pos-
sible, il est préférable d'utiliser les fonctions strsignal() ou sig-
descr_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 ex-
porté 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 signal asynchrone (« async-si-
gnal-safe »).
VOIR AUSSI
psignal(3), strerror(3)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.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.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.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
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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.03 5 février 2023 strsignal(3)
Generated by dwww version 1.15 on Sat Jun 29 00:26:31 CEST 2024.