> 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/man4/ksyms.4.md).

# ksyms(4)

`ksyms` — 内核符号表接口

## 名称

`ksyms`

## 概要

`device ksyms`

## 描述

`/dev/ksyms` 字符设备提供对内核符号表快照的只读接口。内核内符号管理器旨在能够处理多种类型的符号表，但此设备仅支持 [elf(5)](/man5/elf.5.md) 符号表。ELF 格式镜像包含两个节：一个符号表和对应的字符串表。

**`Symbol Table`** SYMTAB 节包含当前运行内核中存在的符号表条目，包括任何已加载模块的符号表条目。符号按内核模块加载时间排序，首先是内核文件符号，然后是第一个加载模块的符号，依此类推。

**`String Table`** STRTAB 节包含符号表条目引用的内核和任何已加载模块的符号名称字符串。

从 `/dev/ksyms` 文件读取的 ELF 格式符号表数据表示设备打开时内核的状态。由于 `/dev/ksyms` 没有文本或数据，大多数字段初始化为 NULL。`ksyms` 驱动不会在 `/dev/ksyms` 文件打开时阻止模块加载或卸载到内核中，但可能包含过期数据。

## 文件

**`/dev/ksyms`**

## 错误

如果出现以下情况，open(2) `/dev/ksyms` 将失败：

**\[Er** EBUSY] 设备已打开。进程必须先关闭 `/dev/ksyms` 才能再次打开。

**\[Er** ENOMEM] 内核资源不足。

**\[Er** ENXIO] 驱动无法创建内核符号表快照。如果内核正在加载或卸载模块，可能会发生此情况。

## 参见

nlist(3), [elf(5)](/man5/elf.5.md), [kldload(8)](/man8/kldload.8.md)

## 历史

许多不同的操作系统中都存在 `ksyms` 设备。此实现的功能类似于 Solaris 和 NetBSD 的 `ksyms` 驱动。

`ksyms` 驱动最早出现于 FreeBSD 8.0，用于支持 [lockstat(1)](/man1/lockstat.1.md)。

## 作者

`ksyms` 驱动由 Stacey Son <sson@FreeBSD.org> 编写。

## 缺陷

由于文件可随时动态链接到内核中，符号信息可能会变化。打开 `/dev/ksyms` 文件时，你可以访问一个 ELF 镜像，它表示该时刻内核符号信息状态的快照。保持设备打开不会阻止加载或卸载内核模块。要获取新快照，必须关闭并重新打开设备。

一个进程一次只能打开 `/dev/ksyms` 文件一次。进程必须先关闭 `/dev/ksyms` 才能再次打开。