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

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.

WERSJE¶

sigdescr_np() i sigabbrev_np() pojawiły się pierwotnie w 2.32.

Od glibc 2.32, symbol sys_siglist nie jest już eksportowany przez glibc.

ATRYBUTY¶

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

STANDARDY¶

strsignal(): POSIX.1-2008. Występuje w Solarisie i systemach BSD.

sigdescr_np() i sigabbrev_np() są rozszerzeniami GNU.

sys_siglist jest niestandardowe, ale obecne w wielu innych systemach.

UWAGI¶

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

ZOBACZ TAKŻE¶

psignal(3), strerror(3)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: 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 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.