Debian Codegraph @

doc/SystemTap_Tapset_Reference/man3/probe::signal.send.return.3stap

raw
1 '\" t
2 .\" Title: probe::signal.send.return
3 .\" Author:
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: October 2025
6 .\" Manual: Signal Tapset
7 .\" Source: SystemTap Tapset Reference
8 .\" Language: English
9 .\"
10 .TH "PROBE::SIGNAL\&.SEND" "3stap" "October 2025" "SystemTap Tapset Reference" "Signal Tapset"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 probe::signal.send.return \- Signal being sent to a process completed (deprecated in SystemTap 2\&.1)
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 signal\&.send\&.return
36 .fi
37 .SH "VALUES"
38 .PP
39 \fIshared\fR
40 .RS 4
41 Indicates whether the sent signal is shared by the thread group\&.
42 .RE
43 .PP
44 \fIretstr\fR
45 .RS 4
46 The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue
47 .RE
48 .PP
49 \fIsend2queue\fR
50 .RS 4
51 Indicates whether the sent signal was sent to an existing sigqueue
52 .RE
53 .PP
54 \fIname\fR
55 .RS 4
56 The name of the function used to send out the signal
57 .RE
58 .SH "CONTEXT"
59 .PP
60 The signal\*(Aqs sender\&. (correct?)
61 .SH "DESCRIPTION"
62 .PP
63 Possible __group_send_sig_info and specific_send_sig_info return values are as follows;
64 .PP
65 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\&.
66 .PP
67 \-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
68 \fBkill\fR\&.
69 .PP
70 Possible send_group_sigqueue and send_sigqueue return values are as follows;
71 .PP
72 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)\&.
73 .PP
74 1 \-\- The signal was ignored by the receiving process\&.
75 .PP
76 \-1 \-\- (send_sigqueue only) The task was marked exiting, allowing * posix_timer_event to redirect it to the group leader\&.
77 .SH SEE ALSO\n
78 .IR tapset::signal (3stap)