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.

ATRYBUTY

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

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

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.