table of contents
other versions
- wheezy 1.7-1+deb7u1
- jessie 2.6-0.2
- jessie-backports 3.0-6~bpo8+1
- testing 3.1-2
- unstable 3.1-2
TAPSET::SIGNAL(3stap) | TAPSET::SIGNAL(3stap) |
NAME¶
tapset::signal - systemtap signal probe pointsDESCRIPTION¶
This family of probe points is used to probe signal activities. It contains the following probe points:- signal.send
-
signal number
a string representation of the signal
pid of the signal recipient process
name of the signal recipient process
indicates the signal type
a task handle to the signal recipient
the address of siginfo struct
indicates whether this signal is shared by the thread group
indicates whether this signal is sent to an existing sigqueue
name of the function used to send out this signal
- signal.send.return
-
the return value
Return values for "__group_send_sig_info" and "specific_send_sig_info"
- return 0 if the signal is successfully sent
to a process, which means the following:
<1> the signal is ignored by receiving process
<2> this is a non-RT signal and we already have one queued
<3> the signal is successfully added into the sigqueue of receiving
process
- return -EAGAIN if the sigqueue is overflow the signal was RT and sent by user
using something other than kill()
Return values for "send_group_sigqueue"
- return 0 if the signal is either
successfully added into the sigqueue of receiving process or a SI_TIMER entry
is already queued so just increment the overrun count
- return 1 if this signal is ignored by receiving process
Return values for "send_sigqueue"
- return 0 if the signal is either
successfully added into the sigqueue of receiving process or a SI_TIMER entry
is already queued so just increment the overrun count
- return 1 if this signal is ignored by receiving process
- return -1 if the task is marked exiting, so posix_timer_event can redirect it
to the group leader
indicates whether this signal is shared by the thread group
indicates whether this signal is sent to an existing sigqueue
name of the function used to send out this signal
- signal.checkperm
-
the number of the signal
a string representation of the signal
pid of the signal recipient process
name of the signal recipient process
indicates the signal type
a task handle to the signal recipient
the address of siginfo struct
name of the probe point, is set to "signal.checkperm"
- signal.checkperm.return
-
the return value
name of the probe point, is set to "signal.checkperm"
- signal.wakeup
-
pid of the process to be woke up
name of the process to be woke up
indicate whether to wake up a task in STOPPED or TRACED state
a string representation indicate the mask of task states that can be woken. Possible values are (TASK_INTERRUPTIBLE|TASK_STOPPED|TASK_TRACED) and TASK_INTERRUPTIBLE.
- signal.check_ignored
-
pid of the signal recipient process
name of the signal recipient process
the signal to be checked
name of the signal
- signal.check_ignored.return
-
return value. 0 indicate the current signal isn't ignored.
- signal.force_segv
-
pid of the signal recipient process
name of the signal recipient process
the signal being handled
name of this signal
- signal.force_segv.return
-
return value. Always return 0
- signal.syskill
-
pid of the recipient process
the signal to be sent
- signal.syskill.return
-
- signal.tgkill
-
pid of the recipient thread
thread group id which the target thread should have
the signal to be sent
- signal.tgkill.return
-
- signal.tkill
-
pid of the recipient process
the signal to be sent
- signal.tkill.return
-
- signal.send_sig_queue
-
the signal to be queued
name of this signal
pid of the process to which the signal is queued
name of the process to which the signal is queued
address of the signal queue
- signal.send_sig_queue.return
-
return value
- signal.pending
-
address of user space sigset_t
sigset size
- signal.pending.return
-
return value
- signal.handle
-
signal number
signal name
address of siginfo struct
the si_code of siginfo
Address of the k_sigaction struct associated with the signal
Address of a bit mask array of blocked signals
indicates whether the signal is a User Mode or Kernel mode Signal
- signal.handle.return
-
return value of handle_signal()
- signal.do_action
-
signal number
address of the new sigaction struct associated with the signal
address of a previous sigaction struct associated with the signal
the new handler of the signal
the new mask of the signal
- signal.do_action.return
-
return value of do_sigaction()
- signal.procmask
-
indicates how to change the blocked signals.
Possible values are:
SIG_BLOCK=0 for blocking signals
SIG_UNBLOCK=1 for unblocking signals
SIG_SETMASK=2 for setting the signal mask
address of sigset_t to be set
address of the old sigset_t
the actual sigset to be set
- signal.procmask.return
-
return value of sigprocmask()
- signal.flush
-
the task handler of the process
pid of the task
name of the task
SEE ALSO¶
stap(1), stapprobes(3stap)IBM |