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

# kdump(1)

`kdump` — 显示内核跟踪数据

## 名称

`kdump`

## 概要

`kdump [-dEnlHRSsTA] [-f trfile] [-m maxdata] [-p pid] [-t trstr]`

## 描述

`kdump` 命令以易读格式显示由 [ktrace(1)](/man1/ktrace.1.md) 生成的内核跟踪文件。默认显示当前目录下的 `ktrace.out` 文件。

选项如下：

**`-A`** 显示被跟踪进程的 ABI。

**`-c`** 在每个跟踪条目中显示 CPU 编号。

**`-d`** 以十进制显示所有数字。

**`-E`** 显示经过的时间戳（从跟踪开始的时间）。

**`-f`** `trfile` 显示指定文件而非 `ktrace.out`。

**`-H`** 在每个跟踪记录中列出线程的线程 ID（tid）（如果可用）。如果没有可用的线程 ID，则打印 0。

**`-l`** 循环读取跟踪文件，到达文件末尾后等待更多数据。

**`-m`** `maxdata` 解码 I/O 时最多显示 `maxdata` 字节。

**`-n`** 抑制临时翻译。通常 `kdump` 会尝试将许多系统调用解码为更易读的格式。例如，ioctl(2) 值会被替换为宏名，`errno` 值会被替换为 strerror(3) 字符串。抑制此功能会产生更一致的输出格式，便于进一步处理。

**`-p`** `pid` 仅显示与进程或线程 `pid` 对应的跟踪事件。当同一个跟踪文件中记录了多个进程或线程时，这可能很有用。

**`-R`** 显示相对时间戳（距离前一条目的时间）。

**`-r`** 解码 STRU 记录时，以符号形式而非数字形式显示结构成员，如 UID、GID、日期等。

**`-S`** 显示系统调用号。

**`-s`** 抑制 I/O 数据的显示。

**`-T`** 为每个条目显示绝对时间戳（自纪元起的秒数）。

**`-t`** `trstr` 参见 [ktrace(1)](/man1/ktrace.1.md) 的 `-t` 选项。

`kdump` 的输出格式是面向行的，包含多个字段。下面的示例展示了由以下命令生成的 kdump 片段：

```sh
?> ktrace echo "ktrace"
?> kdump
 85045 echo     CALL  writev(0x1,0x804b030,0x2)
 85045 echo     GIO   fd 1 wrote 7 bytes
       "ktrace
       "
 85045 echo     RET   writev 7
```

第一个字段是被跟踪进程的 PID。第二个字段是被跟踪程序的名称。第三个字段是内核代表进程执行的操作。如果正在打印线程 ID，则在 PID 字段和程序名字段之间会添加一个额外的线程 ID 列。

在上面的第一行中，内核代表进程执行 writev(2) 系统调用，所以这是一个 `CALL` 操作。第四个字段显示了执行的系统调用及其参数。writev(2) 系统调用接受一个文件描述符（这里是 1，即标准输出），然后是一个指向要写入的 iovector 的指针，以及要写入的 iovector 数量。在第二行中，我们看到操作是 `GIO`（一般 I/O），文件描述符 1 写入了七个字节。接下来是写入的七个字节，即字符串 “ktrace” 加上回车符和换行符。最后一行是 `RET` 操作，显示从内核返回、从哪个系统调用返回，以及进程接收到的返回值。writev(2) 系统调用写入了七个字节，所以返回值为 7。

可能的操作包括：

| **名称** | **操作**       | **第四字段**          |
| ------ | ------------ | ----------------- |
| `CALL` | 进入系统调用       | 系统调用名和参数          |
| `RET`  | 从系统调用返回      | 系统调用名和返回值         |
| `NAMI` | 文件名查找        | 文件路径              |
| `GIO`  | 一般 I/O       | fd、读/写、字节数        |
| `PSIG` | 信号           | 信号名、处理程序、掩码、代码    |
| `CSW`  | 上下文切换        | 停止/恢复 用户/内核 wmesg |
| `USER` | 来自用户进程的数据    | 数据                |
| `STRU` | 各种系统调用       | 结构                |
| `SCTL` | sysctl(3) 请求 | MIB 名             |
| `PFLT` | 进入缺页         | 缺页地址和类型           |
| `PRET` | 从缺页返回        | 缺页结果              |

## 参见

[ktrace(1)](/man1/ktrace.1.md)

## 历史

`kdump` 命令首次出现于 4.4BSD。