Debian Codegraph @

doc/SystemTap_Tapset_Reference/man_pages/tapset::signal.3stap

raw
1 .\" -*- nroff -*-
2 .TH TAPSET::SIGNAL 3stap "October 2025" "SystemTap Tapset Reference"
3 .SH NAME
4 tapset::signal \- systemtap signal tapset
5
6 .SH DESCRIPTION
7
8 This family of probe points is used to probe signal activities.
9 Since there are so many signals sent to processes at any given
10 point, it is advisable to filter the information according to the
11 requirements. For example, filter only for a particular signal
12 (if sig==2) or for a particular process (if pid_name==stap).
13
14 .TP
15 .P
16 .TP
17 .B signal.send
18 Signal being sent to a process
19 .IP
20 See
21 .IR probe::signal.send (3stap)
22 for details.
23 .P
24 .TP
25 .B signal.send.return
26 Signal being sent to a process completed (deprecated in SystemTap 2.1)
27 .IP
28 See
29 .IR probe::signal.send.return (3stap)
30 for details.
31 .P
32 .TP
33 .B signal.checkperm
34 Check being performed on a sent signal
35 .IP
36 See
37 .IR probe::signal.checkperm (3stap)
38 for details.
39 .P
40 .TP
41 .B signal.checkperm.return
42 Check performed on a sent signal completed
43 .IP
44 See
45 .IR probe::signal.checkperm.return (3stap)
46 for details.
47 .P
48 .TP
49 .B signal.wakeup
50 Sleeping process being wakened for signal
51 .IP
52 See
53 .IR probe::signal.wakeup (3stap)
54 for details.
55 .P
56 .TP
57 .B signal.check_ignored
58 Checking to see signal is ignored
59 .IP
60 See
61 .IR probe::signal.check_ignored (3stap)
62 for details.
63 .P
64 .TP
65 .B signal.check_ignored.return
66 Check to see signal is ignored completed
67 .IP
68 See
69 .IR probe::signal.check_ignored.return (3stap)
70 for details.
71 .P
72 .TP
73 .B signal.force_segv
74 Forcing send of SIGSEGV
75 .IP
76 See
77 .IR probe::signal.force_segv (3stap)
78 for details.
79 .P
80 .TP
81 .B signal.force_segv.return
82 Forcing send of SIGSEGV complete
83 .IP
84 See
85 .IR probe::signal.force_segv.return (3stap)
86 for details.
87 .P
88 .TP
89 .B signal.syskill
90 Sending kill signal to a process
91 .IP
92 See
93 .IR probe::signal.syskill (3stap)
94 for details.
95 .P
96 .TP
97 .B signal.syskill.return
98 Sending kill signal completed
99 .IP
100 See
101 .IR probe::signal.syskill.return (3stap)
102 for details.
103 .P
104 .TP
105 .B signal.sys_tkill
106 Sending a kill signal to a thread
107 .IP
108 See
109 .IR probe::signal.sys_tkill (3stap)
110 for details.
111 .P
112 .TP
113 .B signal.systkill.return
114 Sending kill signal to a thread completed
115 .IP
116 See
117 .IR probe::signal.systkill.return (3stap)
118 for details.
119 .P
120 .TP
121 .B signal.sys_tgkill
122 Sending kill signal to a thread group
123 .IP
124 See
125 .IR probe::signal.sys_tgkill (3stap)
126 for details.
127 .P
128 .TP
129 .B signal.sys_tgkill.return
130 Sending kill signal to a thread group completed
131 .IP
132 See
133 .IR probe::signal.sys_tgkill.return (3stap)
134 for details.
135 .P
136 .TP
137 .B signal.send_sig_queue
138 Queuing a signal to a process
139 .IP
140 See
141 .IR probe::signal.send_sig_queue (3stap)
142 for details.
143 .P
144 .TP
145 .B signal.send_sig_queue.return
146 Queuing a signal to a process completed
147 .IP
148 See
149 .IR probe::signal.send_sig_queue.return (3stap)
150 for details.
151 .P
152 .TP
153 .B signal.pending
154 Examining pending signal
155 .IP
156 See
157 .IR probe::signal.pending (3stap)
158 for details.
159 .P
160 .TP
161 .B signal.pending.return
162 Examination of pending signal completed
163 .IP
164 See
165 .IR probe::signal.pending.return (3stap)
166 for details.
167 .P
168 .TP
169 .B signal.handle
170 Signal handler being invoked
171 .IP
172 See
173 .IR probe::signal.handle (3stap)
174 for details.
175 .P
176 .TP
177 .B signal.handle.return
178 Signal handler invocation completed
179 .IP
180 See
181 .IR probe::signal.handle.return (3stap)
182 for details.
183 .P
184 .TP
185 .B signal.do_action
186 Examining or changing a signal action
187 .IP
188 See
189 .IR probe::signal.do_action (3stap)
190 for details.
191 .P
192 .TP
193 .B signal.do_action.return
194 Examining or changing a signal action completed
195 .IP
196 See
197 .IR probe::signal.do_action.return (3stap)
198 for details.
199 .P
200 .TP
201 .B signal.procmask
202 Examining or changing blocked signals
203 .IP
204 See
205 .IR probe::signal.procmask (3stap)
206 for details.
207 .P
208 .TP
209 .B signal.procmask.return
210 Examining or changing blocked signals completed
211 .IP
212 See
213 .IR probe::signal.procmask.return (3stap)
214 for details.
215 .P
216 .TP
217 .B signal.flush
218 Flushing all pending signals for a task
219 .IP
220 See
221 .IR probe::signal.flush (3stap)
222 for details.
223 .P
224 .TP
225 .B get_sa_flags
226 Returns the numeric value of sa_flags
227 .IP
228 See
229 .IR function::get_sa_flags (3stap)
230 for details.
231 .P
232 .TP
233 .B get_sa_handler
234 Returns the numeric value of sa_handler
235 .IP
236 See
237 .IR function::get_sa_handler (3stap)
238 for details.
239 .P
240 .TP
241 .B sigset_mask_str
242 Returns the string representation of a sigset
243 .IP
244 See
245 .IR function::sigset_mask_str (3stap)
246 for details.
247 .P
248 .TP
249 .B is_sig_blocked
250 Returns 1 if the signal is currently blocked, or 0 if it is not
251 .IP
252 See
253 .IR function::is_sig_blocked (3stap)
254 for details.
255 .P
256 .TP
257 .B sa_flags_str
258 Returns the string representation of sa_flags
259 .IP
260 See
261 .IR function::sa_flags_str (3stap)
262 for details.
263 .P
264 .TP
265 .B sa_handler
266 Returns the string representation of an sa_handler
267 .IP
268 See
269 .IR function::sa_handler (3stap)
270 for details.
271 .P
272 .TP
273 .B signal_str
274 Returns the string representation of a signal number
275 .IP
276 See
277 .IR function::signal_str (3stap)
278 for details.
279
280 .SH SEE ALSO
281 .BR
282 .IR \%function::get_sa_flags (3stap),
283 .BR
284 .IR \%function::get_sa_handler (3stap),
285 .BR
286 .IR \%function::sigset_mask_str (3stap),
287 .BR
288 .IR \%function::is_sig_blocked (3stap),
289 .BR
290 .IR \%function::sa_flags_str (3stap),
291 .BR
292 .IR \%function::sa_handler (3stap),
293 .BR
294 .IR \%function::signal_str (3stap),
295 .BR
296 .IR \%probe::signal.send (3stap),
297 .BR
298 .IR \%probe::signal.send.return (3stap),
299 .BR
300 .IR \%probe::signal.checkperm (3stap),
301 .BR
302 .IR \%probe::signal.checkperm.return (3stap),
303 .BR
304 .IR \%probe::signal.wakeup (3stap),
305 .BR
306 .IR \%probe::signal.check_ignored (3stap),
307 .BR
308 .IR \%probe::signal.check_ignored.return (3stap),
309 .BR
310 .IR \%probe::signal.force_segv (3stap),
311 .BR
312 .IR \%probe::signal.force_segv.return (3stap),
313 .BR
314 .IR \%probe::signal.syskill (3stap),
315 .BR
316 .IR \%probe::signal.syskill.return (3stap),
317 .BR
318 .IR \%probe::signal.sys_tkill (3stap),
319 .BR
320 .IR \%probe::signal.systkill.return (3stap),
321 .BR
322 .IR \%probe::signal.sys_tgkill (3stap),
323 .BR
324 .IR \%probe::signal.sys_tgkill.return (3stap),
325 .BR
326 .IR \%probe::signal.send_sig_queue (3stap),
327 .BR
328 .IR \%probe::signal.send_sig_queue.return (3stap),
329 .BR
330 .IR \%probe::signal.pending (3stap),
331 .BR
332 .IR \%probe::signal.pending.return (3stap),
333 .BR
334 .IR \%probe::signal.handle (3stap),
335 .BR
336 .IR \%probe::signal.handle.return (3stap),
337 .BR
338 .IR \%probe::signal.do_action (3stap),
339 .BR
340 .IR \%probe::signal.do_action.return (3stap),
341 .BR
342 .IR \%probe::signal.procmask (3stap),
343 .BR
344 .IR \%probe::signal.procmask.return (3stap),
345 .BR
346 .IR \%probe::signal.flush (3stap),
347 .BR
348 .IR \%stap (1),
349 .IR \%stapprobes (3stap)