此内容没有您所选择的语言版本。

9.2. Context at the probe point


The following functions provide ways to access the current task context at a probe point. Note that these may not return correct values when a probe is hit in interrupt context.

9.2.1. backtrace

General syntax:
backtrace:string ()
Returns a string of hex addresses that are a backtrace of the stack. The output is truncated to MAXSTRINGLEN.

9.2.2. caller

General syntax:
caller:string()
Returns the address and name of the calling function. It works only for return probes.

9.2.3. caller_addr

General syntax:
caller_addr:long ()
Returns the address of the calling function. It works only for return probes.

9.2.4. cpu

General syntax:
cpu:long ()
Returns the current cpu number.

9.2.5. egid

General syntax:
egid:long ()
Returns the effective group ID of the current process.

9.2.6. euid

General syntax:
euid:long ()
Returns the effective user ID of the current process.

9.2.7. execname

General syntax:
execname:string ()
Returns the name of the current process.

9.2.8. gid

General syntax:
gid:long ()
Returns the group ID of the current process.

9.2.9. is_return

General syntax:
is_return:long ()
Returns 1 if the probe point is a return probe, else it returns zero.
Deprecated.

9.2.10. pexecname

General syntax:
pexecname:string ()
Returns the name of the parent process.

9.2.11. pid

General syntax:
pid:long ()
Returns the process ID of the current process.

9.2.12. ppid

General syntax:
ppid:long ()
Returns the process ID of the parent process.

9.2.13. tid

General syntax:
tid:long ()
Returns the ID of the current thread.

9.2.14. uid

General syntax:
uid:long ()
Returns the user ID of the current task.

9.2.15. print_backtrace

General syntax:
print_backtrace:unknown ()
This function is equivalent to print_stack(backtrace()), except that deeper stack nesting is supported. The function does not return a value.

9.2.16. print_regs

General syntax:
print_regs:unknown ()
This function prints a register dump.

9.2.17. print_stack

General syntax:
print_stack:unknown (stk:string)
This function performs a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to backtrace(). It prints one line per address. Each printed line includes the address, the name of the function containing the address, and an estimate of its position within that function. The function does not return a value.

9.2.18. stack_size

General syntax:
stack_size:long ()
Returns the size of the stack.

9.2.19. stack_unused

General syntax:
stack_unused:long ()
Returns how many bytes are currently unused in the stack.

9.2.20. stack_used

General syntax:
stack_used:long ()
Returns how many bytes are currently used in the stack.

9.2.21. stp_pid

stp_pid:long ()
Returns the process ID of the of the staprun process.

9.2.22. target

General syntax:
target:long ()
Returns the process ID of the target process. This is useful in conjunction with the -x PID or -c CMD command-line options to stap. An example of its use is to create scripts that filter on a specific process.
-x <pid>
target() returns the pid specified by -x
-c <command>
target() returns the pid for the executed command specified by -c.
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.