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(), │ Bezpieczeństwo wątkowe │ MT-bezpieczne                                  │
       │sigabbrev_np() │                        │                                                │
       └───────────────┴────────────────────────┴────────────────────────────────────────────────┘

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
       ⟨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⟩.