Provided by: manpages-pl-dev_4.21.0-2_all bug

NAZWA

       sigaction, rt_sigaction - bada i zmienia akcję sygnału

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <signal.h>

       int sigaction(int signum,
                     const struct sigaction *_Nullable restrict act,
                     struct sigaction *_Nullable restrict oldact);

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

       sigaction():
           _POSIX_C_SOURCE

       siginfo_t:
           _POSIX_C_SOURCE >= 199309L

OPIS

       Wywołanie  systemowe sigaction() jest używane do zmieniania akcji, którą odbiera proces po
       odebraniu określonego sygnału. (Wprowadzenie do  sygnałów  można  znaleźć   w  podręczniku
       signals(7)).

       signum określa sygnał i może być dowolnym prawidłowym sygnałem poza SIGKILL i SIGSTOP.

       Jeśli  act  nie  jest  NULL-em,  to  nowa akcja dla sygnału signum jest brana z act. Jeśli
       oldact też jest różny od NULL, to poprzednia akcja jest w nim zachowywana.

       Struktura sigaction jest zdefiniowana jako:

           struct sigaction {
               void     (*sa_handler)(int);
               void     (*sa_sigaction)(int, siginfo_t *, void *);
               sigset_t   sa_mask;
               int        sa_flags;
               void     (*sa_restorer)(void);
           };

       Na niektórych architekturach część tej  struktury  może  być  unią:  nie  należy  ustawiać
       jednocześnie pól sa_handler oraz sa_sigaction.

       Pole  sa_restorer  nie  jest  przeznaczone do bezpośredniego stosowania (POSIX nie określa
       pola sa_restorer). Więcej informacji o przeznaczeniu tego pola można znaleźć w podręczniku
       sigreturn(2).

       sa_handler  specifies  the  action  to  be  associated  with  signum and can be one of the
       following:

       •  SIG_DFL for the default action.

       •  SIG_IGN to ignore this signal.

       •  A pointer to a signal handling function.  This function receives the signal  number  as
          its only argument.

       If  SA_SIGINFO  is  specified  in  sa_flags,  then  sa_sigaction  (instead  of sa_handler)
       specifies  the  signal-handling  function  for  signum.   This  function  receives   three
       arguments, as described below.

       sa_mask  określa maskę sygnałów, które powinny być blokowane (tj. dodane do maski sygnałów
       wątku, z którego sygnał został wywołany) podczas  wywoływania  funkcji  obsługi  sygnałów.
       Dodatkowo,  sygnał,  który  wywołał tę funkcję obsługi  będzie zablokowany, chyba że użyto
       flagi SA_NODEFER.

       sa_flags podaje zbiór flag, które modyfikują zachowanie procesu obsługi sygnałów.  Jest to
       zbiór wartości połączonych bitowym OR:

       SA_NOCLDSTOP
              Jeśli  signum  jest  równe SIGCHLD, to nie są odbierane powiadomienia o zatrzymaniu
              procesu-dziecka (np. gdy dziecko otrzyma jeden  z  SIGSTOP,  SIGTSTP,  SIGTTIN  lub
              SIGTTOU)  ani  o jego wznowieniu (np. po otrzymaniu SIGCONT) (patrz wait(2)). Flaga
              ta ma znaczenie tylko w przypadku ustawiania funkcji obsługi sygnału SIGCHLD.

       SA_NOCLDWAIT (od Linuksa 2.6)
              Jeśli signum jest równy  SIGCHLD,  to  dzieci  po  swoim  zakończeniu  nie  zostaną
              przekształcone  w  zombie.  Patrz  także  waitpid(2).  Znacznik  ma znaczenie tylko
              ustanawiania funkcji  obsługującej  sygnał  SIGCHLD  lub  podczas  ustawiania  tego
              sygnału na SIG_DLF.

              Jeśli   znacznik   SA_NOCLDWAIT   jest   ustawiony   podczas  ustanawiania  funkcji
              obsługującej sygnał  SIGCHLD,  to  POSIX.1  nie  określa,  czy  sygnał  SIGCHLD  po
              zakończeniu  procesu  potomnego. Pod Linuksem sygnał SIGCHLD jest w takim przypadku
              generowany; niektóre inne systemy go nie  generują.

       SA_NODEFER
              Do not add the signal to the thread's signal mask while the handler  is  executing,
              unless the signal is specified in act.sa_mask.  Consequently, a further instance of
              the signal may be delivered to the thread while it is executing the handler.   This
              flag is meaningful only when establishing a signal handler.

              SA_NOMASK is an obsolete, nonstandard synonym for this flag.

       SA_ONSTACK
              Wywołuje  funkcję  obsługi sygnału, używając alternatywnego stosu ustawionego przez
              sigaltstack(2). Jeżeli ten alternatywny stos nie jest dostępny, zostanie użyty stos
              domyślny.  Flaga  ta  ma  znaczenie  tylko w przypadku ustanawiania funkcji obsługi
              sygnału.

       SA_RESETHAND
              Odtwarza akcję sygnałową do stanu domyślnego po wejściu  funkcji  obsługi  sygnału.
              Flaga ta ma znaczenie tylko w przypadku ustanawiania funkcji obsługi sygnału.

              SA_ONESHOT is an obsolete, nonstandard synonym for this flag.

       SA_RESTART
              Dostarcza  zachowania  kompatybilnego  z  semantyką  sygnałową  BSD,  czyniąc pewne
              wywołania systemowe odtwarzalnymi przez sygnały.  Flaga  ta  ma  znaczenie  podczas
              ustanawiania  procedury  obsługi  sygnału.  Informacje na temat odtwarzania wywołań
              systemowych można znaleźć w podręczniku signal(7).

       SA_RESTORER
              Nie jest przeznaczone do bezpośredniego stosowania. Flaga  ta  jest  używana  przez
              biblioteki  C  do wskazania, że pole sa_restorer zawiera adres "trampoliny sygnału"
              Więcej szczegółów w podręczniku sigreturn(2).

       SA_SIGINFO (od Linuksa 2.2)
              Funkcja obsługi sygnałów pobiera trzy argumenty,  a  nie  jeden.  W  typ  przypadku
              zamiast  ustawiać  sa_handler  należy  ustawić  sa_sigaction. Flaga ta ma znaczenie
              tylko w przypadku ustanawiania funkcji obsługi sygnału.

       SA_UNSUPPORTED (od Linuksa 5.11)
              Used to dynamically probe for flag bit support.

              If an attempt to register a handler succeeds with this flag  set  in  act->sa_flags
              alongside  other  flags  that  are  potentially  unsupported  by the kernel, and an
              immediately subsequent sigaction()  call specifying the same signal number and with
              a  non-NULL  oldact  argument yields SA_UNSUPPORTED clear in oldact->sa_flags, then
              oldact->sa_flags may be used as a  bitmask  describing  which  of  the  potentially
              unsupported  flags  are,  in fact, supported.  See the section "Dynamically probing
              for flag bit support" below for more details.

       SA_EXPOSE_TAGBITS (od Linuksa 5.11)
              Normally, when delivering a signal, an architecture-specific set of  tag  bits  are
              cleared   from   the  si_addr  field  of  siginfo_t.   If  this  flag  is  set,  an
              architecture-specific subset of the tag bits will be preserved in si_addr.

              Programs that need to be compatible with Linux versions older than  5.11  must  use
              SA_UNSUPPORTED to probe for support.

   The siginfo_t argument to a SA_SIGINFO handler
       When  the  SA_SIGINFO  flag  is  specified  in act.sa_flags, the signal handler address is
       passed via the act.sa_sigaction field.  This handler takes three arguments, as follows:

           void
           handler(int sig, siginfo_t *info, void *ucontext)
           {
               ...
           }

       These three arguments are as follows

       sig    The number of the signal that caused invocation of the handler.

       info   A pointer to a siginfo_t, which is a structure containing further information about
              the signal, as described below.

       ucontext
              This is a pointer to a ucontext_t structure, cast to void *.  The structure pointed
              to by this field  contains  signal  context  information  that  was  saved  on  the
              user-space stack by the kernel; for details, see sigreturn(2).  Further information
              about the ucontext_t structure  can  be  found  in  getcontext(3)   and  signal(7).
              Commonly, the handler function doesn't make any use of the third argument.

       The siginfo_t data type is a structure with the following fields:

           siginfo_t {
               int      si_signo;    /* Numer sygnału */
               int      si_errno;    /* Wartość zmiennej errno */
               int      si_code;     /* Kod sygnału */
               int      si_trapno;   /* Numer pułapki, które spowodowała
                                        sprzętowe wygenerowanie sygnału
                                        (nieużywane na większości architektur) */
               pid_t    si_pid;      /* ID procesu wysyłającego */
               uid_t    si_uid;      /* Rzeczywiste ID użytk. procesu wysyłającego */
               int      si_status;   /* Kod lub sygnał zakończenia */
               clock_t  si_utime;    /* Czas zużyty w przestrzeni użytkownika */
               clock_t  si_stime;    /* Czas zużyty przez system operacyjny */
               union sigval si_value;  /* Wartość sygnału */
               int      si_int;      /* Sygnał POSIX.1b */
               void    *si_ptr;      /* Sygnał POSIX.1b */
               int      si_overrun;  /* Licznik przekr. timerów; timery POSIX.1b */
               int      si_timerid;  /* ID timera; timery POSIX.1b */
               void    *si_addr;     /* Adres pamięci powodujący błąd */
               long     si_band;     /* Grupa zdarzenia (był int w
                                        glibc 2.3.2 i wcześniejszych) */
               int      si_fd;       /* Deskryptor pliku */
               short    si_addr_lsb; /* Mniej istotny bit adresu
                                        (od Linuksa 2.6.32) */
               void    *si_lower;    /* Kres dolny przy wystąpieniu naruszenia
                                        adresu (od Linuksa 3.19) */
               void    *si_upper;    /* Kres górny przy wystąpieniu naruszenia
                                        adresu (od Linuksa 3.19) */
               int      si_pkey;     /* Klucz zabezpieczający na PTE będący powodem
                                        błędu (od Linuksa 4.6) */
               void    *si_call_addr;/* Adres instrukcji wywołania systemowego
                                        (od Linuksa 3.5) */
               int      si_syscall;  /* Liczba próbowanych wywołań systemowych
                                        (od Linuksa 3.5) */
               unsigned int si_arch; /* Architektura próbowanego wywoł. systemowego
                                        (od Linuksa 3.5) */
           }

       si_signo, si_errno i si_code są zdefiniowane dla wszystkich sygnałów. (Generalnie si_errno
       nie jest używane pod Linuksem). Pozostałe  pola  struktury  mogą  być  unią;  powinno  się
       odczytywać tylko pola istotne dla danego sygnału.

       •  Sygnały  wysłane  przez  kill(2) i sigqueue(3) mają wypełnione pola si_pid oraz si_uid.
          Dodatkowo sygnały wysłane przez sigqueue(3) mają w polach  si_int  i  si_ptr  ustawione
          wartości podane przez nadawcę sygnału; szczegóły opisano w sigqueue(3).

       •  Sygnały wysłane przez timery POSIX.1b (od Linuksa 2.6) mają uzupełnione pola si_overrun
          i si_timerid. Pole si_timerid zawiera wewnętrzny identyfikator używany przez  jądro  do
          identyfikacji  timera; nie jest to ten sam identyfikator, który zwraca timer_create(2).
          Pole si_overrun zawiera informację o tym, ile razy timer się przepełnił —  jest  to  ta
          sama   informacja,  którą  zwraca  timer_getoverrun(2).  Pola  te  są  niestandardowymi
          rozszerzeniami Linuksa.

       •  Sygnały wysłane w celu notyfikacji kolejki  komunikatów  (patrz  opis  SIGEV_SIGNAL  in
          mq_notify(3))  mają  pola si_int/si_ptr wypełnione wartościami sigev_value przekazanymi
          do mq_notify(3); ponadto si_pid zawiera identyfikator procesu  wysyłającego  sygnał,  a
          si_uid rzeczywisty identyfikator użytkownika - nadawcy sygnału.

       •  SIGCHLD   fills  in  si_pid,  si_uid,  si_status,  si_utime,  and  si_stime,  providing
          information about the child.  The si_pid field is the process ID of the  child;  si_uid
          is the child's real user ID.  The si_status field contains the exit status of the child
          (if si_code is CLD_EXITED), or the signal number that  caused  the  process  to  change
          state.   The  si_utime  and  si_stime  contain the user and system CPU time used by the
          child process; these fields do not  include  the  times  used  by  waited-for  children
          (unlike  getrusage(2)   and  times(2)).  Up to Linux 2.6, and since Linux 2.6.27, these
          fields report CPU time in units of sysconf(_SC_CLK_TCK).  In Linux 2.6  kernels  before
          Linux   2.6.27,  a  bug  meant  that  these  fields  reported  time  in  units  of  the
          (configurable) system jiffy (see time(7)).

       •  SIGILL, SIGFPE, SIGSEGV, SIGBUS oraz SIGTRAP wypełniają pole si_addr, ustawiając w  nim
          adres błędu. Na niektórych architekturach sygnały wypełniają także pole si_trapno.

          Niektóre błędy pochodne SIGBUS, w szczególności BUS_MCEERR_AO i BUS_MCEERR_AR ustawiają
          także si_addr_lsb. Pole to oznacza najmniej  znaczący  bit  adresu,  zatem  i  rozmiary
          uszkodzeń.  Na  przykład  jeśli  cała  strona została uszkodzona,  si_addr_lsb zawierać
          będzie  log2(sysconf(_SC_PAGESIZE)).  Gdy  jako  odpowiedź   na   zdarzenie   ptrace(2)
          (PTRACE_EVENT_foo)  zostanie  dostarczony  SIGTRAP,  pole  si_addr nie jest wypełnione,
          natomiast pola si_pid i si_uid są wypełnione  identyfikatorami  odpowiednio  procesu  i
          użytkownika  odpowiedzialnego  za  dostarczenie  pułapki.  W  przypadku seccomp(2) jako
          dostarczenie  zdarzenia  pokazany  zostanie  zrzut.  BUS_MCERR_*   i   si_addr_lsb   są
          rozszerzeniami specyficznymi dla Linuksa.

          SEGV_BNDERR będący podbłędem SIGSEGV wypełnia pola si_lower i si_upper.

          SEGV_PKUERR będący podbłędem SIGSEGV wypełnia pole si_pkey.

       •  SIGIO/SIGPOLL (te dwie nazwy są synonimami pod Linuksem) wypełnia pola si_band i si_fd.
          Zdarzenie si_band jest  maską  bitową  zawierającą  te  same  wartości,  które  poll(2)
          umieszcza w polu revents. Pole si_fd oznacza deskryptor pliku, na którym wystąpiło dane
          zdarzenie wejścia/wyjścia; więcej szczegółów w opisie F_SETSIG w podręczniku fcntl(2).

       •  SIGSYS, generowany (od Linuksa 3.5) gdy filtr seccomp zwróci SECCOMP_RET_TRAP, wypełnia
          pola si_call_addr, si_syscall, si_arch, si_errno i inne, zgodnie z opisem z seccomp(2).

   The si_code field
       The  si_code  field  inside  the  siginfo_t argument that is passed to a SA_SIGINFO signal
       handler is a value (not a bit mask)  indicating why this signal was sent.  For a ptrace(2)
       event, si_code will contain SIGTRAP and have the ptrace event in the high byte:

           (SIGTRAP | PTRACE_EVENT_foo << 8).

       For  a  non-ptrace(2)   event,  the values that can appear in si_code are described in the
       remainder of this section.  Since glibc 2.20, the definitions of most of these symbols are
       obtained  from  <signal.h>  by  defining  feature test macros (before including any header
       file) as follows:

       •  _XOPEN_SOURCE with the value 500 or greater;

       •  _XOPEN_SOURCE and _XOPEN_SOURCE_EXTENDED; or

       •  _POSIX_C_SOURCE with the value 200809L or greater.

       For the TRAP_* constants, the symbol definitions are provided only in the first two cases.
       Before glibc 2.20, no feature test macros were required to obtain these symbols.

       W przypadku zwykłego sygnału, poniżej zestawiono wartości, które mogą występować w si_code
       dowolnego sygnału razem z powodami, dla których sygnał był wygenerowany.

           SI_USER
                  kill(2).

           SI_KERNEL
                  Wysyłany przez jądro.

           SI_QUEUE
                  sigqueue(3).

           SI_TIMER
                  Wygaśnięcie timera POSIX.

           SI_MESGQ (od Linuksa 2.6.6)
                  Zmiana stanu kolejki komunikatów POSIX; patrz mq_notify(3)

           SI_ASYNCIO
                  Ukończenie asynchronicznej operacji wejścia/wyjścia.

           SI_SIGIO
                  Queued SIGIO (only up to Linux 2.2; from Linux 2.4 onward  SIGIO/SIGPOLL  fills
                  in si_code as described below).

           SI_TKILL (od Linuksa 2.4.19)
                  tkill(2) lub tgkill(2)

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGILL:

           ILL_ILLOPC
                  Niedozwolony kod operacji.

           ILL_ILLOPN
                  Niedozwolony operand.

           ILL_ILLADR
                  Niedozwolony tryb adresowania.

           ILL_ILLTRP
                  Niedozwolona pułapka.

           ILL_PRVOPC
                  Uprzywilejowany kod operacji.

           ILL_PRVREG
                  Uprzywilejowany rejestr.

           ILL_COPROC
                  Błąd koprocesora.

           ILL_BADSTK
                  Wewnętrzny błąd stosu.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGFPE:

           FPE_INTDIV
                  Dzielenie wartości całkowitej przez zero.

           FPE_INTOVF
                  Przepełnienie liczby całkowitej.

           FPE_FLTDIV
                  Dzielenie wartości zmiennoprzecinkowej przez zero.

           FPE_FLTOVF
                  Przekroczenie zakresu operacji zmiennoprzecinkowej.

           FPE_FLTUND
                  Przekroczenie (w dół) zakresu operacji zmiennoprzecinkowej.

           FPE_FLTRES
                  Niedokładny wynik operacji zmiennoprzecinkowej.

           FPE_FLTINV
                  Niepoprawna operacja zmiennoprzecinkowa.

           FPE_FLTSUB
                  Dolny indeks poza zakresem.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGSEGV:

           SEGV_MAPERR
                  Adres niemapowany do obiektu.

           SEGV_ACCERR
                  Niepoprawne uprawnienia mapowanego obiektu.

           SEGV_BNDERR (od Linuksa 3.19)
                  Niepowodzenie sprawdzenia przypisania adresu.

           SEGV_PKUERR (od Linuksa 4.6)
                  Access was denied by memory protection keys.  See pkeys(7).  The protection key
                  which applied to this access is available via si_pkey.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGBUS:

           BUS_ADRALN
                  Niepoprawne wyrównanie adresu.

           BUS_ADRERR
                  Nieistniejący adres fizyczny.

           BUS_OBJERR
                  Błąd sprzętowy specyficzny dla obiektu.

           BUS_MCEERR_AR (od Linuksa 2.6.32)
                  Sprzętowy błąd pamięci podczas sprawdzania komputera; wymagane podjęcie akcji.

           BUS_MCEERR_AO (od Linuksa 2.6.32)
                  Wykryto sprzętowy błąd pamięci w procesie; opcjonalne podjęcie akcji.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGTRAP:

           TRAP_BRKPT
                  Punkt wstrzymania procesu.

           TRAP_TRACE
                  Śledzony proces złapany.

           TRAP_BRANCH (od Linuksa 2.4, tylko IA64)
                  Śledzone rozgałęzienie procesu złapane.

           TRAP_HWBKPT (od Linuksa 2.4, tylko IA64)
                  Pułapka sprzętowa.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGCHLD:

           CLD_EXITED
                  Proces potomny się zakończył.

           CLD_KILLED
                  Proces potomny został zabity.

           CLD_DUMPED
                  Potomek zakończył się w nieprawidłowy sposób.

           CLD_TRAPPED
                  Śledzony potomek został złapany.

           CLD_STOPPED
                  Proces potomny został zatrzymany.

           CLD_CONTINUED (od Linuksa 2.6.9)
                  Zatrzymany proces potomny został wznowiony.

       Następujące wartości mogą zostać umieszczone w si_code sygnału SIGIO/SIGPOLL:

           POLL_IN
                  Dostępne dane na wejściu.

           POLL_OUT
                  Dostępne bufory wyjścia.

           POLL_MSG
                  Dostępna wiadomość na wejściu.

           POLL_ERR
                  Błąd wejścia/wyjścia.

           POLL_PRI
                  Dostępne wejście o wysokim priorytecie.

           POLL_HUP
                  Urządzenie odłączone.

       Następująca wartość może zostać umieszczona w si_code sygnału SIGSYS:

           SYS_SECCOMP (od Linuksa 3.5)
                  Wyzwolone przez regułę filtra seccomp(2).

   Dynamically probing for flag bit support
       The sigaction()  call on Linux accepts unknown bits set in  act->sa_flags  without  error.
       The  behavior  of  the  kernel starting with Linux 5.11 is that a second sigaction()  will
       clear unknown bits from oldact->sa_flags.  However,  historically,  a  second  sigaction()
       call would typically leave those bits set in oldact->sa_flags.

       This  means  that support for new flags cannot be detected simply by testing for a flag in
       sa_flags, and a program must test that SA_UNSUPPORTED has been cleared before  relying  on
       the contents of sa_flags.

       Since  the behavior of the signal handler cannot be guaranteed unless the check passes, it
       is wise to either block the affected signal while registering the handler  and  performing
       the  check  in  this  case,  or  where  this is not possible, for example if the signal is
       synchronous, to issue the second sigaction()  in the signal handler itself.

       In kernels that do not support a specific flag, the kernel's behavior is as  if  the  flag
       was not set, even if the flag was set in act->sa_flags.

       The  flags  SA_NOCLDSTOP,  SA_NOCLDWAIT,  SA_SIGINFO,  SA_ONSTACK, SA_RESTART, SA_NODEFER,
       SA_RESETHAND, and, if defined by the architecture, SA_RESTORER may not be reliably  probed
       for  using  this  mechanism,  because they were introduced before Linux 5.11.  However, in
       general, programs may assume that these flags are supported,  since  they  have  all  been
       supported since Linux 2.6, which was released in the year 2003.

       See EXAMPLES below for a demonstration of the use of SA_UNSUPPORTED.

WARTOŚĆ ZWRACANA

       sigaction()  w przypadku powodzenia zwraca 0. W razie wystąpienia błędu zwracane jest -1 i
       ustawiana jest zmienna errno wskazując na błąd.

BŁĘDY

       EFAULT act lub oldact wskazują na pamięć poza przestrzenią adresową procesu.

       EINVAL Podano nieprawidłowy sygnał. Będzie to też generowane w przypadku próby  zmienienia
              akcji  dla  sygnałów  SIGKILL  lub  SIGSTOP,  które  nie  mogą być przechwycone lub
              zignorowane.

STANDARDY

       POSIX.1-2001, POSIX.1-2008, SVr4.

UWAGI

       Dziecko utworzone przez fork(2) dziedziczy kopię ustawień  sygnałów  od  swojego  rodzica.
       Podczas  wywołania  execve(2)  przywracane  są  wartości  domyślne  ustawień,  z wyjątkiem
       ustawienia ignorowania sygnału, które nie jest zmieniane.

       Zgodnie z POSIX, zachowanie procesu po zignorowaniu sygnału SIGFPE,  SIGILL  lub  SIGSEGV,
       niewygenerowanego  przez  kill(2)  lub  raise(3),  jest  niezdefiniowane. Dzielenie liczby
       całkowitej przez zero ma wynik  niezdefiniowany.  Na  niektórych  architekturach  generuje
       sygnał  SIGFPE  (Także  dzielenie  najmniejszej  ujemnej  liczby  całkowitej przez -1 może
       wygenerować SIGFPE). Ignorowanie go może prowadzić do nieskończonej pętli.

       POSIX.1-1990 zabraniał ustawiania akcji dla SIGCHLD na SIG_IGN. POSIX.1-2001 i  późniejsze
       pozwalają  na  to,  tak  że  można  użyć  ignorowania  SIGCHLD,  żeby  zapobiec  tworzeniu
       procesów-duchów (patrz wait(2)). Niemniej jednak, historyczne zachowanie  systemów  BSD  i
       System V  w  zakresie  ignorowania SIGCHLD jest inne, tak więc jedyną całkowicie przenośną
       metodą  zapewnienia,  że  potomek  po  zakończeniu  nie  zostanie   procesem-duchem   jest
       przechwytywanie sygnału SIGCHLD i wywołanie funkcji wait(2) lub podobnej.

       POSIX.1-1990   określał   tylko   SA_NOCLDSTOP.   W   POSIX.1-2001   dodano  SA_NOCLDSTOP,
       SA_NOCLDWAIT, SA_NODEFER, SA_ONSTACK, SA_RESETHAND, SA_RESTART oraz  SA_SIGINFO.  Używanie
       tych  nowych  wartości  sa_flags  może być mniej przenośne w aplikacjach przewidzianych do
       użycia w starszych implementacjach Uniksa.

       Flaga SA_RESETHAND jest kompatybilna z flagą w SVr4 o tej samej nazwie.

       The SA_NODEFER flag is compatible with the SVr4 flag of the same name under kernels  1.3.9
       and  later.   On older kernels the Linux implementation allowed the receipt of any signal,
       not just the one we are installing (effectively overriding any sa_mask settings).

       sigaction() może być wywoływany z drugim argumentem  o  wartości  NULL,  powodując  w  ten
       sposób  zapytanie  o  bieżący  handler  sygnału. Może go też użyć do sprawdzenia, czy dany
       sygnał jest prawidłowy na obecnej maszynie. W tym celu należy zarówno drugi, jak i  trzeci
       argument ustawić na NULL.

       Nie  można  zablokować  sygnałów  SIGKILL lub SIGSTOP (przez podanie ich w sa_mask). Próby
       takie zostaną zignorowane.

       Zobacz sigsetops(3)  dla szczegółów o operacjach na zbiorach sygnałów.

       Listę funkcji, które można bezpiecznie wywołać w procedurze obsługi sygnału, można znaleźć
       w podręczniku signal-safety(7).

   Różnice biblioteki C/jądra
       Funkcja opakowująca glibc dla sigaction() daje błąd (EINVAL) przy próbie zmiany dyspozycji
       dwóch sygnałów czasu rzeczywistego używanych wewnętrznie przez implementację wątkową NPTL.
       Więcej szczegółów w podręczniku nptl(7).

       On  architectures  where the signal trampoline resides in the C library, the glibc wrapper
       function for sigaction()  places the address of the trampoline code in the act.sa_restorer
       field and sets the SA_RESTORER flag in the act.sa_flags field.  See sigreturn(2).

       Oryginalne  linuksowe  wywołanie  systemowe nazywało się sigaction(). Jednak po pojawieniu
       się sygnałów czasu rzeczywistego w Linuksie 2.2, 32-bitowy typ sigset_t o stałym rozmiarze
       obsługiwany przez to wywołanie przestał dobrze służyć swemu zadaniu. Z tego powodu, w celu
       obsługi powiększonego typu sigset_t dodano nowe wywołanie systemowe  rt_sigaction().  Nowe
       wywołanie  przyjmuje  czwarty  argument size_t sigsetsize, który określa rozmiar w bajtach
       zestawu sygnałów w act.sa_mask i oldact.sa_mask. Argument ten obecnie  musi  mieć  wartość
       sizeof(sigset_t) (albo nastąpi błąd EINVAL). Opakowanie glibc sigaction() ukrywa te detale
       przed nami, po cichu wywołując rt_sigaction() jeśli udostępnia je jądro.

   Nieudokumentowane
       Before the introduction of SA_SIGINFO,  it  was  also  possible  to  get  some  additional
       information  about  the  signal.   This was done by providing an sa_handler signal handler
       with a second argument of type struct sigcontext, which is the same structure as  the  one
       that  is  passed  in the uc_mcontext field of the ucontext structure that is passed (via a
       pointer) in the third argument of the sa_sigaction handler.  See the relevant Linux kernel
       sources for details.  This use is obsolete now.

BŁĘDY

       When  delivering  a  signal  with a SA_SIGINFO handler, the kernel does not always provide
       meaningful values for all of the fields of  the  siginfo_t  that  are  relevant  for  that
       signal.

       Up  to and including Linux 2.6.13, specifying SA_NODEFER in sa_flags prevents not only the
       delivered signal from being masked during execution of the handler, but also  the  signals
       specified in sa_mask.  This bug was fixed in Linux 2.6.14.

PRZYKŁADY

       Patrz mprotect(2).

   Probing for flag support
       The  following  example  program  exits  with  status EXIT_SUCCESS if SA_EXPOSE_TAGBITS is
       determined to be supported, and EXIT_FAILURE otherwise.

       #include <signal.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <unistd.h>

       void
       handler(int signo, siginfo_t *info, void *context)
       {
           struct sigaction oldact;

           if (sigaction(SIGSEGV, NULL, &oldact) == -1
               || (oldact.sa_flags & SA_UNSUPPORTED)
               || !(oldact.sa_flags & SA_EXPOSE_TAGBITS))
           {
               _exit(EXIT_FAILURE);
           }
           _exit(EXIT_SUCCESS);
       }

       int
       main(void)
       {
           struct sigaction act = { 0 };

           act.sa_flags = SA_SIGINFO | SA_UNSUPPORTED | SA_EXPOSE_TAGBITS;
           act.sa_sigaction = &handler;
           if (sigaction(SIGSEGV, &act, NULL) == -1) {
               perror("sigaction");
               exit(EXIT_FAILURE);
           }

           raise(SIGSEGV);
       }

ZOBACZ TAKŻE

       kill(1),  kill(2),   pause(2),   pidfd_send_signal(2),   restart_syscall(2),   seccomp(2),
       sigaltstack(2),   signal(2),  signalfd(2),  sigpending(2),  sigprocmask(2),  sigreturn(2),
       sigsuspend(2), wait(2), killpg(3), raise(3), siginterrupt(3),  sigqueue(3),  sigsetops(3),
       sigvec(3), core(5), signal(7)

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony  podręcznika  są:  Przemek  Borys
       <pborys@dione.ids.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⟩.