strsignal

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[];

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(), sigabbrev_np()	Sécurité des threads	MT-Safe

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-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 <[email protected]>, Thierry Vignaud <[email protected]>, François Micaux, Alain Portal <[email protected]>, Jean-Philippe Guérard <[email protected]>, Jean-Luc Coulon (f5ibh) <[email protected]>, Julien Cristau <[email protected]>, Thomas Huriaux <[email protected]>, Nicolas François <[email protected]>, Florentin Duneau <[email protected]>, Simon Paillard <[email protected]>, Denis Barbier <[email protected]>, David Prévot <[email protected]>, Frédéric Hantrais <[email protected]> et Lucien Gentis <[email protected]> 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 à [email protected]