strsignal(3)

NAZWA
strsignal, sigabbrev_np, sigdescr_np, sys_siglist - zwraca łańcuch opisujący sygnał

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

SKŁADNIA
#include <string.h>

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

[[przestarzałe]] extern const char *const sys_siglist[];

    Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

sigabbrev_np(), sigdescr_np():
    _GNU_SOURCE

strsignal():
    Od glibc 2.10 do glibc 2.31:
        _POSIX_C_SOURCE >= 200809L
    Przed glibc 2.10:
        _GNU_SOURCE

sys_siglist:
    Od glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 i wcześniejsze:
        _BSD_SOURCE

OPIS
Funkcja strsignal() zwraca łańcuch opisujący numer sygnału przekazany w argumencie sig. Łańcuch może być używany tylko do następnego wywołania funkcji strsignal(). Łańcuch zwracany przez strsignal() jest przetłumaczony zgodnie z kategorią LC_MESSAGES bieżących ustawień regionalnych (locale).

Funkcja sigdescr_np() zwraca łańcuch opisujący numer sygnału przekazany w argumencie sig. W przeciwieństwie do strsignal() na łańcuch ten nie wpływają bieżące ustawienia regionalne (locale).

Funkcja sigabbrev_np() zwraca skróconą nazwę sygnału sig. Przykładowo, dla wartości SIGINT, zwraca łańcuch „INT”.

(Przestarzała) tablica sys_siglist przechowuje łańcuchy opisujące sygnały poindeksowane według numerów sygnałów. Jeżeli jest to możliwe, należy raczej korzystać z funkcji strsignal()lub sigdescr_np() niż z bezpośredniego dostępu do tej tablicy; zob. też WERSJE.

WARTOŚĆ ZWRACANA
Funkcja strsignal() zwraca odpowiedni łańcuch opisu lub komunikat o nieznanym sygnale, gdy numer sygnału jest błędny. W niektórych systemach (ale nie w Linuksie) dla błędnego numeru sygnału może zostać zwrócony wskaźnik NULL zamiast komunikatu.

Funkcja sigdescr_np() i sigabbrev_np() zwraca odpowiedni łańcuch opisu. Zwracany łańcuch jest alokowany statycznie i prawidłowy w czasie istnienia programu. Funkcje te zwracają NULL, jeśli poda się nieprawidłowy numer sygnału.

ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
Interfejs | Atrybut | Wartość
strsignal() | Bezpieczeństwo wątkowe | MT-niebezpieczne race:strsignal locale
sigdescr_np(), sigabbrev_np() | Bezpieczeństwo wątkowe | MT-bezpieczne

STANDARDY

strsignal()
    POSIX.1-2008.

sigdescr_np()
sigabbrev_np()
    GNU.

sys_siglist
    Brak.

HISTORIA

strsignal()
    POSIX.1-2008. Solaris, BSD.

sigdescr_np()
sigabbrev_np()
    glibc 2.32.

sys_siglist
    Usunięte w glibc 2.32.

UWAGI
sigdescr_np() i sigabbrev_np() są wątkowo bezpieczne i async-signal-safe.

ZOBACZ TAKŻE
psignal(3), strerror(3)

TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika: Paweł Wilk <siefca@pl.qmail.org>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 (https://www.gnu.org/licenses/gpl-3.0.html) lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.