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

Linux man-pages 6.9.1                            2 maja 2024 r.                                     strsignal(3)