1TAPSET::CONTEXT(3stap) TAPSET::CONTEXT(3stap)
2
3
4
6 tapset::context - systemtap context tapset
7
8
10 Context functions provide additional information about where an event
11 occurred. These functions can provide information such as a backtrace
12 to where the event occurred and the current register values for the
13 processor.
14
15
16
17 print_regs
18 Print a register dump
19
20 See function::print_regs(3stap)
21 for details.
22
23 pp Returns the active probe point
24
25 See function::pp(3stap)
26 for details.
27
28 ppfunc Returns the function name parsed from pp()
29
30 See function::ppfunc(3stap)
31 for details.
32
33 probe_type
34 The low level probe handler type of the current probe.
35
36 See function::probe_type(3stap)
37 for details.
38
39 execname
40 Returns the execname of a target process (or group of processes)
41
42 See function::execname(3stap)
43 for details.
44
45 pexecname
46 Returns the execname of a target process's parent process
47
48 See function::pexecname(3stap)
49 for details.
50
51 pid Returns the ID of a target process
52
53 See function::pid(3stap)
54 for details.
55
56 ns_pid Returns the ID of a target process as seen in a pid namespace
57
58 See function::ns_pid(3stap)
59 for details.
60
61 tid Returns the thread ID of a target process
62
63 See function::tid(3stap)
64 for details.
65
66 ns_tid Returns the thread ID of a target process as seen in a pid name‐
67 space
68
69 See function::ns_tid(3stap)
70 for details.
71
72 ppid Returns the process ID of a target process's parent process
73
74 See function::ppid(3stap)
75 for details.
76
77 ns_ppid
78 Returns the process ID of a target process's parent process as
79 seen in a pid namespace
80
81 See function::ns_ppid(3stap)
82 for details.
83
84 pgrp Returns the process group ID of the current process
85
86 See function::pgrp(3stap)
87 for details.
88
89 ns_pgrp
90 Returns the process group ID of the current process as seen in a
91 pid namespace
92
93 See function::ns_pgrp(3stap)
94 for details.
95
96 sid Returns the session ID of the current process
97
98 See function::sid(3stap)
99 for details.
100
101 ns_sid Returns the session ID of the current process as seen in a pid
102 namespace
103
104 See function::ns_sid(3stap)
105 for details.
106
107 gid Returns the group ID of a target process
108
109 See function::gid(3stap)
110 for details.
111
112 ns_gid Returns the group ID of a target process as seen in a user name‐
113 space
114
115 See function::ns_gid(3stap)
116 for details.
117
118 egid Returns the effective gid of a target process
119
120 See function::egid(3stap)
121 for details.
122
123 ns_egid
124 Returns the effective gid of a target process as seen in a user
125 namespace
126
127 See function::ns_egid(3stap)
128 for details.
129
130 uid Returns the user ID of a target process
131
132 See function::uid(3stap)
133 for details.
134
135 ns_uid Returns the user ID of a target process as seen in a user name‐
136 space
137
138 See function::ns_uid(3stap)
139 for details.
140
141 euid Return the effective uid of a target process
142
143 See function::euid(3stap)
144 for details.
145
146 ns_euid
147 Returns the effective user ID of a target process as seen in a
148 user namespace
149
150 See function::ns_euid(3stap)
151 for details.
152
153 is_myproc
154 Determines if the current probe point has occurred in the user's
155 own process
156
157 See function::is_myproc(3stap)
158 for details.
159
160 cpuid Returns the current cpu number
161
162 See function::cpuid(3stap)
163 for details.
164
165 cpu Returns the current cpu number
166
167 See function::cpu(3stap)
168 for details.
169
170 registers_valid
171 Determines validity of register() and u_register() in current
172 context
173
174 See function::registers_valid(3stap)
175 for details.
176
177 user_mode
178 Determines if probe point occurs in user-mode
179
180 See function::user_mode(3stap)
181 for details.
182
183 is_return
184 Whether the current probe context is a return probe
185
186 See function::is_return(3stap)
187 for details.
188
189 target Return the process ID of the target process
190
191 See function::target(3stap)
192 for details.
193
194 module_name
195 The module name of the current script
196
197 See function::module_name(3stap)
198 for details.
199
200 module_size
201 The module size of the current script
202
203 See function::module_size(3stap)
204 for details.
205
206 stp_pid
207 The process id of the stapio process
208
209 See function::stp_pid(3stap)
210 for details.
211
212 remote_id
213 The index of this instance in a remote execution.
214
215 See function::remote_id(3stap)
216 for details.
217
218 remote_uri
219 The name of this instance in a remote execution.
220
221 See function::remote_uri(3stap)
222 for details.
223
224 stack_size
225 Return the size of the kernel stack
226
227 See function::stack_size(3stap)
228 for details.
229
230 stack_used
231 Returns the amount of kernel stack used
232
233 See function::stack_used(3stap)
234 for details.
235
236 stack_unused
237 Returns the amount of kernel stack currently available
238
239 See function::stack_unused(3stap)
240 for details.
241
242 addr Address of the current probe point.
243
244 See function::addr(3stap)
245 for details.
246
247 uaddr User space address of current running task
248
249 See function::uaddr(3stap)
250 for details.
251
252 cmdline_args
253 Fetch command line arguments from current process
254
255 See function::cmdline_args(3stap)
256 for details.
257
258 cmdline_arg
259 Fetch a command line argument
260
261 See function::cmdline_arg(3stap)
262 for details.
263
264 cmdline_str
265 Fetch all command line arguments from current process
266
267 See function::cmdline_str(3stap)
268 for details.
269
270
272 function::print_regs(3stap), function::pp(3stap),
273 function::ppfunc(3stap), function::probe_type(3stap),
274 function::execname(3stap), function::pexecname(3stap),
275 function::pid(3stap), function::ns_pid(3stap), function::tid(3stap),
276 function::ns_tid(3stap), function::ppid(3stap),
277 function::ns_ppid(3stap), function::pgrp(3stap),
278 function::ns_pgrp(3stap), function::sid(3stap),
279 function::ns_sid(3stap), function::gid(3stap),
280 function::ns_gid(3stap), function::egid(3stap),
281 function::ns_egid(3stap), function::uid(3stap),
282 function::ns_uid(3stap), function::euid(3stap),
283 function::ns_euid(3stap), function::is_myproc(3stap),
284 function::cpuid(3stap), function::cpu(3stap),
285 function::registers_valid(3stap), function::user_mode(3stap),
286 function::is_return(3stap), function::target(3stap),
287 function::module_name(3stap), function::module_size(3stap),
288 function::stp_pid(3stap), function::remote_id(3stap),
289 function::remote_uri(3stap), function::stack_size(3stap),
290 function::stack_used(3stap), function::stack_unused(3stap),
291 function::addr(3stap), function::uaddr(3stap),
292 function::cmdline_args(3stap), function::cmdline_arg(3stap),
293 function::cmdline_str(3stap), stap(1), stapprobes(3stap)
294
295
296
297SystemTap Tapset Reference April 2023 TAPSET::CONTEXT(3stap)