probe::signal.send.return(3stap) — Linux manual page

NAME | SYNOPSIS | VALUES | CONTEXT | DESCRIPTION | SEE ALSO | COLOPHON

PROBE::SIGNAL.SEND(3stap)     Signal Tapset    PROBE::SIGNAL.SEND(3stap)

NAME         top

       probe::signal.send.return - Signal being sent to a process
       completed (deprecated in SystemTap 2.1)

SYNOPSIS         top

       signal.send.return

VALUES         top

       shared
           Indicates whether the sent signal is shared by the thread
           group.

       send2queue
           Indicates whether the sent signal was sent to an existing
           sigqueue

       retstr
           The return value to either __group_send_sig_info,
           specific_send_sig_info, or send_sigqueue

       name
           The name of the function used to send out the signal

CONTEXT         top

       The signal's sender. (correct?)

DESCRIPTION         top

       Possible __group_send_sig_info and specific_send_sig_info return
       values are as follows;

       0 -- The signal is successfully sent to a process, which means
       that, (1) the signal was ignored by the receiving process, (2)
       this is a non-RT signal and the system already has one queued,
       and (3) the signal was successfully added to the sigqueue of the
       receiving process.

       -EAGAIN -- The sigqueue of the receiving process is overflowing,
       the signal was RT, and the signal was sent by a user using
       something other than kill.

       Possible send_group_sigqueue and send_sigqueue return values are
       as follows;

       0 -- The signal was either successfully added into the sigqueue
       of the receiving process, or a SI_TIMER entry is already queued
       (in which case, the overrun count will be simply incremented).

       1 -- The signal was ignored by the receiving process.

       -1 -- (send_sigqueue only) The task was marked exiting, allowing
       * posix_timer_event to redirect it to the group leader.

SEE ALSO         top

       tapset::signal(3stap)

COLOPHON         top

       This page is part of the systemtap (a tracing and live-system
       analysis tool) project.  Information about the project can be
       found at ⟨https://sourceware.org/systemtap/⟩.  If you have a bug
       report for this manual page, send it to [email protected].
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/systemtap.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-13.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

SystemTap Tapset Reference     April 2024      PROBE::SIGNAL.SEND(3stap)

Pages that refer to this page: tapset::signal(3stap)