> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man4/dtrace_proc.4.md).

# dtrace\_proc.4

`dtrace_proc` — 用于跟踪用户进程相关事件的 DTrace 提供者

## 名称

`dtrace_proc`

## 概要

`Fn proc:::create struct proc * struct proc * int Fn proc:::exec char * Fn proc:::exec-failure int Fn proc:::exec-success char * Fn proc:::exit int Fn proc:::signal-clear int ksiginfo_t * Fn proc:::signal-discard struct thread * struct proc * int Fn proc:::signal-send struct thread * struct proc * int`

## 描述

DTrace `proc` 提供者可洞察与用户进程相关的事件：进程和线程的创建与终止事件，以及进程信号。

Fn proc:::create 探测在通过 fork(2)、vfork(2)、pdfork(2) 或 rfork(2) 系统调用创建用户进程时触发。特别是，使用 [kproc(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man9/kproc.9.md) KPI 创建的内核进程不会触发此探测。Fn proc:::create 探测的前两个参数分别是新的子进程及其父进程。第三个参数是 rfork(2) 标志的掩码，指示哪些进程资源在父进程和子进程之间共享。

Fn proc:::exec 探测在进程尝试执行文件时触发。其参数是指定的文件名。如果尝试因错误而失败，Fn proc:::exec-failure 探测将随后触发，在其第一个参数中提供相应的 errno(2) 值。否则，Fn proc:::exec-success 探测将触发。

Fn proc:::exit 探测在进程退出或被终止时触发。其参数是相应的 `SIGCHLD` 信号代码；有效值记录在 [siginfo(3)](/man/misc/siginfo.3.md) 手册页中并定义在 `signal.h` 中。例如，当进程正常退出时，`args[0]` 的值将为 `CLD_EXITED`。

Fn proc:::signal-send 探测在即将向进程发送信号时触发。Fn proc:::signal-discard 探测在向忽略该信号的进程发送信号时触发。此探测将在相关信号的 Fn proc:::signal-send 探测之后触发。这些探测的参数是将接收信号的线程和进程，以及信号的编号。有效信号编号定义在 signal(3) 手册页中。Fn proc:::signal-clear 探测在挂起信号已被 sigwait(2)、sigtimedwait(2) 或 sigwaitinfo(2) 系统调用之一清除时触发。其参数是已清除信号的编号，以及指向相应信号信息的指针。信号的 `siginfo_t` 可从 `args[1]->ksi_info` 获取。

## 参数

虽然 `proc` 提供者探测使用原生 FreeBSD 参数类型，但进程和线程的标准 D 类型可用。分别是 `psinfo_t` 和 `lwpsinfo_t`，定义在 **/usr/lib/dtrace/psinfo.d** 中。此文件还定义了两个全局变量 `curpsinfo` 和 `curlwpsinfo`，它们使用这些类型提供当前进程和线程的表示。

`psinfo_t` 的字段为：

**`int pr_nlwp`** 进程中的线程数。

**`pid_t pr_pid`** 进程 ID。

**`pid_t pr_ppid`** 父进程的进程 ID，如果进程没有父进程则为 0。

**`pid_t pr_pgid`** 进程组领导者的进程 ID。

**`pid_t pr_sid`** 会话 ID，如果进程不属于任何会话则为 0。

**`pid_t pr_uid`** 实际用户 ID。

**`pid_t pr_euid`** 有效用户 ID。

**`pid_t pr_gid`** 实际组 ID。

**`pid_t pr_egid`** 有效组 ID。

**`uintptr_t pr_addr`** 指向进程的 `struct proc` 的指针。

**`string pr_psargs`** 进程参数。

**`u_int pr_arglen`** 进程参数字符串的长度。

**`u_int pr_jailid`** 进程的 Jail ID。

`lwpsinfo_t` 的字段为：

**`id_t pr_lwpid`** 线程 ID。

**`int pr_flag`** 线程标志。

**`int pr_pri`** 线程的实际调度优先级。

**`char pr_state`** 当前始终为 0。

**`char pr_sname`** 当前始终为 `?`。

**`short pr_syscall`** 当前始终为 0。

**`uintptr_t pr_addr`** 指向线程的 `struct thread` 的指针。

**`uintptr_t pr_wchan`** 线程正在其上睡眠的当前等待地址。

## 文件

**`/usr/lib/dtrace/psinfo.d`** `proc` 提供者的 DTrace 类型和转换器定义。

## 实例

以下脚本在进程执行事件发生时记录：

```sh
#pragma D option quiet
proc:::exec-success
{
        printf("%s", curpsinfo->pr_psargs);
}
```

注意，`pr_psargs` 字段受 `kern.ps_arg_cache_limit` sysctl 定义的限制。特别是，参数列表长于此 sysctl 定义的值的进程无法以这种方式记录。

## 兼容性

FreeBSD 中的 `proc` 提供者与 Solaris 中的 `proc` 提供者不兼容。特别是，FreeBSD 使用原生 `struct proc` 和 `struct thread` 类型作为探测参数，而非转换后的类型。此外，Solaris 中的许多 `proc` 提供者探测目前在 FreeBSD 上不可用。

## 参见

[dtrace(1)](/man/man1/dtrace.1.md), errno(2), fork(2), pdfork(2), rfork(2), vfork(2), [siginfo(3)](/man/misc/siginfo.3.md), signal(3), [dtrace\_sched(4)](/man/man4/dtrace_sched.4.md), [kproc(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man9/kproc.9.md)

## 历史

`proc` 提供者首次出现于 FreeBSD 7.1。

## 作者

本手册页由 Mark Johnston <markj@FreeBSD.org> 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man4/dtrace_proc.4.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.