ABI 稳定符号¶

记录开发者定义为稳定的接口。

用户空间程序可以自由使用这些接口，不受任何限制，并且这些接口的向后兼容性将至少保证 2 年。

大多数接口（如系统调用）预计永远不会改变，并且始终可用。

/dev/fw 下的符号¶

/dev/fw[0-9]+

在文件 firewire-cdev 中定义

字符设备文件 /dev/fw* 是 firewire-core 和用户空间中实现的 IEEE 1394 设备驱动程序之间的接口。基于 ioctl(2) 和 read(2) 的 ABI 在 <linux/firewire-cdev.h> 中定义和记录。

此 ABI 提供了 firewire-core 也向内核空间 IEEE 1394 驱动程序公开的大部分功能。

每个 /dev/fw* 都与一个 IEEE 1394 节点关联，该节点可以是远程节点或本地节点。对 /dev/fw* 文件的操作具有不同的范围

与文件关联的 1394 节点

异步请求传输

获取配置 ROM

查询节点 ID

查询此节点和本地节点之间路径的最大速度

节点所连接的 1394 总线（即“卡”）

同步流传输和接收

异步流传输和接收

异步广播请求传输

PHY 数据包传输和接收

在总线的 IRM 处分配、重新分配、解除分配同步资源（通道、带宽）

查询本地节点、根节点、IRM、总线管理器的节点 ID

查询周期时间

总线复位启动，总线复位事件接收

所有 1394 总线

在本地链路层上分配 IEEE 1212 地址范围，接收对此类地址范围的入站请求，异步响应入站请求

向本地节点的配置 ROM 添加描述符或目录

由于操作范围不同，并且为了让用户空间实现不同的访问权限模型，某些操作仅限于与本地节点关联的 /dev/fw* 文件

向本地节点的配置 ROM 添加描述符或目录

PHY 数据包传输和接收

在整个生命周期内，/dev/fw* 文件始终与一个特定节点关联。总线拓扑变化，以及随之而来的节点 ID 变化，由 firewire-core 跟踪。ABI 用户无需了解拓扑。

支持以下文件操作

open(2): 目前唯一有用的标志是 O_RDWR。
ioctl(2): 启动各种操作。有些立即生效，有些在 ioctl 返回时或之后异步执行。有关所有 ioctl 的描述，请参阅 <linux/firewire-cdev.h> 中的内联文档。
poll(2)、select(2)、epoll_wait(2) 等: 监视事件是否可供读取。
read(2): 接收各种事件。有像出站异步事务完成或同步缓冲区完成这样的请求事件，以及像总线复位、请求接收或 PHY 数据包接收这样的非请求事件。始终使用足够大的读取缓冲区来接收可能到达的最大事件。有关所有事件类型以及哪些 ioctl 影响事件接收的描述，请参阅 <linux/firewire-cdev.h>。
mmap(2): 为同步接收或传输分配 DMA 缓冲区，并将其映射到进程地址空间。参数应按如下方式使用：addr = NULL，length = 所需的缓冲区大小（即，数据包数量乘以最大数据包大小），prot = 接收至少为 PROT_READ，传输至少为 PROT_WRITE，flags = MAP_SHARED，fd = /dev/fw* 的句柄，offset = 0。

同步接收以每个数据包一个缓冲区的方式工作，多通道接收除外，多通道接收以缓冲区填充模式工作。

munmap(2): 从进程地址空间中解除映射同步 I/O 缓冲区。
close(2): 除了停止和释放与文件描述符关联的 I/O 上下文外，还要回滚对本地节点配置 ROM 的任何更改。解除分配在 IRM 处标记为内核辅助重新分配和解除分配的同步通道和带宽。
用户: libraw1394; libdc1394; libhinawa; linux-firewire-utils, fwhack 等工具...

/sys/accessibility 下的符号¶

/sys/accessibility/speakup/<synth-name>/

在文件 sysfs-driver-speakup 中定义

在 /sys/accessibility/speakup 中有一个与当前使用的合成器驱动程序（例如 soft 驱动程序）对应的目录。此目录包含控制语音合成器本身的文件，而不是控制 speakup 屏幕阅读器。此目录中的参数在所有支持的合成器中具有相同的名称和功能。freq、pitch、rate 和 vol 的值范围对于所有支持的合成器都是相同的，给定范围由驱动程序内部映射以或多或少地适应单个合成器对给定参数支持的值范围。下面是 soft 合成器的值和参数描述，它是目前最常用的。

/sys/accessibility/speakup/<synth-name>/caps_start

在文件 sysfs-driver-speakup 中定义

这是发送到合成器的字符串，用于使其开始朗读大写字母。对于 soft 合成器和大多数其他合成器，这会使语音的音高升至当前设置的音高之上。

/sys/accessibility/speakup/<synth-name>/caps_stop

在文件 sysfs-driver-speakup 中定义

这是发送到合成器的字符串，用于使其停止朗读大写字母。对于 soft 合成器和大多数其他合成器，这会将语音的音高返回到当前设置的音高。

/sys/accessibility/speakup/<synth-name>/delay_time

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/<synth-name>/direct

在文件 sysfs-driver-speakup 中定义

控制标点符号是由 speakup 朗读还是由合成器朗读。

例如，speakup 将“>”读作“greater”，而 soft 驱动程序使用的 espeak 合成器将“>”读作“greater than”。零表示 speakup 朗读标点符号。一表示合成器自己朗读标点符号。

/sys/accessibility/speakup/<synth-name>/flush_time

在文件 sysfs-driver-speakup 中定义

获取或设置等待合成器刷新完成的超时时间。当电缆出现故障并且刷新通知丢失时，可以使用此功能。

/sys/accessibility/speakup/<synth-name>/freq

在文件 sysfs-driver-speakup 中定义

获取或设置语音合成器的频率。范围是 0-9。

/sys/accessibility/speakup/<synth-name>/full_time

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/<synth-name>/inflection

在文件 sysfs-driver-speakup 中定义

获取或设置合成器的语调，即音高范围。范围是 0-9。

/sys/accessibility/speakup/<synth-name>/jiffy_delta

在文件 sysfs-driver-speakup 中定义

这控制内核向合成器提供多少个 jiffy。设置过高可能会使系统不稳定，甚至导致系统崩溃。

/sys/accessibility/speakup/<synth-name>/pitch

在文件 sysfs-driver-speakup 中定义

获取或设置合成器的音高。范围是 0-9。

/sys/accessibility/speakup/<synth-name>/punct

在文件 sysfs-driver-speakup 中定义

获取或设置合成器朗读的标点符号数量。soft 驱动程序的范围似乎是 0-2。待办：这与 speakup 的 punc_level 或 reading_punc 有何关系。

/sys/accessibility/speakup/<synth-name>/rate

在文件 sysfs-driver-speakup 中定义

获取或设置合成器的语速。范围从零（最慢）到九（最快）。

/sys/accessibility/speakup/<synth-name>/tone

在文件 sysfs-driver-speakup 中定义

获取或设置语音合成器的音调。soft 驱动程序的范围似乎是 0-2。如果使用 espeak 和 espeakup 连接器，这似乎没有区别。待办：espeakup 是否支持不同的音调？

/sys/accessibility/speakup/<synth-name>/trigger_time

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/<synth-name>/voice

在文件 sysfs-driver-speakup 中定义

如果合成器能够以多种语音说话，则获取或设置合成器使用的语音。soft 驱动程序的范围是 0-7。请注意，虽然 espeak 支持多种语音，但当 speakup 和 espeak 之间使用 espeakup 连接器时，此参数不会设置语音。

/sys/accessibility/speakup/<synth-name>/vol

在文件 sysfs-driver-speakup 中定义

获取或设置语音合成器的音量。范围是 0-9，零为最轻，九为最响。

/sys/accessibility/speakup/attrib_bleep

在文件 sysfs-driver-speakup 中定义

在使用 speakup 审查命令时，当有属性变化（如前景色或背景色）时，PC 扬声器会发出蜂鸣声。1 = 开，0 = 关。

/sys/accessibility/speakup/bell_pos

在文件 sysfs-driver-speakup 中定义

这与打字机的铃声非常相似。例如，如果将 72 回显到 bell_pos，则在行上键入字符超过 72 时，PC 扬声器会发出蜂鸣声。

/sys/accessibility/speakup/bleep_time

在文件 sysfs-driver-speakup 中定义

这控制 speakup 产生的 PC 扬声器蜂鸣声的持续时间。待办：单位是什么？Jiffy 吗？

/sys/accessibility/speakup/bleeps

在文件 sysfs-driver-speakup 中定义

这控制在使用 speakup 的审查命令时是否通过 PC 扬声器听到蜂鸣声。待办：它接受什么值？

/sys/accessibility/speakup/cur_phonetic

在文件 sysfs-driver-speakup 中定义

这允许 speakup 在逐字母浏览单词时语音化地朗读字母。这不会影响键入字符时的拼写。当 cur_phonetic=1 时，speakup 在光标移过字母时会语音化地朗读字符。当 cur_phonetic=0 时，speakup 会正常朗读字母。

/sys/accessibility/speakup/cursor_time

在文件 sysfs-driver-speakup 中定义

这控制使用方向键时光标延迟。当连接非常慢时，使用默认设置，当使用方向键移动或退格等时，speakup 会朗读错误的字符。将其设置为更高的值以调整延迟并更好地同步光标位置和语音。

/sys/accessibility/speakup/delimiters

在文件 sysfs-driver-speakup 中定义

从 speakup 中分隔单词。待办：添加更多信息

/sys/accessibility/speakup/ex_num

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/i18n/announcements

在文件 sysfs-driver-speakup 中定义

此文件包含各种通用通知，其中大部分无法归类。您会找到诸如“You killed Speakup”、“I’m alive”、“leaving help”、“parked”、“unparked”等消息。您还会在此处找到屏幕边缘和光标跟踪模式的名称。

/sys/accessibility/speakup/i18n/characters

在文件 sysfs-driver-speakup 中定义

通过此 sys 条目，Speakup 允许您更改 Speakup 发音给定字符的方式。例如，您可以更改某些标点符号的发音方式。您甚至可以更改 Speakup 发音某些字母的方式。有关更多详细信息，请参阅 Speakup 用户指南（源文件中的 spkguide.txt 文件）中的“12. Changing the Pronunciation of Characters”。

/sys/accessibility/speakup/i18n/chartab

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/i18n/colors

在文件 sysfs-driver-speakup 中定义

当您使用“朗读属性”功能时，Speakup 会朗读前景色和背景色的名称。这些名称来自 i18n/colors 文件。

/sys/accessibility/speakup/i18n/ctl_keys

在文件 sysfs-driver-speakup 中定义

在这里，您会找到控制键的名称。这些名称与 Speakup 的 say_control 功能一起使用。

/sys/accessibility/speakup/i18n/formatted

在文件 sysfs-driver-speakup 中定义

这组消息包含嵌入式格式代码，用于指定显示数据的类型和宽度。如果更改这些消息，则必须保留所有格式代码，并且它们必须以默认消息中使用的顺序出现。

/sys/accessibility/speakup/i18n/function_names

在文件 sysfs-driver-speakup 中定义

在这里，您会找到 Speakup 功能的名称列表。这些名称由帮助系统使用。例如，假设您已激活帮助模式并按下数字键盘 3。Speakup 会说：“keypad 3 is character, say next.”。消息“character, say next”是 Speakup 功能的名称，它来自此 function_names 文件。

/sys/accessibility/speakup/i18n/key_names

在文件 sysfs-driver-speakup 中定义

同样，key_names 也由 Speakup 的帮助系统使用。在前面的示例中，Speakup 说您按下了“keypad 3.”。此名称来自 key_names 文件。

/sys/accessibility/speakup/i18n/states

在文件 sysfs-driver-speakup 中定义

此文件包含键状态的名称。同样，这些是帮助系统的一部分。例如，如果您按下了 speakup + 数字键盘 3，您会听到：“speakup keypad 3 is go to bottom edge.”

speakup 键被按下，因此键状态的名称是 speakup。

消息的这一部分来自 states 集合。

/sys/accessibility/speakup/key_echo

在文件 sysfs-driver-speakup 中定义

控制 Speakup 是否在键入时朗读按键。1 = 开启，0 = 关闭或不回显按键。

/sys/accessibility/speakup/keymap

在文件 sysfs-driver-speakup 中定义

Speakup 键盘映射将按键重新映射到 Speakup 功能。它使用二进制格式。需要一个名为 genmap 的特殊程序将文本键盘映射编译成二进制格式，然后将其加载到 /sys/accessibility/speakup/keymap 中。

/sys/accessibility/speakup/no_interrupt

在文件 sysfs-driver-speakup 中定义

控制键入是否中断 speakup 的输出。当 no_interrupt 设置为零时，如果例如在屏幕完全读取之前使用了“朗读屏幕”命令，则键盘键入会中断 speakup。

当 no_interrupt 设置为一时，如果使用了“朗读屏幕”命令，然后用户键入键盘，speakup 将继续朗读整个屏幕，直到完成。

/sys/accessibility/speakup/punc_all

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为 4 时，speakup 应该朗读的所有标点符号的列表。

/sys/accessibility/speakup/punc_level

在文件 sysfs-driver-speakup 中定义

控制屏幕显示时（而非回顾时）朗读的标点符号级别。级别范围从零（无标点符号）到四（所有标点符号）。一对应 punc_some，二对应 punc_most，三和四都对应 punc_all。某些硬件合成器可能具有不同的级别，分别对应 punc_level 的三和四。另请注意，如果 punc_level 设置为零，并且 key_echo 设置为一，则键入的标点符号仍会在键入时朗读。

/sys/accessibility/speakup/punc_most

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为二时，speakup 应该朗读的所有标点符号的列表。

/sys/accessibility/speakup/punc_some

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为一时，speakup 应该朗读的所有标点符号的列表。

/sys/accessibility/speakup/reading_punc

在文件 sysfs-driver-speakup 中定义

与 punc_level 几乎相同，不同之处在于 reading_punc 控制使用 speakup 的屏幕审查命令审查屏幕时标点符号的级别。另一个区别是 reading_punc 设置为三时朗读 punc_all，reading_punc 设置为四时朗读所有标点符号，包括空格。

/sys/accessibility/speakup/repeats

在文件 sysfs-driver-speakup 中定义

speakup 重复的字符列表。通常，当连续出现三个以上字符时，speakup 只朗读其中三个字符。例如，“......”将被朗读为 dot, dot, dot。如果将 . 添加到 repeats 中的字符列表，“......”将被朗读为 dot, dot, dot, times six。

/sys/accessibility/speakup/say_control

在文件 sysfs-driver-speakup 中定义

如果设置为一，当按下 Shift、Alt 和 Control 键时，speakup 会朗读这些键。如果 say_control 设置为零，当按下 Shift、Ctrl 和 Alt 键时，它们将不被朗读。

/sys/accessibility/speakup/say_word_ctl

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/silent

在文件 sysfs-driver-speakup 中定义

待办

/sys/accessibility/speakup/spell_delay

在文件 sysfs-driver-speakup 中定义

这控制当 speakup 的“朗读单词”审查命令被快速按下两次以朗读当前审查的单词时，单词的拼读速度。零表示字母一个接一个地朗读，而一到四的值似乎会在 speakup 拼写每个字母之间引入更多停顿。

/sys/accessibility/speakup/synth

在文件 sysfs-driver-speakup 中定义

获取或设置当前使用的合成器驱动程序。读取 synth 返回当前使用的合成器驱动程序。写入 synth 将切换到给定的合成器驱动程序，前提是它要么内置于内核中，要么已作为模块加载。

/sys/accessibility/speakup/synth_direct

在文件 sysfs-driver-speakup 中定义

将写入 synth_direct 的任何内容直接发送到正在使用的语音合成器，绕过 speakup。这可用于使合成器朗读字符串，或向合成器发送控制序列以更改合成器的行为。

/sys/accessibility/speakup/version

在文件 sysfs-driver-speakup 中定义

读取 version 返回 speakup 的版本以及当前使用的合成器驱动程序的版本。

/sys/block 下的符号¶

/sys/block/<disk>/<partition>/alignment_offset

在文件 sysfs-block 中定义

存储设备可能会报告比逻辑块大小更大的物理块大小（例如，一个具有 4KB 物理扇区的驱动器向操作系统公开 512 字节逻辑块）。此参数指示分区起始位置与磁盘自然对齐的偏移字节数。

/sys/block/<disk>/<partition>/discard_alignment

在文件 sysfs-block 中定义

支持丢弃功能的设备可能会以大于导出逻辑块大小的单位内部分配空间。discard_alignment 参数指示分区起始位置与内部分配单元的自然对齐的偏移字节数。

/sys/block/<disk>/<partition>/stat

在文件 sysfs-block 中定义

/sys/block/<disk>/<partition>/stat 文件显示分区 <partition> 的 I/O 统计信息。其格式与 /sys/block/<disk>/stat 的格式相同。

/sys/block/<disk>/alignment_offset

在文件 sysfs-block 中定义

存储设备可能会报告比逻辑块大小更大的物理块大小（例如，一个具有 4KB 物理扇区的驱动器向操作系统公开 512 字节逻辑块）。此参数指示设备起始位置与磁盘自然对齐的偏移字节数。

/sys/block/<disk>/atomic_write_boundary_bytes

在文件 sysfs-block 中定义

[只读] 设备可能需要内部拆分跨越给定逻辑块地址边界的原子写入 I/O。此参数指定原子边界的大小（以字节为单位）（如果设备报告）。此值必须是 2 的幂，并且至少与 atomic_write_unit_max_bytes 大小相同。任何合并原子写入 I/O 的尝试都不得导致合并的 I/O 跨越此边界（如果有）。

/sys/block/<disk>/atomic_write_max_bytes

在文件 sysfs-block 中定义

[只读] 此参数指定设备报告的最大原子写入大小。此参数与写入合并相关，其中合并的原子写入操作不得超过此字节数。此参数可能大于 atomic_write_unit_max_bytes 中的值，因为 atomic_write_unit_max_bytes 将向下舍入为 2 的幂，并且 atomic_write_unit_max_bytes 也可能受到其他一些队列限制（如 max_segments）的限制。此参数——以及 atomic_write_unit_min_bytes 和 atomic_write_unit_max_bytes——不会大于 max_hw_sectors_kb，但可能大于 max_sectors_kb。

/sys/block/<disk>/atomic_write_unit_max_bytes

在文件 sysfs-block 中定义

[只读] 此参数定义可以使用原子写入操作原子写入的最大块。此值必须是 atomic_write_unit_min 的倍数，并且必须是 2 的幂。此值不会大于 atomic_write_max_bytes。

/sys/block/<disk>/atomic_write_unit_min_bytes

在文件 sysfs-block 中定义

[只读] 此参数指定可以使用原子写入操作原子写入的最小块。所有原子写入操作都必须在 atomic_write_unit_min 边界开始，并且必须是 atomic_write_unit_min 的倍数。此值必须是 2 的幂。

/sys/block/<disk>/discard_alignment

在文件 sysfs-block 中定义

支持丢弃功能的设备可能会以大于导出逻辑块大小的单位内部分配空间。discard_alignment 参数指示设备起始位置与内部分配单元的自然对齐的偏移字节数。

/sys/block/<disk>/diskseq

在文件 sysfs-block 中定义

/sys/block/<disk>/diskseq 文件报告磁盘序列号，这是一个分配给每个驱动器的单调递增数字。某些设备（如循环设备）在每次更改后端文件时都会刷新此数字。值类型为 64 位无符号整数。

/sys/block/<disk>/hidden

在文件 sysfs-block 中定义

[只读] 块设备是隐藏的。它不会产生事件，也无法从用户空间或使用 blkdev_get* 打开。用于多路径设备的底层组件。

/sys/block/<disk>/inflight

在文件 sysfs-block 中定义

报告设备驱动程序中当前正在进行（挂起/正在处理）的 I/O 请求数量。此数量可能小于块设备队列中排队的请求数量。报告包含 2 个字段：一个用于读取请求，一个用于写入请求。值类型为无符号整数。参见 /sys/block/<dev>/stat 中的块层统计信息，其中包含一个用于正在进行的请求的单一值。这与 /sys/block/<disk>/queue/nr_requests 相关，对于 SCSI 设备也与其 queue_depth 相关。

/sys/block/<disk>/integrity/device_is_integrity_capable

在文件 sysfs-block 中定义

指示存储设备是否能够存储完整性元数据。如果设备支持 T10 PI，则设置为此标志。如果存储介质已使用 T10 保护信息格式化，则此标志设置为 1。如果存储介质未启用 T10 保护信息格式化，则此标志设置为 0。

/sys/block/<disk>/integrity/format

在文件 sysfs-block 中定义

支持完整性的块设备的元数据格式。例如 T10-DIF-TYPE1-CRC。此字段描述了块设备可以发送和接收的 T10 保护信息类型。如果设备可以存储应用程序完整性元数据但未使用 T10 保护信息配置文件，则此字段包含“nop”。如果设备不支持完整性元数据，则此字段包含“none”。

/sys/block/<disk>/integrity/protection_interval_bytes

在文件 sysfs-block 中定义

描述由一个完整性元组保护的数据字节数。通常是设备的逻辑块大小。

/sys/block/<disk>/integrity/read_verify

在文件 sysfs-block 中定义

指示块层是否应验证支持发送完整性元数据的设备所提供读取请求的完整性。

/sys/block/<disk>/integrity/tag_size

在文件 sysfs-block 中定义

每个 protection_interval_bytes 可用的完整性标签空间字节数，通常是设备的逻辑块大小。此字段描述了应用程序标签的大小，如果存储设备已使用 T10 保护信息格式化并允许使用应用程序标签。tag_size 以字节为单位报告，并指示为每个块（protection_interval_bytes）添加不透明标签的可用空间。如果设备不支持 T10 保护信息（即使设备提供应用程序完整性元数据空间），此字段设置为 0。

/sys/block/<disk>/integrity/write_generate

在文件 sysfs-block 中定义

指示块层是否应自动为绑定到支持接收完整性元数据的设备的写入请求生成校验和。

/sys/block/<disk>/partscan

在文件 sysfs-block 中定义

/sys/block/<disk>/partscan 文件报告磁盘是否启用了分区扫描。如果分区扫描已启用，则返回“1”；否则返回“0”。值类型为 32 位无符号整数，但只有“0”和“1”是有效值。

/sys/block/<disk>/queue/add_random

在文件 sysfs-block 中定义

[读写] 此文件允许关闭磁盘熵贡献。此文件的默认值为“1”（开启）。

/sys/block/<disk>/queue/chunk_sectors

在文件 sysfs-block 中定义

[只读] chunk_sectors 根据磁盘类型具有不同的含义。对于 RAID 设备 (dm-raid)，chunk_sectors 表示 RAID 卷条带段的大小（以 512B 扇区为单位）。对于分区块设备（无论是主机感知还是主机管理），chunk_sectors 表示设备分区的大小（以 512B 扇区为单位），最终设备最后一个分区可能较小。

/sys/block/<disk>/queue/crypto/

在文件 sysfs-block 中定义

/sys/block/<disk>/queue/ 的此子目录的存在表示设备支持内联加密。此子目录包含描述设备内联加密能力的文件。有关内联加密的更多信息，请参阅内联加密。

/sys/block/<disk>/queue/crypto/hw_wrapped_keys

在文件 sysfs-block 中定义

[只读] 此文件的存在表明设备支持硬件封装的内联加密密钥，即只能由专用硬件解封装和使用的密钥 blob。有关硬件封装的内联加密密钥的更多信息，请参阅内联加密。

/sys/block/<disk>/queue/crypto/max_dun_bits

在文件 sysfs-block 中定义

[只读] 此文件显示设备在内联加密请求中接受的数据单元号的最大长度（以位为单位）。

/sys/block/<disk>/queue/crypto/modes/<mode>

在文件 sysfs-block 中定义

[只读] 对于设备支持的每个加密模式（即加密/解密算法）的内联加密，此位置将存在一个文件。它将包含一个十六进制数字，该数字是该加密模式支持的数据单元大小（以字节为单位）的位掩码。

目前，可能支持的加密模式有

AES-256-XTS

AES-128-CBC-ESSIV

Adiantum

例如，如果设备支持数据单元大小为 512 和 4096 字节的 AES-256-XTS 内联加密，则文件 /sys/block/<disk>/queue/crypto/modes/AES-256-XTS 将存在并包含“0x1200”。

/sys/block/<disk>/queue/crypto/num_keyslots

在文件 sysfs-block 中定义

[只读] 此文件显示设备用于内联加密的密钥槽数量。

/sys/block/<disk>/queue/crypto/raw_keys

在文件 sysfs-block 中定义

[只读] 此文件的存在表明设备支持原始内联加密密钥，即以原始明文形式在软件中管理的密钥。

/sys/block/<disk>/queue/dax

在文件 sysfs-block 中定义

[只读] 此文件指示设备是否支持直接访问 (DAX)，DAX 用于 CPU 可寻址存储以绕过页缓存。如果为 true，则显示“1”；否则显示“0”。

/sys/block/<disk>/queue/discard_granularity

在文件 sysfs-block 中定义

[只读] 支持丢弃功能的设备可能会使用大于逻辑块大小的单位内部分配空间。discard_granularity 参数指示设备报告的内部分配单元的大小（以字节为单位）。否则，discard_granularity 将设置为与设备的物理块大小匹配。discard_granularity 为 0 表示设备不支持丢弃功能。

/sys/block/<disk>/queue/discard_max_bytes

在文件 sysfs-block 中定义

[读写] 虽然 discard_max_hw_bytes 是设备的硬件限制，但此设置是软件限制。某些设备在发出大量丢弃操作时会表现出较大的延迟，将此值设置得更低将使 Linux 发出较小的丢弃操作，并可能有助于减少大量丢弃操作引起的延迟。

/sys/block/<disk>/queue/discard_max_hw_bytes

在文件 sysfs-block 中定义

[只读] 支持丢弃功能的设备可能在单个操作中可修剪或未映射的字节数方面具有内部限制。discard_max_hw_bytes 参数由设备驱动程序设置为单个操作中可丢弃的最大字节数。发往设备的丢弃请求不得超过此限制。discard_max_hw_bytes 值为 0 表示设备不支持丢弃功能。

/sys/block/<disk>/queue/discard_zeroes_data

在文件 sysfs-block 中定义

[只读] 将始终返回 0。不要依赖于丢弃的任何特定行为，并且不要读取此文件。

/sys/block/<disk>/queue/dma_alignment

在文件 sysfs-block 中定义

报告用户空间地址必须具有的对齐方式，以便通过 O_DIRECT 和其他驱动程序特定的直通机制用于原始块设备访问。

/sys/block/<disk>/queue/fua

在文件 sysfs-block 中定义

[只读] 块驱动程序是否支持写入请求的 FUA 标志。FUA 代表强制单元访问。如果设置了 FUA 标志，则意味着写入请求必须绕过存储设备的易失性缓存。

/sys/block/<disk>/queue/hw_sector_size

在文件 sysfs-block 中定义

[只读] 这是设备的硬件扇区大小，以字节为单位。

/sys/block/<disk>/queue/independent_access_ranges/

在文件 sysfs-block 中定义

[只读] /sys/block/xxx/queue/ 目录的此子目录的存在表明设备能够并行执行针对不同扇区范围的请求。例如，如果设备正确地宣传其执行器的扇区范围，则单 LUN 多执行器硬盘将具有 independent_access_ranges 目录。

independent_access_ranges 目录包含每个访问范围的一个目录，每个范围都使用 sector (RO) 属性文件指示范围的第一个扇区，并使用 nr_sectors (RO) 属性文件指示从范围的第一个扇区开始的范围内的扇区总数。例如，双执行器硬盘将具有以下 independent_access_ranges 条目。

$ tree /sys/block/<disk>/queue/independent_access_ranges/
/sys/block/<disk>/queue/independent_access_ranges/
|-- 0
|   |-- nr_sectors
|   `-- sector
`-- 1
    |-- nr_sectors
    `-- sector

扇区和 nr_sectors 属性使用 512B 扇区单位，无论设备的实际块大小如何。独立访问范围不重叠，并且包含设备容量内的所有扇区。访问范围按范围起始扇区的递增顺序编号，即范围 0 的扇区属性始终为 0。

/sys/block/<disk>/queue/io_poll

在文件 sysfs-block 中定义

[读写] 读取时，此文件显示轮询是启用 (1) 还是禁用 (0)。向此文件写入“0”将禁用此设备的轮询。写入任何非零值将启用此功能。

/sys/block/<disk>/queue/io_poll_delay

在文件 sysfs-block 中定义

[读写] 此参数用于控制将执行何种轮询。它现在固定为 -1，即经典轮询。在此模式下，CPU 将重复请求完成，而不放弃任何时间。<已弃用>

/sys/block/<disk>/queue/io_timeout

在文件 sysfs-block 中定义

[读写] io_timeout 是请求超时时间，以毫秒为单位。如果请求在此时间内未完成，则会调用块驱动程序超时处理程序。该超时处理程序可以决定重试请求、使其失败或启动设备恢复策略。

/sys/block/<disk>/queue/iostats

在文件 sysfs-block 中定义

[读写] 此文件用于控制磁盘的 I/O 统计信息记账（开/关）。

/sys/block/<disk>/queue/iostats_passthrough

在文件 sysfs-block 中定义

[读写] 此文件用于控制磁盘对直通命令的 I/O 统计信息记账（开/关）。

/sys/block/<disk>/queue/logical_block_size

在文件 sysfs-block 中定义

[只读] 这是存储设备可以寻址的最小单位。通常为 512 字节。

/sys/block/<disk>/queue/max_active_zones

在文件 sysfs-block 中定义

[只读] 对于分区块设备（ zoned 属性指示“主机管理”或“主机感知”），属于任何分区状态：EXPLICIT OPEN、IMPLICIT OPEN 或 CLOSED 的分区总和受此值限制。如果此值为 0，则没有限制。

如果主机尝试超出此限制，驱动程序应报告 BLK_STS_ZONE_ACTIVE_RESOURCE 错误，用户空间可能会将其视为 EOVERFLOW 错误码。

/sys/block/<disk>/queue/max_discard_segments

在文件 sysfs-block 中定义

[只读] 丢弃请求中 DMA 散布/聚集条目的最大数量。

/sys/block/<disk>/queue/max_hw_sectors_kb

在文件 sysfs-block 中定义

[只读] 这是单个数据传输支持的最大千字节数。

/sys/block/<disk>/queue/max_integrity_segments

在文件 sysfs-block 中定义

[只读] DMA 散布/聚集列表中具有完整性数据的元素的最大数量，这些元素将由块层核心提交给关联的块驱动程序。

/sys/block/<disk>/queue/max_open_zones

在文件 sysfs-block 中定义

[只读] 对于分区块设备（ zoned 属性指示“主机管理”或“主机感知”），属于任何分区状态：EXPLICIT OPEN 或 IMPLICIT OPEN 的分区总和受此值限制。如果此值为 0，则没有限制。

/sys/block/<disk>/queue/max_sectors_kb

在文件 sysfs-block 中定义

[读写] 这是块层允许的文件系统请求的最大千字节数。必须小于或等于硬件允许的最大大小。写入 0 以使用默认内核设置。

/sys/block/<disk>/queue/max_segment_size

在文件 sysfs-block 中定义

[只读] DMA 散布/聚集列表中单个元素的最大大小（以字节为单位）。

/sys/block/<disk>/queue/max_segments

在文件 sysfs-block 中定义

[只读] 提交到关联块驱动程序的 DMA 散布/聚集列表中的元素的最大数量。

/sys/block/<disk>/queue/max_write_streams

在文件 sysfs-block 中定义

[只读] 支持的最大写入流数量，如果不支持则为 0。如果支持，有效值为 1 到 max_write_streams（含）之间。

/sys/block/<disk>/queue/minimum_io_size

在文件 sysfs-block 中定义

[只读] 存储设备可能会报告粒度或首选最小 I/O 大小，这是设备可以在不产生性能损失的情况下执行的最小请求。对于磁盘驱动器，这通常是物理块大小。对于 RAID 阵列，这通常是条带块大小。minimum_io_size 的适当对齐倍数是需要大量 I/O 操作的工作负载的首选请求大小。

/sys/block/<disk>/queue/nomerges

在文件 sysfs-block 中定义

[读写] 标准 I/O 电梯操作包括尝试合并连续 I/O。对于已知的随机 I/O 负载，这些尝试将始终失败，导致内核花费额外的周期。这允许以两种方式之一关闭此行为：当设置为 1 时，禁用复杂的合并检查，但启用与先前 I/O 请求的简单一次性合并。当设置为 2 时，所有合并尝试都被禁用。默认值为 0，启用所有类型的合并尝试。

/sys/block/<disk>/queue/nr_requests

在文件 sysfs-block 中定义

[读写] 这控制块层中可为读写请求分配的请求数量。请注意，分配的总数可能是此数量的两倍，因为它仅适用于读或写（而非累积总和）。

为了避免通过请求饥饿导致的优先级反转，当 CONFIG_BLK_CGROUP 启用时，请求队列会为每个 cgroup 维护一个单独的请求池，并且此参数适用于每个此类每块 cgroup 请求池。换句话说，如果存在 N 个块 cgroup，每个请求队列最多可以有 N 个请求池，每个池都由 nr_requests 独立管理。

/sys/block/<disk>/queue/nr_zones

在文件 sysfs-block 中定义

[只读] nr_zones 指示分区块设备（“主机感知”或“主机管理”分区模型）的总分区数量。对于常规块设备，此值始终为 0。

/sys/block/<disk>/queue/optimal_io_size

在文件 sysfs-block 中定义

[只读] 存储设备可能会报告最佳 I/O 大小，这是设备用于持续 I/O 的首选单位。磁盘驱动器很少报告此值。对于 RAID 阵列，它通常是条带宽度或内部磁道大小。optimal_io_size 的适当对齐倍数是需要持续吞吐量的工作负载的首选请求大小。如果未报告最佳 I/O 大小，则此文件包含 0。

/sys/block/<disk>/queue/physical_block_size

在文件 sysfs-block 中定义

[只读] 这是物理存储设备可以原子写入的最小单位。它通常与逻辑块大小相同，但可能更大。一个例子是 SATA 驱动器，它具有 4KB 扇区，但向操作系统公开 512 字节的逻辑块大小。对于堆叠块设备，physical_block_size 变量包含组件设备的最大 physical_block_size。

/sys/block/<disk>/queue/read_ahead_kb

在文件 sysfs-block 中定义

[读写] 此块设备上文件系统预读的最大千字节数。

对于 MADV_HUGEPAGE，预读大小可能会超过此设置，因为其粒度基于大页面大小。

/sys/block/<disk>/queue/rotational

在文件 sysfs-block 中定义

[读写] 此文件用于指示设备是旋转类型还是非旋转类型。

/sys/block/<disk>/queue/rq_affinity

在文件 sysfs-block 中定义

[读写] 如果此选项设置为“1”，块层会将请求完成迁移到最初提交请求的 CPU“组”。对于某些工作负载，由于缓存效应，这可以显著减少 CPU 周期。

对于需要最大化完成处理分布的存储配置，将此选项设置为“2”会强制完成在请求 CPU 上运行（绕过“组”聚合逻辑）。

/sys/block/<disk>/queue/scheduler

在文件 sysfs-block 中定义

[读写] 读取时，此文件将显示此块设备的当前和可用 I/O 调度程序。当前活动的 I/O 调度程序将用 [] 括号括起来。向此文件写入 I/O 调度程序名称将把此块设备的控制权切换到新的 I/O 调度程序。请注意，向此文件写入 I/O 调度程序名称将尝试加载该 I/O 调度程序模块，如果它尚未存在于系统中。

/sys/block/<disk>/queue/stable_writes

在文件 sysfs-block 中定义

[读写] 如果内存在用于此设备的写入请求时不得修改，则此文件将包含“1”。在这种情况下，如果内核正在执行页面回写，内核将等待回写完成，然后才允许再次修改页面，而不是像通常那样允许立即修改。此限制产生于设备多次访问内存，并且每次都必须看到相同数据的情况——例如，一次用于计算校验和，一次用于实际写入数据。如果不存在此类限制，则此文件将包含“0”。此文件可用于测试目的。

/sys/block/<disk>/queue/virt_boundary_mask

在文件 sysfs-block 中定义

[只读] 此文件显示块设备的 I/O 段内存对齐掩码。对该设备的 I/O 请求将在以下情况下在段之间拆分：前一个段的内存地址末尾或当前段的内存地址开头未与 virt_boundary_mask + 1 字节对齐。

/sys/block/<disk>/queue/wbt_lat_usec

在文件 sysfs-block 中定义

[读写] 如果设备已注册用于回写限流，则此文件显示目标最小读取延迟。如果此延迟在给定时间窗口内（参见 wb_window_usec）被超过，则回写限流将开始缩减写入。向此文件写入“0”值将禁用此功能。向此文件写入“-1”值将把值重置为默认设置。

/sys/block/<disk>/queue/write_cache

在文件 sysfs-block 中定义

[读写] 读取时，此文件将显示设备是否启用了写回缓存。前一种情况将返回“write back”，后一种情况将返回“write through”。写入此文件可以改变内核对设备的看法，但它不会改变设备状态。这意味着将设置从“write back”切换到“write through”可能不安全，因为那也会消除内核发出的缓存刷新。

/sys/block/<disk>/queue/write_same_max_bytes

在文件 sysfs-block 中定义

[只读] 某些设备支持写相同操作，其中单个数据块可以写入存储上连续的几个块范围。这可用于擦除磁盘区域或初始化 RAID 配置中的驱动器。write_same_max_bytes 指示单个写相同命令中可写入的字节数。如果 write_same_max_bytes 为 0，则设备不支持写相同。

/sys/block/<disk>/queue/write_stream_granularity

在文件 sysfs-block 中定义

[只读] 写入流的粒度，以字节为单位。写入流的粒度是应该一起丢弃或覆盖的大小，以避免设备中的写入放大。

/sys/block/<disk>/queue/write_zeroes_max_bytes

在文件 sysfs-block 中定义

[只读] 支持写入零操作的设备，其中可以发出单个请求以将存储上连续块的范围清零，而请求中不包含任何有效载荷。这可用于优化向设备写入零。write_zeroes_max_bytes 指示单个写入零命令中可以写入的字节数。如果 write_zeroes_max_bytes 为 0，则设备不支持写入零。

/sys/block/<disk>/queue/zone_append_max_bytes

在文件 sysfs-block 中定义

[只读] 这是可以使用区域追加写入操作 (REQ_OP_ZONE_APPEND) 写入分区块设备的顺序区域的最大字节数。对于常规块设备，此值始终为 0。

/sys/block/<disk>/queue/zone_write_granularity

在文件 sysfs-block 中定义

[只读] 这表示分区块设备（具有报告“host-managed”或“host-aware”的 zoned 属性的设备）的顺序分区中写入操作的对齐约束（以字节为单位）。对于常规块设备，此值始终为 0。

/sys/block/<disk>/queue/zoned

在文件 sysfs-block 中定义

[只读] zoned 指示设备是否为分区块设备以及如果确实是分区设备则指示其分区模型。zoned 指示的可能值为常规块设备的“none”以及分区块设备的“host-aware”或“host-managed”。主机感知和主机管理分区块设备的特性在 ZBC (Zoned Block Commands) 和 ZAC (Zoned Device ATA Command Set) 标准中描述。这些标准还定义了“drive-managed”分区模型。但是，由于驱动器管理分区块设备不支持分区命令，它们将被视为常规块设备，并且 zoned 将报告“none”。

/sys/block/<disk>/stat

在文件 sysfs-block 中定义

/sys/block/<disk>/stat 文件显示磁盘 <disk> 的 I/O 统计信息。它们包含 11 个字段

1	成功完成的读取操作
2	合并的读取操作
3	读取扇区数
4	读取耗时 (毫秒)
5	完成的写入操作
6	合并的写入操作
7	写入扇区数
8	写入耗时 (毫秒)
9	当前正在进行的 I/O 操作数
10	执行 I/O 耗时 (毫秒)
11	执行 I/O 加权耗时 (毫秒)
12	完成的丢弃操作
13	合并的丢弃操作
14	丢弃扇区数
15	丢弃耗时 (毫秒)
16	完成的刷新请求
17	刷新耗时 (毫秒)

有关更多详细信息，请参阅 I/O 统计字段

/sys/bus 下的符号¶

/sys/bus/dsa/devices/dsa<m>/cdev_major

在文件 sysfs-driver-dma-idxd 中定义

字符设备驱动程序分配给此设备的主设备号。

/sys/bus/dsa/devices/dsa<m>/cmd_status

在文件 sysfs-driver-dma-idxd 中定义

上次执行的设备管理命令的状态/错误。也包含上次配置错误。写入此文件将清除状态。

/sys/bus/dsa/devices/dsa<m>/configurable

在文件 sysfs-driver-dma-idxd 中定义

指示此设备是否可配置。

/sys/bus/dsa/devices/dsa<m>/engine<m>.<n>

在文件 sysfs-driver-dma-idxd 中定义

此设备下分配的引擎。

/sys/bus/dsa/devices/dsa<m>/errors

在文件 sysfs-driver-dma-idxd 中定义

此设备的错误信息。

/sys/bus/dsa/devices/dsa<m>/event_log_size

在文件 sysfs-driver-dma-idxd 中定义

要配置的事件日志大小。默认值为 64 个条目，如果 evl 条目为 64 字节，则占用 4k 大小。仅在支持此功能的平台上可见。

/sys/bus/dsa/devices/dsa<m>/group<m>.<n>

在文件 sysfs-driver-dma-idxd 中定义

此设备下分配的组。

/sys/bus/dsa/devices/dsa<m>/iaa_cap

在文件 sysfs-driver-dma-idxd 中定义

IAA (IAX) 能力掩码。导出到用户空间供应用程序使用。此属性仅在版本 2 或更高版本的 IAA 设备上可见。

/sys/bus/dsa/devices/dsa<m>/max_batch_size

在文件 sysfs-driver-dma-idxd 中定义

批处理中工作描述符的最大数量。当设备不支持批处理时不可见。

/sys/bus/dsa/devices/dsa<m>/max_engines

在文件 sysfs-driver-dma-idxd 中定义

此设备支持的最大引擎数量。

/sys/bus/dsa/devices/dsa<m>/max_groups

在文件 sysfs-driver-dma-idxd 中定义

此设备下可创建的最大组数量。

/sys/bus/dsa/devices/dsa<m>/max_read_buffers

在文件 sysfs-driver-dma-idxd 中定义

此设备支持的读取缓冲区总数。读取缓冲区代表 DSA 实现中的资源，这些资源由引擎分配以支持操作。参见 DSA 规范 v1.2 9.2.4 总读取缓冲区。当设备不支持读取缓冲区分配控制时，此属性不可见。

/sys/bus/dsa/devices/dsa<m>/max_transfer_size

在文件 sysfs-driver-dma-idxd 中定义

从源地址读取以执行操作的字节数。最大传输大小取决于提交描述符的工作队列。

/sys/bus/dsa/devices/dsa<m>/max_work_queues

在文件 sysfs-driver-dma-idxd 中定义

此设备支持的最大工作队列数量。

/sys/bus/dsa/devices/dsa<m>/max_work_queues_size

在文件 sysfs-driver-dma-idxd 中定义

此设备支持的最大工作队列大小。

/sys/bus/dsa/devices/dsa<m>/numa_node

在文件 sysfs-driver-dma-idxd 中定义

此设备的 NUMA 节点号。

/sys/bus/dsa/devices/dsa<m>/op_cap

在文件 sysfs-driver-dma-idxd 中定义

操作能力位掩码指定此设备支持的操作类型。

/sys/bus/dsa/devices/dsa<m>/pasid_enabled

在文件 sysfs-driver-dma-idxd 中定义

指示此设备是否启用了用户 PASID（进程地址空间标识符）。

/sys/bus/dsa/devices/dsa<m>/read_buffer_limit

在文件 sysfs-driver-dma-idxd 中定义

访问设备中低带宽内存的操作一次可能使用的最大读取缓冲区数量。参见 DSA 规范 v1.2 9.2.8 GENCFG 全局读取缓冲区限制。当设备不支持读取缓冲区分配控制时，此属性不可见。

/sys/bus/dsa/devices/dsa<m>/state

在文件 sysfs-driver-dma-idxd 中定义

此设备的状态信息。可以是启用或禁用。

/sys/bus/dsa/devices/dsa<m>/version

在文件 sysfs-driver-dma-idxd 中定义

硬件版本号。

/sys/bus/dsa/devices/dsa<m>/wq<m>.<n>

在文件 sysfs-driver-dma-idxd 中定义

此设备下分配的工作队列。

/sys/bus/dsa/devices/engine<m>.<n>/group_id

在文件 sysfs-driver-dma-idxd 中定义

此引擎所属的组。

/sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit

在文件 sysfs-driver-dma-idxd 中定义

允许控制组中引擎可以同时处理的批处理描述符的数量，作为 ENGCAP 寄存器中指定的最大批处理描述符在进行中值的一部分。可接受的值为 0（默认）、1（最大值的 1/2）、2（最大值的 1/4）和 3（最大值的 1/8）。仅在支持此功能的平台上可见。

/sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit

在文件 sysfs-driver-dma-idxd 中定义

允许控制组中引擎可以同时处理的工作描述符的数量，作为 ENGCAP 寄存器中指定的最大工作描述符在进行中值的一部分。可接受的值为 0（默认）、1（最大值的 1/2）、2（最大值的 1/4）和 3（最大值的 1/8）。仅在支持此功能的平台上可见。

/sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed

在文件 sysfs-driver-dma-idxd 中定义

指示组中所有引擎一次可能使用的最大读取缓冲区数量。参见 DSA 规范 v1.2 9.2.18 GRPCFG 允许读取缓冲区。当设备不支持读取缓冲区分配控制时，此属性不可见。

/sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved

在文件 sysfs-driver-dma-idxd 中定义

指示为组中引擎使用而保留的读取缓冲区数量。参见 DSA 规范 v1.2 9.2.18 GRPCFG 保留读取缓冲区。当设备不支持读取缓冲区分配控制时，此属性不可见。

/sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit

在文件 sysfs-driver-dma-idxd 中定义

为组启用全局读取缓冲区限制。参见 DSA 规范 v1.2 9.2.18 GRPCFG 使用全局读取缓冲区限制。当设备不支持读取缓冲区分配控制时，此属性不可见。

/sys/bus/dsa/devices/wq<m>.<n>/ats_disable

在文件 sysfs-driver-dma-idxd 中定义

指示工作队列是否启用了 ATS 禁用。0 表示 ATS 已启用，1 表示工作队列已禁用 ATS。

/sys/bus/dsa/devices/wq<m>.<n>/block_on_fault

在文件 sysfs-driver-dma-idxd 中定义

指示工作队列是否允许在故障时阻塞以支持按需分页。

/sys/bus/dsa/devices/wq<m>.<n>/cdev_minor

在文件 sysfs-driver-dma-idxd 中定义

字符设备驱动程序分配给此工作队列的次设备号。

/sys/bus/dsa/devices/wq<m>.<n>/driver_name

在文件 sysfs-driver-dma-idxd 中定义

要绑定到工作队列的驱动程序名称。

/sys/bus/dsa/devices/wq<m>.<n>/dsa<x>!wq<m>.<n>/file<y>/cr_fault_failures

在文件 sysfs-driver-dma-idxd 中定义

显示此应用程序导致的完成记录 (CR) 故障失败次数。当驱动程序无法将 CR 的地址调入故障时，故障计数器会递增。通常这是由于提交的描述符中编程的地址错误或恶意提交者故意使用错误的 CR 地址造成的。

/sys/bus/dsa/devices/wq<m>.<n>/dsa<x>!wq<m>.<n>/file<y>/cr_faults

在文件 sysfs-driver-dma-idxd 中定义

显示此应用程序导致的完成记录 (CR) 故障次数。

/sys/bus/dsa/devices/wq<m>.<n>/dsa<x>!wq<m>.<n>/file<y>/pid

在文件 sysfs-driver-dma-idxd 中定义

显示打开文件的应用程序的进程 ID。这对于想要终止打开文件的应用程序的监视守护程序来说是很有用的信息。

/sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries

在文件 sysfs-driver-dma-idxd 中定义

指示在共享工作队列上提交 enqcmds 的重试次数。设置属性的最大值限制为 64。

/sys/bus/dsa/devices/wq<m>.<n>/group_id

在文件 sysfs-driver-dma-idxd 中定义

此工作队列所属的组 ID。

/sys/bus/dsa/devices/wq<m>.<n>/max_batch_size

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的最大批处理大小。不能超过设备最大批处理大小。可配置参数。当设备不支持批处理时不可见。

/sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的最大传输大小。不能超过设备最大传输大小。可配置参数。

/sys/bus/dsa/devices/wq<m>.<n>/mode

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的工作队列模式类型。

/sys/bus/dsa/devices/wq<m>.<n>/occupancy

在文件 sysfs-driver-dma-idxd 中定义

如果工作队列能力中的工作队列占用支持位为 1，则显示此工作队列中的当前条目数。

/sys/bus/dsa/devices/wq<m>.<n>/op_config

在文件 sysfs-driver-dma-idxd 中定义

显示以位图格式表示的操作能力位，由 %*pb printk() 输出格式说明符呈现。当工作队列被禁用时可以配置此属性，以便将工作队列配置为接受与允许的操作相关的特定位。仅在支持此功能的平台上可见。

/sys/bus/dsa/devices/wq<m>.<n>/priority

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的优先级值，它是相对于同一组中其他工作队列的值，用于控制从同一组中的多个工作队列调度工作时的服务质量。

/sys/bus/dsa/devices/wq<m>.<n>/prs_disable

在文件 sysfs-driver-dma-idxd 中定义

控制工作队列是否启用了 PRS 禁用。0 表示 PRS 已启用，1 表示工作队列已禁用 PRS。如果设置此选项，它将覆盖 block_on_fault 属性。仅在支持此功能的平台上可见。

/sys/bus/dsa/devices/wq<m>.<n>/size

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的工作队列大小。

/sys/bus/dsa/devices/wq<m>.<n>/state

在文件 sysfs-driver-dma-idxd 中定义

工作队列的当前状态。

/sys/bus/dsa/devices/wq<m>.<n>/threshold

在文件 sysfs-driver-dma-idxd 中定义

此工作队列中可通过有限门户填充的条目数。

/sys/bus/dsa/devices/wq<m>.<n>/type

在文件 sysfs-driver-dma-idxd 中定义

此工作队列的类型，它可以是内核空间中工作队列使用的“kernel”类型，或者用户空间中应用程序工作队列使用的“user”类型。

/sys/bus/firewire/devices/*/

在文件 sysfs-bus-firewire 中定义

IEEE 1394 节点设备和单元设备的通用属性。只读。在节点设备的生命周期内可变。在单元设备的生命周期内不可变。有关语义定义，请参阅 IEEE 1212。

仅当 IEEE 1394 节点的根目录或 IEEE 1394 单元的单元目录实际包含相应条目时，才会创建这些属性。

hardware_version: u24 的十六进制字符串表示。
hardware_version_name: 相应文本描述符叶的内容。
model: u24 的十六进制字符串表示。
model_name: 相应文本描述符叶的内容。
specifier_id: u24 的十六进制字符串表示。根据 IEEE 1212，在单元目录中是强制性的。
vendor: u24 的十六进制字符串表示。根据 IEEE 1212，在根目录中是强制性的。
vendor_name: 相应文本描述符叶的内容。
version: u24 的十六进制字符串表示。根据 IEEE 1212，在单元目录中是强制性的。

/sys/bus/firewire/devices/fw[0-9]+/

在文件 sysfs-bus-firewire 中定义

IEEE 1394 节点设备属性。只读。在节点设备的生命周期内可变。有关语义定义，请参阅 IEEE 1212。

config_rom: 配置 ROM 寄存器的内容。二进制属性；一个主机字节序 u32 数组。
guid: 配置 ROM 总线信息块中的节点 EUI-64。u64 的十六进制字符串表示。

/sys/bus/firewire/devices/fw[0-9]+/is_local

在文件 sysfs-bus-firewire 中定义

IEEE 1394 节点设备属性。只读且不可变。值：1：sysfs 条目表示本地节点（控制器卡）。

0：sysfs 条目表示远程节点。

/sys/bus/firewire/devices/fw[0-9]+/units

在文件 sysfs-bus-firewire 中定义

IEEE 1394 节点设备属性。只读。在节点设备的生命周期内可变。有关语义定义，请参阅 IEEE 1212。

units: IEEE 1394 节点中所有单元的摘要。包含以空格分隔的每个单元的 specifier_id 和 version 元组。每个元组中的 specifier_id 和 version 以冒号分隔，是相应单元目录条目中 u24 的十六进制字符串表示。
用户: udev 规则设置 /dev/fw[0-9]+ 字符设备文件的所有权和访问权限或 ACL

/sys/bus/firewire/devices/fw[0-9]+[.][0-9]+/

在文件 sysfs-bus-firewire 中定义

IEEE 1394 单元设备属性。只读。在单元设备的生命周期内不可变。有关语义定义，请参阅 IEEE 1212。

modalias: 与设备创建时 uevent 中的 MODALIAS 相同。
rom_index: 单元目录在父设备（节点设备）配置 ROM 中的偏移量，以四字（quadlets）为单位。十进制字符串表示。

/sys/bus/firewire/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id

旧称

/sys/bus/ieee1394/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id

在文件 sysfs-bus-firewire 中定义

SCSI 目标端口标识符和 SBP-2 目标逻辑单元的逻辑单元标识符。这些标识符在 SAM-2...SAM-4 附录 A 中指定。它们是 SBP-2 连接目标的持久且全球唯一的属性。

只读属性，在目标的生命周期内不可变。格式，自 2.6.22 版（2007 年 5 月）以来 firewire-sbp2 公开的格式：冒号分隔的十六进制字符串表示形式

u64 EUI-64 : u24 directory_ID : u16 LUN

不带 0x 前缀，不带空格。前一个 sbp2 驱动程序（在 2.6.37 版中被 firewire-sbp2 取代后移除）使用了稍短的格式，与 SAM 不那么接近。

用户: udev 规则以创建 /dev/disk/by-id/ 符号链接

/sys/bus/fsl-mc/autorescan

在文件 sysfs-bus-fsl-mc 中定义

向此属性写入零值将禁用 DPRC IRQ，从而停止对 fsl-mc 总线的自动重新扫描。非零值将启用 DPRC IRQ。

用户: 用户空间驱动程序和管理工具

/sys/bus/fsl-mc/rescan

在文件 sysfs-bus-fsl-mc 中定义

向此属性写入非零值将强制系统重新扫描 fsl-mc 总线，并同步 fsl-mc 总线下的对象和管理复合体固件。

用户: 用户空间驱动程序和管理工具

/sys/bus/mhi/devices/.../oem_pk_hash

在文件 sysfs-bus-mhi 中定义

该文件保存通过 BHI（引导主机接口）寄存器读取获得的端点设备的 OEM PK Hash 值，至少在尝试上电该设备一次之后。如果设备未至少上电一次就读取，该文件将全部读取 0。

用户: 任何对设备信息感兴趣的用户空间应用程序或客户端。

/sys/bus/mhi/devices/.../serialnumber

在文件 sysfs-bus-mhi 中定义

该文件保存通过 BHI（引导主机接口）寄存器读取获得的客户端设备的序列号，至少在尝试上电该设备一次之后。如果设备未至少上电一次就读取，该文件将全部读取 0。

用户: 任何对设备信息感兴趣的用户空间应用程序或客户端。

/sys/bus/mhi/devices/.../soc_reset

在文件 sysfs-bus-mhi 中定义

在 MHI 控制器上启动 SoC 复位。SoC 复位是最后的复位手段，需要完全重新初始化。如果设备无响应，这可以作为一种恢复方法；或者作为系统管理任务，用于加载新固件。

/sys/bus/mhi/devices/.../trigger_edl

在文件 sysfs-bus-mhi 中定义

向此文件写入非零值将强制设备进入 EDL（紧急下载）模式。此条目仅适用于能够使用 MHI 规范 v1.2 中定义的标准 EDL 触发机制进入 EDL 模式的设备。一旦进入 EDL 模式，闪存编程器映像可以下载到设备以进入闪存编程器执行环境。如果用户希望使用 QDL（高通下载，用于通过 EDL 下载固件）更新固件，这会很有用。

/sys/bus/nvmem/devices/.../force_ro

在文件 sysfs-bus-nvmem 中定义

此读/写属性允许用户将读写设备设置为只读，然后从用户空间再改回读写。这可用于解锁和重新锁定设备的写保护，这些设备通常处于锁定状态，除了偶尔的编程操作。读取返回“0”或“1”分别表示读写模式或只读模式。写入解析“YyTt1NnFf0”之一，或“[oO][NnFf]”表示“on”和“off”，即 kstrtobool() 支持的格式。注意：此文件仅在 CONFIG_NVMEM_SYSFS 启用时存在。

/sys/bus/nvmem/devices/.../nvmem

在文件 sysfs-bus-nvmem 中定义

此文件允许用户读/写原始 NVMEM 内容。此文件的写入权限取决于 nvmem 供应商配置。注意：此文件仅在 CONFIG_NVMEM_SYSFS 启用时存在。

例如

hexdump /sys/bus/nvmem/devices/qfprom0/nvmem

0000000 0000 0000 0000 0000 0000 0000 0000 0000
*
00000a0 db10 2240 0000 e000 0c00 0c00 0000 0c00
0000000 0000 0000 0000 0000 0000 0000 0000 0000
...
*
0001000

/sys/bus/nvmem/devices/.../type

在文件 sysfs-bus-nvmem 中定义

此只读属性允许用户读取 NVMEM 设备类型。支持的类型有“Unknown”、“EEPROM”、“OTP”、“Battery backed”、“FRAM”。注意：此文件仅在 CONFIG_NVMEM_SYSFS 启用时存在。

/sys/bus/pci/drivers/qla2xxx/.../devices/*

在文件 sysfs-driver-qla2xxx 中定义

qla2xxx-udev.sh 目前会查找 uevent CHANGE 事件，以指示驱动程序已生成固件转储并可供检索。

用户: qla2xxx-udev.sh。建议的更改应发送至 linux-driver@qlogic.com

/sys/bus/platform/drivers/aspeed-vuart/*/lpc_address

在文件 sysfs-driver-aspeed-vuart 中定义

配置 UART 的主机侧在主机 <-> BMC LPC 总线上出现的 I/O 端口。

用户: OpenBMC。建议的更改应发送至 openbmc@lists.ozlabs.org

/sys/bus/platform/drivers/aspeed-vuart/*/sirq

在文件 sysfs-driver-aspeed-vuart 中定义

配置 UART 的主机侧在主机 <-> BMC LPC 总线上出现的之中断号。

用户: OpenBMC。建议的更改应发送至 openbmc@lists.ozlabs.org

/sys/bus/platform/drivers/aspeed-vuart/*/sirq_polarity

在文件 sysfs-driver-aspeed-vuart 中定义

配置通过 BMC LPC 总线发送到主机的串行中断的极性。设置为 0 为低电平有效，设置为 1 为高电平有效。

用户: OpenBMC。建议的更改应发送至 openbmc@lists.ozlabs.org

/sys/bus/usb/device/.../avoid_reset_quirk

在文件 sysfs-bus-usb 中定义

向此文件写入 1 会告诉内核，此设备在复位时将转换为另一种模式。驱动程序不会对此类设备使用复位进行错误处理。

用户: usb_modeswitch

/sys/bus/usb/device/.../power/active_duration

在文件 sysfs-bus-usb 中定义

如果 CONFIG_PM 启用，则此文件存在。读取时，它返回 USB 设备处于活动状态（即未处于挂起状态）的总时间（以毫秒为单位）。此文件是只读的。

工具可以使用此文件和 connected_duration 文件计算设备处于活动状态的时间百分比。例如

echo $((100 * `cat active_duration` / `cat connected_duration`))

将给出整数百分比。请注意，这不包括计数器回绕。

用户: PowerTOP <powertop@lists.01.org> https://01.org/powertop/

/sys/bus/usb/device/.../power/connected_duration

在文件 sysfs-bus-usb 中定义

如果启用了 CONFIG_PM，则此文件存在。读取时，它返回 USB 设备连接到机器的总时间（以毫秒为单位）。此文件是只读的。

用户: PowerTOP <powertop@lists.01.org> https://01.org/powertop/

/sys/bus/usb/devices/.../bConfigurationValue

在文件 sysfs-bus-usb 中定义

设备的活动配置的 bConfigurationValue。将 0 或 -1 写入 bConfigurationValue 将重置活动配置（取消配置设备）。写入其他值将更改活动配置。

请注意，某些设备违反 USB 规范，其配置值为 0。将 0 写入这些设备的 bConfigurationValue 将安装该配置，而不是取消配置设备。

写入 -1 将始终取消配置设备。

用户: libusb

/sys/bus/usb/devices/.../busnum

在文件 sysfs-bus-usb 中定义

设备连接到的 USB 总线的总线号。

用户: libusb

/sys/bus/usb/devices/.../descriptors

在文件 sysfs-bus-usb 中定义

包含设备缓存描述符的二进制文件。二进制数据由设备描述符和每个设备配置的描述符组成。请注意，配置描述符的 wTotalLength 不可信，因为设备可能具有比其宣称的更小的配置描述符。每个（子）描述符的 bLength 字段是可信的，可用于一次向前查找一个（子）描述符，直到找到下一个描述符。从该文件读取的所有描述符都采用总线字节序格式。

用户: libusb

/sys/bus/usb/devices/.../devnum

在文件 sysfs-bus-usb 中定义

USB 总线上的设备地址。

用户: libusb

/sys/bus/usb/devices/.../power/autosuspend

在文件 sysfs-bus-usb 中定义

每个 USB 设备目录都将包含一个名为 power/autosuspend 的文件。此文件保存设备必须空闲的时间（以秒为单位），然后才能自动挂起。0 表示设备将尽快自动挂起。负值将完全阻止设备自动挂起，写入负值将恢复已挂起的设备。

新创建设备的自动挂起延迟设置为 usbcore.autosuspend 模块参数的值。

/sys/bus/usb/devices/.../power/persist

在文件 sysfs-bus-usb 中定义

USB 设备目录可以包含一个名为 power/persist 的文件。该文件包含一个布尔值（0 或 1），指示设备是否启用了“USB-Persist”功能。对于集线器，此功能始终启用，其设备目录将不包含此文件。

有关更多信息，请参阅系统挂起期间的 USB 设备持久性。

/sys/bus/usb/devices/.../speed

在文件 sysfs-bus-usb 中定义

设备连接到 USB 主机的速度，单位为 Mbit/秒。即 1.5 / 12 / 480 / 5000 中的一个。

用户: libusb

/sys/bus/usb/devices/<busnum>-<port[.port]>...:<config num>-<interface num>/supports_autosuspend

在文件 sysfs-bus-usb 中定义

读取时，如果此接口的接口驱动程序支持自动挂起，则此文件返回 1。如果没有任何驱动程序声明此接口，它也返回 1，因为如果所有其他接口驱动程序都处于空闲状态，未声明的接口不会阻止设备自动挂起。如果驱动程序尚未添加自动挂起支持，则文件返回 0。

用户: USB PM 工具 git://git.moblin.org/users/sarah/usb-pm-tool/

/sys/bus/usb/drivers/usbtmc/*/interface_capabilities

/sys/bus/usb/drivers/usbtmc/*/device_capabilities

定义于文件 sysfs-driver-usb-usbtmc

这些文件显示了设备本身描述的各种 USB TMC 功能。位字段的完整描述可在 USB-IF 发布的名为“通用串行总线测试和测量类规范 (USBTMC) 修订版 1.0”的 USB TMC 文档第 4.2.1.8 节中找到。

这些文件是只读的。

/sys/bus/usb/drivers/usbtmc/*/usb488_interface_capabilities

/sys/bus/usb/drivers/usbtmc/*/usb488_device_capabilities

定义于文件 sysfs-driver-usb-usbtmc

这些文件显示了设备本身描述的各种 USB TMC 功能。位字段的完整描述可在 USB-IF 发布的名为“通用串行总线测试和测量类，子类 USB488 规范 (USBTMC-USB488) 修订版 1.0”的 USB TMC 文档第 4.2.2 节中找到。

这些文件是只读的。

/sys/bus/vmbus/devices/<UUID>/channel_vp_mapping

定义于文件 sysfs-bus-vmbus

主/子通道绑定到哪个虚拟处理器的映射。格式：<通道的 child_relid:绑定的 CPU 编号>

用户: tools/hv/lsvmbus

/sys/bus/vmbus/devices/<UUID>/channels/<N>

定义于文件 sysfs-bus-vmbus

每个通道信息的目录 NN 是与通道关联的 VMBUS relid。

/sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu

定义于文件 sysfs-bus-vmbus

VCPU（子）通道亲和于

用户: tools/hv/lsvmbus 和其他调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/events

定义于文件 sysfs-bus-vmbus

我们向主机发出信号的次数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/in_mask

定义于文件 sysfs-bus-vmbus

主机到客户机通道中断掩码

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/interrupts

定义于文件 sysfs-bus-vmbus

我们已接受中断（传入）的次数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_in_full

定义于文件 sysfs-bus-vmbus

传入环形缓冲区从满到不满转换，同时数据包等待缓冲区空间可用时，导致客户机到主机中断的次数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_out_empty

定义于文件 sysfs-bus-vmbus

出站环形缓冲区从空到非空转换时，导致客户机到主机中断的次数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/latency

定义于文件 sysfs-bus-vmbus

通道信号延迟。此文件仅适用于使用监视器页机制的性能关键通道（存储、网络等）。

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/monitor_id

定义于文件 sysfs-bus-vmbus

与通道关联的监视器位。此文件仅适用于使用监视器页机制的性能关键通道（存储、网络等）。

用户: 调试工具和用户空间驱动程序

/sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_first

定义于文件 sysfs-bus-vmbus

首次遇到出站环形缓冲区满条件的写入操作次数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_total

定义于文件 sysfs-bus-vmbus

遇到出站环形缓冲区满条件的写入操作总数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/out_mask

定义于文件 sysfs-bus-vmbus

客户机到主机通道中断掩码

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/pending

定义于文件 sysfs-bus-vmbus

通道中断挂起状态。此文件仅适用于使用监视器页机制的性能关键通道（存储、网络等）。

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/read_avail

定义于文件 sysfs-bus-vmbus

可读字节数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/channels/<N>/ring

定义于文件 sysfs-bus-vmbus

uio_hv_generic 为环形缓冲区创建的二进制文件

用户: 用户空间驱动程序

/sys/bus/vmbus/devices/<UUID>/channels/<N>/subchannel_id

定义于文件 sysfs-bus-vmbus

与 VMBUS 通道关联的子通道 ID

用户: 调试工具和用户空间驱动程序

/sys/bus/vmbus/devices/<UUID>/channels/<N>/write_avail

定义于文件 sysfs-bus-vmbus

可写字节数

用户: 调试工具

/sys/bus/vmbus/devices/<UUID>/class_id

定义于文件 sysfs-bus-vmbus

设备的 VMBus 接口类型 GUID

用户: tools/hv/lsvmbus

/sys/bus/vmbus/devices/<UUID>/device

定义于文件 sysfs-bus-vmbus

设备的 16 位设备 ID

用户: tools/hv/lsvmbus 和用户级 RDMA 库

/sys/bus/vmbus/devices/<UUID>/device_id

定义于文件 sysfs-bus-vmbus

设备的 VMBus 接口实例 GUID

用户: tools/hv/lsvmbus

/sys/bus/vmbus/devices/<UUID>/id

定义于文件 sysfs-bus-vmbus

设备主通道的 VMBus child_relid

用户: tools/hv/lsvmbus

/sys/bus/vmbus/devices/<UUID>/numa_node

定义于文件 sysfs-bus-vmbus

VMBUS 设备附加到的 NUMA 节点，如果节点未知则为 -1。

/sys/bus/vmbus/devices/<UUID>/vendor

定义于文件 sysfs-bus-vmbus

设备的 16 位供应商 ID

用户: tools/hv/lsvmbus 和用户级 RDMA 库

/sys/bus/vmbus/hibernation

定义于文件 sysfs-bus-vmbus

主机是否支持虚拟机的休眠。

用户: 为休眠设置交换分区/文件的守护进程。

/sys/bus/w1/devices/.../eeprom

定义于文件 sysfs-driver-w1_ds28e04

读取/写入 DS28E04-100 的 EEPROM 内存内容，有关详细信息请参阅内核驱动程序 w1_ds28e04

用户: 任何希望与 DS28E04-100 通信的用户空间应用程序

/sys/bus/w1/devices/.../offset

定义于文件 sysfs-driver-w1_ds2438

写入内容到 DS2438 的偏移寄存器，有关详细信息请参阅内核驱动程序 w1_ds2438

用户: 任何希望与 DS2438 通信的用户空间应用程序

/sys/bus/w1/devices/.../page1

定义于文件 sysfs-driver-w1_ds2438

读取 DS2438 的 page1 内容，有关详细信息请参阅内核驱动程序 w1_ds2438

用户: 任何希望与 DS2438 通信的用户空间应用程序

/sys/bus/w1/devices/.../pio

定义于文件 sysfs-driver-w1_ds28e04

读取/写入 DS28E04-100 的两个 PIO 内容，有关详细信息请参阅内核驱动程序 w1_ds28e04

用户: 任何希望与 DS28E04-100 通信的用户空间应用程序

/sys/bus/w1/devices/.../w1_master_timeout_us

定义于文件 sysfs-bus-w1

总线扫描间隔，微秒分量。一些通常与物理访问控制系统相关的 1-Wire 设备连接/生成存在时间短至 100 毫秒 - 因此需要数十到数百毫秒的扫描间隔。

有关详细信息，请参阅 1-wire (w1) 子系统简介。

用户: 任何希望了解总线扫描间隔的用户空间应用程序

/sys/bus/w1/devices/.../w1_seq

定义于文件 sysfs-driver-w1_ds28ea00

支持 DS28EA00 链序列功能，有关详细信息请参阅内核驱动程序 w1_therm

用户: 任何希望与 DS28EA00 通信的用户空间应用程序

/sys/bus/wmi/devices/05901221-D566-11D1-B2F0-00A0C9062910[-X]/bmof

定义于文件 sysfs-platform-wmi-bmof

二进制 MOF 元数据，用于描述可用 ACPI WMI 接口的详细信息。

有关详细信息，请参阅 WMI 嵌入式二进制 MOF 驱动程序。

/sys/bus/xen-backend/devices/*/devtype

定义于文件 sysfs-bus-xen-backend

设备类型。例如：'vbd'（块设备）、'vif'（网络设备）或 'vfb'（帧缓冲设备）之一。

/sys/bus/xen-backend/devices/*/nodename

定义于文件 sysfs-bus-xen-backend

此后端设备的 XenStore 节点（位于 /local/domain/NNN/ 下）。

/sys/bus/xen-backend/devices/*/state

定义于文件 sysfs-bus-xen-backend

设备状态。以下之一：'Unknown'（未知）、'Initialising'（初始化中）、'Initialised'（已初始化）、'Connected'（已连接）、'Closing'（关闭中）、'Closed'（已关闭）、'Reconfiguring'（重新配置中）、'Reconfigured'（已重新配置）。

/sys/bus/xen-backend/devices/vbd-*/mode

定义于文件 sysfs-bus-xen-backend

块设备是只读（'r'）还是读写（'w'）。

/sys/bus/xen-backend/devices/vbd-*/physical_device

定义于文件 sysfs-bus-xen-backend

提供此后端块设备存储的物理设备的主:次编号（十六进制）。

/sys/bus/xen-backend/devices/vbd-*/statistics/f_req

定义于文件 sysfs-bus-xen-backend

来自前端的刷新请求数量。

/sys/bus/xen-backend/devices/vbd-*/statistics/oo_req

定义于文件 sysfs-bus-xen-backend

因后端忙于处理之前的请求而延迟的请求数量。

/sys/bus/xen-backend/devices/vbd-*/statistics/rd_req

定义于文件 sysfs-bus-xen-backend

来自前端的读取请求数量。

/sys/bus/xen-backend/devices/vbd-*/statistics/rd_sect

定义于文件 sysfs-bus-xen-backend

前端读取的扇区数量。

/sys/bus/xen-backend/devices/vbd-*/statistics/wr_req

定义于文件 sysfs-bus-xen-backend

来自前端的写入请求数量。

/sys/bus/xen-backend/devices/vbd-*/statistics/wr_sect

定义于文件 sysfs-bus-xen-backend

前端写入的扇区数量。

Symbols under /sys/class¶

/sys/class/backlight/<backlight>/actual_brightness

定义于文件 sysfs-class-backlight

通过查询硬件显示实际亮度。由于硬件实现差异，这可能与“brightness”中的值不匹配。例如，某些硬件可能以不同方式处理消隐或具有自定义节电功能。用户空间通常应使用“brightness”中的值进行决策。

用户: HAL

/sys/class/backlight/<backlight>/bl_power

定义于文件 sysfs-class-backlight

控制背光电源，值与 fb.h 中的 FB_BLANK_* 兼容

0 (FB_BLANK_UNBLANK)：电源开启。

4 (FB_BLANK_POWERDOWN)：电源关闭

用户: HAL

/sys/class/backlight/<backlight>/brightness

定义于文件 sysfs-class-backlight

控制此 <backlight> 的亮度。值介于 0 和 max_brightness 之间。此文件还将显示驱动程序中存储的亮度级别，这可能不是实际亮度（请参阅 actual_brightness）。

用户: HAL

/sys/class/backlight/<backlight>/max_brightness

定义于文件 sysfs-class-backlight

<backlight> 的最大亮度。

用户: HAL

/sys/class/backlight/<backlight>/type

定义于文件 sysfs-class-backlight

由 <backlight> 控制的接口类型。“firmware”（固件）：驱动程序使用标准固件接口。“platform”（平台）：驱动程序使用平台特定接口。“raw”（原始）：驱动程序直接控制硬件寄存器。

一般情况下，当单个设备有多个背光接口可用时，固件控制应优于平台控制，平台控制应优于原始控制。使用固件接口可降低硬件和操作系统独立更新背光状态造成的混淆概率。平台接口主要是固件接口标准化之前的遗留。

/sys/class/bluetooth/hci<index>/reset

定义于文件 sysfs-class-bluetooth

此只写属性允许用户在写入任意数据时触发蓝牙设备上的供应商复位方法。复位可以通过设备传输（例如 UART/USB）完成，也可以不通过设备传输完成，还可以通过带外方法（例如 GPIO）完成。

/sys/class/infiniband/<device-name>/hw_counters/lifespan

/sys/class/infiniband/<device-name>/ports/<port-num>/hw_counters/lifespan

定义于文件 sysfs-class-infiniband

可选的“hw_counters”子目录可以位于父设备或端口子目录下，或两者兼有。如果存在，则有硬件提供的一系列计数器。它们可能与 counters 目录中的某些计数器匹配，但通常包含许多其他计数器。除了各种计数器之外，还有一个名为“lifespan”的文件，用于配置核心在访问计数器时更新计数器的频率（如果未访问计数器，则不会更新）。lifespan 以毫秒为单位，默认为 10，除非驱动程序另行设置。用户可以将 0-10000 之间的值写入 lifespan 文件，以设置更新之间的时间长度（以毫秒为单位）。

/sys/class/infiniband/<device>/fw_ver

定义于文件 sysfs-class-infiniband

(RO) 显示固件版本

/sys/class/infiniband/<device>/node_desc

定义于文件 sysfs-class-infiniband

(RW) 使用节点主机名等信息更新节点描述，以便 IB 网络管理软件将其视图与实际世界关联起来。

/sys/class/infiniband/<device>/node_type

/sys/class/infiniband/<device>/node_guid

/sys/class/infiniband/<device>/sys_image_guid

定义于文件 sysfs-class-infiniband

node_type	(RO) 节点类型（CA、RNIC、usNIC、usNIC UDP、交换机或路由器）
node_guid	(RO) 节点 GUID
sys_image_guid	(RO) 系统镜像 GUID

/sys/class/infiniband/<device>/ports/<port-num>/counters/symbol_error

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_remote_physical_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_switch_relay_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/link_error_recovery

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_constraint_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_contraint_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/local_link_integrity_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/excessive_buffer_overrun_errors

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_data

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_data

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_rcv_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_xmit_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_rcv_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_xmit_packets

/sys/class/infiniband/<device>/ports/<port-num>/counters/link_downed

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_discards

/sys/class/infiniband/<device>/ports/<port-num>/counters/VL15_dropped

/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_wait

定义于文件 sysfs-class-infiniband

错误信息:

symbol_error: (RO) 在一个或多个物理通道上检测到的次要链路错误总数。

port_rcv_errors : (RO) 端口上收到的包含错误的报文总数。

port_rcv_remote_physical_errors : (RO) 端口上收到的标记有 EBP 分隔符的报文总数。

port_rcv_switch_relay_errors : (RO) 端口上收到的因无法通过交换机中继转发而被丢弃的报文总数。

link_error_recovery: (RO) 端口训练状态机成功完成链路错误恢复过程的总次数。

port_xmit_constraint_errors: (RO) 由于出站原始过滤或出站分区或 IP 版本检查失败，未从交换机物理端口传输的报文总数。

port_rcv_constraint_errors: (RO) 由于入站原始过滤或入站分区或 IP 版本检查失败，在交换机物理端口上收到的被丢弃的报文总数。

local_link_integrity_errors: (RO) 本地物理错误计数超过 LocalPhyErrors 指定阈值的次数。

excessive_buffer_overrun_errors: (RO) 此计数器表示输入缓冲区溢出。它表示端口可能配置错误，无论是通过子网管理器 (SM) 还是用户干预。它也可能表示硬件问题或极差的链路信号完整性。

数据信息:

port_xmit_data: (RO) 在所有 VL 上传输的数据八位字节总数，除以 4（通道）。这是一个 64 位计数器。

port_rcv_data: (RO) 在所有 VL 上接收的数据八位字节总数，除以 4（通道）。这是一个 64 位计数器。

port_xmit_packets: (RO) 从此端口在所有 VL 上传输的报文总数。这可能包括带有错误的报文。这是一个 64 位计数器。

port_rcv_packets: (RO) 报文总数（这可能包括包含错误的报文）。这是一个 64 位计数器。

link_downed: (RO) 端口训练状态机在链路错误恢复过程中失败并使链路断开的总次数。

unicast_rcv_packets: (RO) 单播报文总数，包括包含错误的单播报文。

unicast_xmit_packets: (RO) 从该端口在所有 VL 上传输的单播报文总数。这可能包括带有错误的单播报文。

multicast_rcv_packets: (RO) 多播报文总数，包括包含错误的多播报文。

multicast_xmit_packets: (RO) 从该端口在所有 VL 上传输的多播报文总数。这可能包括带有错误的多播报文。

其他信息:

port_xmit_discards: (RO) 端口因端口关闭或拥塞而丢弃的出站报文总数。

VL15_dropped: (RO) 由于端口资源限制（例如，缓冲区不足）而丢弃的传入 VL15 报文数量。

port_xmit_wait: (RO) 端口有数据要传输但在整个滴答中未发送任何数据（由于信用不足或缺少仲裁）的滴答数。

这些文件中的每一个都包含来自端口的性能管理 PortCounters 属性的相应值，如 InfiniBand 架构规范中所述。

/sys/class/infiniband/<device>/ports/<port-num>/lid

/sys/class/infiniband/<device>/ports/<port-num>/rate

/sys/class/infiniband/<device>/ports/<port-num>/lid_mask_count

/sys/class/infiniband/<device>/ports/<port-num>/sm_sl

/sys/class/infiniband/<device>/ports/<port-num>/sm_lid

/sys/class/infiniband/<device>/ports/<port-num>/state

/sys/class/infiniband/<device>/ports/<port-num>/phys_state

/sys/class/infiniband/<device>/ports/<port-num>/cap_mask

定义于文件 sysfs-class-infiniband

lid	(RO) 端口 LID
rate	(RO) 端口数据速率（活动宽度 * 活动速度）
lid_mask_count	(RO) 端口 LID 掩码计数
sm_sl	(RO) 端口子网的子网管理器 SL
sm_lid	(RO) 端口子网的子网管理器 LID
state	(RO) 端口状态（DOWN、INIT、ARMED、ACTIVE 或 ACTIVE_DEFER）
phys_state	(RO) 端口物理状态（睡眠、轮询、链路向上等）
cap_mask	(RO) 端口功能掩码。此处有两个位可设置 - IsCommunicationManagementSupported（在加载 CM 模块时设置）和 IsSM（通过打开 issmN 文件设置）。

/sys/class/infiniband/<device>/ports/<port-num>/link_layer

定义于文件 sysfs-class-infiniband

(RO) 链路层类型信息（InfiniBand 或以太网类型）

/sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/ndevs/<gid-index>

定义于文件 sysfs-class-infiniband

与 GID 关联的网络设备名称位于索引 <gid-index> 处。

/sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/types/<gid-index>

定义于文件 sysfs-class-infiniband

关联 GID 的 RoCE 类型位于索引 <gid-index> 处。对于基于 IB 和 RoCE v1 的 GID，这可以是“IB/RoCE v1”，对于基于 RoCE v2 的 GID，这可以是“RoCE v2”。

/sys/class/infiniband/bnxt_reX/hw_rev

/sys/class/infiniband/bnxt_reX/hca_type

定义于文件 sysfs-class-infiniband

hw_rev	(RO)	硬件版本号
hca_type	(RO)	主机通道适配器类型

/sys/class/infiniband/cxgb4_X/hw_rev

/sys/class/infiniband/cxgb4_X/hca_type

/sys/class/infiniband/cxgb4_X/board_id

定义于文件 sysfs-class-infiniband

hw_rev	(RO) 硬件版本号
hca_type	(RO) 驱动程序简称。通常应与其总线驱动程序结构（例如 pci_driver::name）中的名称匹配。
board_id	(RO) 制造板 ID。（供应商 + 设备信息）

适用于 Intel IB 驱动程序 qib 的 sysfs 接口

/sys/class/infiniband/hfi1_X/hw_rev

/sys/class/infiniband/hfi1_X/board_id

/sys/class/infiniband/hfi1_X/nctxts

/sys/class/infiniband/hfi1_X/serial

/sys/class/infiniband/hfi1_X/chip_reset

/sys/class/infiniband/hfi1_X/boardversion

/sys/class/infiniband/hfi1_X/nfreectxts

/sys/class/infiniband/hfi1_X/tempsense

定义于文件 sysfs-class-infiniband

hw_rev	(RO) 硬件版本号
board_id	(RO) 制造板 ID
nctxts	(RO) 可用上下文总数。
serial	(RO) 板序列号
chip_reset	(WO) 如果可能，将“reset”写入此文件以复位芯片。仅当没有使用芯片资源的用户上下文打开时才允许。
boardversion	(RO) 人类可读的板信息
nfreectxts	(RO) 可用的空闲用户端口（上下文）数量。
tempsense	(RO) 热感信息

/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_settings_bin

/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_table_bin

/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_prescan

定义于文件 sysfs-class-infiniband

每端口拥塞控制。

cc_table_bin	(RO) PSM2 拥塞控制使用的 CCA 表大小，后跟表条目。二进制属性。
cc_settings_bin	(RO) 拥塞设置：端口控制、控制映射和拥塞条目的 16 个条目数组 - 增加、计时器、事件日志触发阈值和最小注入速率延迟。二进制属性。
cc_prescan	(RW) 启用预扫描以加快 BECN 响应。写入“on”启用，写入“off”禁用。

/sys/class/infiniband/hfi1_X/ports/<N>/sc2vl/[0-31]

/sys/class/infiniband/hfi1_X/ports/<N>/sl2sc/[0-31]

/sys/class/infiniband/hfi1_X/ports/<N>/vl2mtu/[0-15]

定义于文件 sysfs-class-infiniband

sc2vl/	(RO) 32 个文件（0 - 31），用于转换 sl->vl
sl2sc/	(RO) 32 个文件（0 - 31），用于转换 sl->sc
vl2mtu/	(RO) 16 个文件（0 - 15），用于确定 vl 的 MTU

/sys/class/infiniband/hfi1_X/sdma_<N>/cpu_list

/sys/class/infiniband/hfi1_X/sdma_<N>/vl

定义于文件 sysfs-class-infiniband

sdma<N>/ 包含每个 sdma 引擎（0 - 15）一个目录

cpu_list	(RW) 用户进程到 sdma 引擎分配的 CPU 列表。
vl	(RO) 显示 sdma 引擎映射到的虚拟通道 (vl)。

此接口允许用户控制设备的亲和性设置。例如，要设置 sdma 引擎中断亲和性和用户进程的线程亲和性，以使用在 NUMA 配置或物理 CPU 位置方面“接近”的 sdma 引擎，用户将执行

echo "3" > /proc/irq/<N>/smp_affinity_list
echo "4-7" > /sys/devices/.../sdma3/cpu_list
cat /sys/devices/.../sdma3/vl
0
echo "8" > /proc/irq/<M>/smp_affinity_list
echo "9-12" > /sys/devices/.../sdma4/cpu_list
cat /sys/devices/.../sdma4/vl
1

确保当进程在 CPU 4、5、6 或 7 上运行并使用 vl=0 时，驱动程序选择 sdma 引擎 3，并且 sdma 引擎 3 的中断被引导到 CPU 3。类似地，当进程在 CPU 9、10、11 或 12 上运行并设置 vl=1 时，将选择引擎 4，并且 sdma 引擎 4 的中断被引导到 CPU 8。这假定在上述 N 是“sdma3”的中断号，M 是 /proc/interrupts 文件中“sdma4”的中断号。

适用于 QLogic qedr NIC 驱动程序的 sysfs 接口

/sys/class/infiniband/mlx4_X/hw_rev

/sys/class/infiniband/mlx4_X/hca_type

/sys/class/infiniband/mlx4_X/board_id

定义于文件 sysfs-class-infiniband

hw_rev	(RO) 硬件版本号
hca_type	(RO) 主机通道适配器类型
board_id	(RO) 制造板 ID

/sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled

/sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/enable_smi_admin

定义于文件 sysfs-class-infiniband

为选定的 VF/端口在 VF 上启用 QP0。默认情况下，没有 VF 启用 QP0 操作。

smi_enabled	(RO)	指示指定的 VF/端口当前是否已启用 SMI
enable_smi_admin	(RW)	由管理员用于请求为指定的 VF/端口启用或禁用 SMI 功能。0 = 禁用，1 = 启用。

请求的启用将在 VF 下次复位时发生（例如，拥有 VF 的 VM 上的驱动程序重启）。

适用于 Chelsio T4/T5 RDMA 驱动程序 (cxgb4) 的 sysfs 接口

/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/admin_guids/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/pkeys/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/mcgs/

/sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/gid_idx/0

/sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/pkey_idx/<n>

定义于文件 sysfs-class-infiniband

sysfs iov 目录用于管理和检查端口 P_Key 和 GUID 半虚拟化。此目录仅为主机添加——从机没有。

在 iov/ports 下，管理员可以检查设备中存在的 GID 和 P_Key 表（以及 SM 呈现的“网络视图”中看到的）。

“pkeys”和“gids”子目录分别包含端口 P_Key 或 GID 表中每个条目的一个文件。例如，ports/1/pkeys/10 包含端口 1 的 P_Key 表中索引 10 处的值。

gids/<n>	(RO) 物理端口 GID，n = 0..127
admin_guids/<n>	(RW) 允许检查或更改给定 GUID 的管理状态，n = 0..127
pkeys/<n>	(RO) 显示物理密钥表的内容，n = 0..126
mcgs/	(RO) 多播组表
<m>/gid_idx/0	(RO) 显示 GID 映射，m = 1..2
<m>/pkey_idx/<n>	(RW) 可写，但 RoCE pkey 除外。m = 1..2, n = 0..126 在 iov/<pci 插槽号> 目录下，管理员可以将物理表中的索引号（如 iov/ports 下所示）映射到客户机看到的半虚拟化索引号。例如，如果管理员在客户机 2 上将端口 1 的物理 Pkey 索引 10 映射到虚拟索引 1，则该客户机无论何时使用其 Pkey 索引 1，实际上都将使用真实的 Pkey 索引 10。

/sys/class/infiniband/mlx5_X/hw_rev

/sys/class/infiniband/mlx5_X/hca_type

/sys/class/infiniband/mlx5_X/reg_pages

/sys/class/infiniband/mlx5_X/fw_pages

定义于文件 sysfs-class-infiniband

[待文档化]

适用于 Cisco VIC (usNIC) Verbs 驱动程序的 sysfs 接口

/sys/class/infiniband/mthcaX/hw_rev

/sys/class/infiniband/mthcaX/hca_type

/sys/class/infiniband/mthcaX/board_id

定义于文件 sysfs-class-infiniband

hw_rev	(RO) 硬件版本号
hca_type	(RO) 主机通道适配器类型：MT23108、MT25208 (MT23108 兼容模式)、MT25208 或 MT25204
board_id	(RO) 制造板 ID

适用于 Mellanox ConnectX HCA IB 驱动程序 (mlx4) 的 sysfs 接口

/sys/class/infiniband/ocrdmaX/hca_type

定义于文件 sysfs-class-infiniband

hca_type: (RO) 显示固件版本

适用于 Intel Omni-Path 驱动程序 (HFI1) 的 sysfs 接口

/sys/class/infiniband/ocrdmaX/hw_rev

定义于文件 sysfs-class-infiniband

hw_rev: (RO) 硬件版本号

/sys/class/infiniband/qedrX/hw_rev

/sys/class/infiniband/qedrX/hca_type

定义于文件 sysfs-class-infiniband

hw_rev	(RO)	硬件版本号
hca_type	(RO)	显示 HCA 类型

适用于 VMware 半虚拟化 RDMA 驱动程序的 sysfs 接口

/sys/class/infiniband/qibX/ports/<N>/CCMgtA/cc_settings_bin

/sys/class/infiniband/qibX/ports/<N>/CCMgtA/cc_table_bin

定义于文件 sysfs-class-infiniband

每端口拥塞控制。两者都是二进制属性。

cc_table_bin	(RO) 拥塞控制表大小，后跟表条目。
cc_settings_bin	(RO) 拥塞设置：端口控制、控制映射和拥塞条目的 16 个条目数组 - 增加、计时器、事件日志触发阈值和最小注入速率延迟。

/sys/class/infiniband/qibX/ports/<N>/diag_counters/rc_resends

/sys/class/infiniband/qibX/ports/<N>/diag_counters/seq_naks

/sys/class/infiniband/qibX/ports/<N>/diag_counters/rdma_seq

/sys/class/infiniband/qibX/ports/<N>/diag_counters/rnr_naks

/sys/class/infiniband/qibX/ports/<N>/diag_counters/other_naks

/sys/class/infiniband/qibX/ports/<N>/diag_counters/rc_timeouts

/sys/class/infiniband/qibX/ports/<N>/diag_counters/look_pkts

/sys/class/infiniband/qibX/ports/<N>/diag_counters/pkt_drops

/sys/class/infiniband/qibX/ports/<N>/diag_counters/dma_wait

/sys/class/infiniband/qibX/ports/<N>/diag_counters/unaligned

定义于文件 sysfs-class-infiniband

[待文档化]

适用于 Mellanox Connect-IB HCA 驱动程序 mlx5 的 sysfs 接口

/sys/class/infiniband/qibX/ports/<N>/linkstate/loopback

/sys/class/infiniband/qibX/ports/<N>/linkstate/led_override

/sys/class/infiniband/qibX/ports/<N>/linkstate/hrtbt_enable

/sys/class/infiniband/qibX/ports/<N>/linkstate/status

/sys/class/infiniband/qibX/ports/<N>/linkstate/status_str

定义于文件 sysfs-class-infiniband

[待文档化]

loopback	(WO)
led_override	(WO)
hrtbt_enable	(RW)
status	(RO)
status_str	(RO) 显示有关链路状态、可能的电缆/交换机问题和硬件错误的信息。可能的状态包括：“Initted”（已初始化）、“Present”（存在）、“IB_link_up”（IB 链路已启动）、“IB_configured”（IB 已配置）或“Fatal_Hardware_Error”（致命硬件错误）。

/sys/class/infiniband/qibX/ports/<N>/sl2vl/[0-15]

定义于文件 sysfs-class-infiniband

(RO) 该目录包含 16 个文件（编号 0-15），用于指定服务级别 (SL)。列出 SL 文件将返回由 SL 编程的虚拟通道 (VL)。

/sys/class/infiniband/qibX/version

/sys/class/infiniband/qibX/hw_rev

/sys/class/infiniband/qibX/hca_type

/sys/class/infiniband/qibX/board_id

/sys/class/infiniband/qibX/boardversion

/sys/class/infiniband/qibX/nctxts

/sys/class/infiniband/qibX/localbus_info

/sys/class/infiniband/qibX/tempsense

/sys/class/infiniband/qibX/serial

/sys/class/infiniband/qibX/nfreectxts

/sys/class/infiniband/qibX/chip_reset

定义于文件 sysfs-class-infiniband

version	(RO) 显示已安装软件和驱动程序的版本信息。
hw_rev	(RO) 硬件版本号
hca_type	(RO) 主机通道适配器类型
board_id	(RO) 制造板 ID
boardversion	(RO) 芯片架构的当前版本
nctxts	(RO) 返回可用用户端口（上下文）的数量
localbus_info	(RO) 人类可读的本地总线信息
tempsense	(RO) 以十进制显示温度传感器寄存器
serial	(RO) HCA 的序列号
nfreectxts	(RO) 可用的空闲用户端口（上下文）数量。
chip_reset	(WO) 如果可能，通过将“reset”写入此文件来复位芯片。仅当没有使用芯片资源的用户上下文打开时才允许。

/sys/class/infiniband/usnic_X/board_id

/sys/class/infiniband/usnic_X/config

/sys/class/infiniband/usnic_X/qp_per_vf

/sys/class/infiniband/usnic_X/max_vf

/sys/class/infiniband/usnic_X/cq_per_vf

/sys/class/infiniband/usnic_X/iface

定义于文件 sysfs-class-infiniband

board_id	(RO) 制造板 ID
config	(RO) 报告此 PF 的配置
qp_per_vf	（只读）每个虚拟功能的队列对。
max_vf	（只读）最大虚拟功能数量
cq_per_vf	（只读）每个虚拟功能的完成队列
iface	（只读）显示此 usNIC 条目关联的网络接口（可通过 ifconfig 查看）。

/sys/class/infiniband/usnic_X/qpn/summary

/sys/class/infiniband/usnic_X/qpn/context

定义于文件 sysfs-class-infiniband

[待文档化]

Emulex RoCE HCA 驱动程序的 sysfs 接口

/sys/class/infiniband/vmw_pvrdmaX/hw_rev

/sys/class/infiniband/vmw_pvrdmaX/hca_type

/sys/class/infiniband/vmw_pvrdmaX/board_id

定义于文件 sysfs-class-infiniband

hw_rev	(RO)	硬件版本号
hca_type	(RO)	主机通道适配器类型
board_id	(RO)	显示 PVRDMA 制造商板 ID

Broadcom NetXtreme-E RoCE 驱动程序的 sysfs 接口

/sys/class/infiniband_mad/abi_version

定义于文件 sysfs-class-infiniband

（只读）如果进行任何破坏 umad 和 issm 设备的用户空间 ABI 兼容性的更改，则该值会递增。

/sys/class/infiniband_mad/umad<N>/ibdev

/sys/class/infiniband_mad/umad<N>/port

/sys/class/infiniband_mad/issm<N>/ibdev

/sys/class/infiniband_mad/issm<N>/port

定义于文件 sysfs-class-infiniband

每个 InfiniBand 设备的每个端口都附加了一个“umad”设备和一个“issm”设备。例如，一个双端口 HCA 将有两个 umad 设备和两个 issm 设备，而一个交换机将有一个每种类型的设备（用于交换机端口 0）。

ibdev	（只读）显示 InfiniBand (IB) 设备名称
port	（只读）显示端口号

/sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target

定义于文件 sysfs-driver-ib_srp

用于使 ib_srp 连接到新目标的接口。可以通过向此 sysfs 属性写入逗号分隔的登录参数列表来请求 ib_srp 连接到新目标。支持的参数有：

id_ext，一个 16 位十六进制数，指定 16 字节 SRP 目标端口标识符中的八字节标识符扩展。ib_srp 在 SRP_LOGIN_REQ 请求中将目标端口标识符发送给目标。
ioc_guid，一个 16 位十六进制数，指定 16 字节目标端口标识符中的八字节 I/O 控制器 GUID 部分。
dgid，一个 32 位十六进制数，指定目标 GID。
pkey，一个四位十六进制数，指定 InfiniBand 分区密钥。
service_id，一个 16 位十六进制数，指定用于与 SRP 目标建立通信的 InfiniBand 服务 ID。如何查找服务 ID 的值在 SRP 目标的文档中指定。
max_sect，一个十进制数，指定通过单个 SCSI 命令传输的最大 512 字节扇区数。
max_cmd_per_lun，一个十进制数，指定单个 LUN 的最大未完成命令数。
io_class，一个十六进制数，指定 SRP I/O 类。必须是 0xff00 (rev 10) 或 0x0100 (rev 16a)。I/O 类定义 SRP 发起方和目标端口标识符的格式。
initiator_ext，一个 16 位十六进制数，指定 SRP 发起方端口标识符的标识符扩展部分。此数据由发起方在 SRP_LOGIN_REQ 请求中发送给目标。
cmd_sg_entries，一个介于 1..255 之间的数字，指定存储在 SRP_CMD 信息单元本身中的最大数据缓冲区描述符数量。当 allow_ext_sg=0 时，参数 cmd_sg_entries 定义单个 SRP_CMD 的最大 S/G 列表长度，并且 S/G 列表折叠后长度超过此限制的命令将失败。
allow_ext_sg，是否允许 ib_srp 在 SRP_CMD 中包含部分内存描述符列表而不是整个列表。如果 SRP_CMD 中包含部分内存描述符列表，则剩余的内存描述符通过额外的 RDMA 传输从发起方传达给目标。将 allow_ext_sg 设置为 1 会增加发起方和目标之间通过单个 SCSI 命令可传输的最大数据量。由于并非所有 SRP 目标实现都支持部分内存描述符列表，因此此选项的默认值为 0。
sg_tablesize，一个介于 1..2048 之间的数字，指定 SCSI 层允许传递给 ib_srp 的最大 S/G 列表长度。指定超过 cmd_sg_entries 的值仅在启用部分内存描述符列表支持 (allow_ext_sg=1) 的情况下才安全。
comp_vector，一个介于 0..n-1 之间的数字，指定第一个 RDMA 通道的 MSI-X 完成向量。某些 HCA 为每个 HCA 端口分配多个 (n) MSI-X 向量。如果这些中断的 IRQ 亲和性掩码已配置为使每个 MSI-X 中断由不同的 CPU 处理，则可以使用 comp_vector 参数将 SRP 完成工作负载分散到多个 CPU 上。
tl_retry_count，一个介于 2..7 之间的数字，指定 IB RC 重试计数。
queue_size，发起方允许每个 SCSI 主机排队的最大命令数。此参数的默认值为 62。支持的最低值为 2。
max_it_iu_size，一个十进制数，指定发起方到目标信息单元的最大长度。

/sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev

定义于文件 sysfs-driver-ib_srp

HCA 名称（<hca>）。

/sys/class/infiniband_srp/srp-<hca>-<port_number>/port

定义于文件 sysfs-driver-ib_srp

HCA 端口号（<port_number>）。

/sys/class/infiniband_verbs/abi_version

定义于文件 sysfs-class-infiniband

（只读）如果进行任何破坏 uverbs 设备的用户空间 ABI 兼容性的更改，则该值会递增。

Mellanox IB HCA 低级驱动程序 (mthca) 的 sysfs 接口

/sys/class/infiniband_verbs/uverbs<N>/ibdev

/sys/class/infiniband_verbs/uverbs<N>/abi_version

定义于文件 sysfs-class-infiniband

ibdev	（只读）显示 InfiniBand (IB) 设备名称
abi_version	（只读）显示 IB 设备特定接口的 ABI 版本。

/sys/class/rfkill

定义于文件 sysfs-class-rfkill

rfkill 类子系统文件夹。每个已注册的 rfkill 驱动程序由一个 rfkillX 子文件夹表示（X 是一个大于等于 0 的整数）。

/sys/class/rfkill/rfkill[0-9]+/hard

定义于文件 sysfs-class-rfkill

当前硬锁定状态。此文件只读。值：一个数值。

0: 非活动
发射器（可能）处于活动状态。

1: 活动
发射器被驱动程序无法控制的外部因素强制关闭。

/sys/class/rfkill/rfkill[0-9]+/name

定义于文件 sysfs-class-rfkill

驱动程序分配给此密钥的名称（接口或驱动程序名称）。值：任意字符串。

/sys/class/rfkill/rfkill[0-9]+/persistent

定义于文件 sysfs-class-rfkill

软阻塞状态是否在启动时从非易失性存储初始化。值：一个数值

0: 否

1: 是

/sys/class/rfkill/rfkill[0-9]+/soft

定义于文件 sysfs-class-rfkill

当前软阻塞状态。此文件可读写。值：一个数值。

0: 非活动
发射器（可能）处于活动状态。

1: 活动
发射器被软件关闭。

/sys/class/rfkill/rfkill[0-9]+/state

定义于文件 sysfs-class-rfkill

发射器当前状态。此文件原定于 2014 年移除，但由于其用户数量众多，将再保留一段时间。尽管它被标记为稳定，但应优先使用较新的“hard”和“soft”接口，因为通过此接口无法表达 rfkill 驱动程序的“软硬阻塞”状态。未来可能会再次尝试移除它。值：一个数值。

0: RFKILL_STATE_SOFT_BLOCKED
发射器被软件关闭

1: RFKILL_STATE_UNBLOCKED
发射器（可能）处于活动状态

2: RFKILL_STATE_HARD_BLOCKED
发射器被驱动程序无法控制的外部因素强制关闭。

/sys/class/rfkill/rfkill[0-9]+/type

定义于文件 sysfs-class-rfkill

驱动程序类型字符串（“wlan”、“bluetooth”等）。值：参见 include/linux/rfkill.h。

/sys/class/scsi_host/host<n>/allow_ext_sg

定义于文件 sysfs-driver-ib_srp

ib_srp 在与 SRP 目标通信时是否允许在 SRP_CMD 中包含部分内存描述符列表。

/sys/class/scsi_host/host<n>/ch_count

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标通信的 RDMA 通道数。

/sys/class/scsi_host/host<n>/cmd_sg_entries

定义于文件 sysfs-driver-ib_srp

可在单个 SRP_CMD 请求中发送给目标的最大数据缓冲区描述符数。

/sys/class/scsi_host/host<n>/comp_vector

定义于文件 sysfs-driver-ib_srp

用于第一个 RDMA 通道的完成向量。

/sys/class/scsi_host/host<n>/dgid

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标通信的 InfiniBand 目标 GID。如果发生端口重定向，则与 orig_dgid 不同。

/sys/class/scsi_host/host<n>/id_ext

定义于文件 sysfs-driver-ib_srp

16 字节目标端口标识符的八字节标识符扩展部分。

/sys/class/scsi_host/host<n>/ioc_guid

定义于文件 sysfs-driver-ib_srp

16 字节目标端口标识符的八字节 I/O 控制器 GUID 部分。

/sys/class/scsi_host/host<n>/local_ib_device

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标通信的 InfiniBand HCA 名称。

/sys/class/scsi_host/host<n>/local_ib_port

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标通信的 HCA 端口号。

/sys/class/scsi_host/host<n>/orig_dgid

定义于文件 sysfs-driver-ib_srp

在写入 add_target sysfs 属性的参数中指定的 InfiniBand 目标 GID。

/sys/class/scsi_host/host<n>/pkey

定义于文件 sysfs-driver-ib_srp

一个 16 位数字，表示用于与 SRP 目标通信的 InfiniBand 分区密钥。

/sys/class/scsi_host/host<n>/req_lim

定义于文件 sysfs-driver-ib_srp

在必须等待更多信用之前，ib_srp 可以发送给目标的请求数。有关更多信息，另请参阅 SRP 规范中的 SRP 信用算法。

/sys/class/scsi_host/host<n>/service_id

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标建立通信的 InfiniBand 服务 ID。

/sys/class/scsi_host/host<n>/sgid

定义于文件 sysfs-driver-ib_srp

用于与 SRP 目标通信的源端口的 InfiniBand GID。

/sys/class/scsi_host/host<n>/zero_req_lim

定义于文件 sysfs-driver-ib_srp

发起方因信用不足而不得不等待才能向目标发送请求的次数。有关更多信息，另请参阅 SRP 规范中的 SRP 信用算法。

/sys/class/srp_remote_ports/port-<h>:<n>/delete

定义于文件 sysfs-transport-srp

指示 SRP 发起方断开与目标的连接并移除从该目标导入的所有 LUN。

/sys/class/srp_remote_ports/port-<h>:<n>/dev_loss_tmo

定义于文件 sysfs-transport-srp

在观察到传输层错误后，SCSI 层将等待的秒数，然后移除目标端口。零表示立即移除。将此属性设置为“off”将禁用 dev_loss 计时器。

/sys/class/srp_remote_ports/port-<h>:<n>/fast_io_fail_tmo

定义于文件 sysfs-transport-srp

在观察到传输层错误后，SCSI 层将等待的秒数，然后使 I/O 失败。零表示立即使 I/O 失败。将此属性设置为“off”将禁用 fast_io_fail 计时器。

/sys/class/srp_remote_ports/port-<h>:<n>/port_id

定义于文件 sysfs-transport-srp

16 字节本地 SRP 端口标识符，十六进制格式。示例：4c:49:4e:55:58:20:56:49:4f:00:00:00:00:00:00:00。

/sys/class/srp_remote_ports/port-<h>:<n>/reconnect_delay

定义于文件 sysfs-transport-srp

在重新连接尝试失败后，SCSI 层将等待的秒数，然后重试。将此属性设置为“off”将禁用基于时间的重新连接。

/sys/class/srp_remote_ports/port-<h>:<n>/roles

定义于文件 sysfs-transport-srp

远程端口的角色。“SRP Initiator”或“SRP Target”。

/sys/class/srp_remote_ports/port-<h>:<n>/state

定义于文件 sysfs-transport-srp

用于与远程端口通信的传输层状态。“running”表示传输层正常运行；“blocked”表示已遇到传输层错误但 fast_io_fail_tmo 计时器尚未触发；“fail-fast”表示 fast_io_fail_tmo 计时器已触发且“dev_loss_tmo”计时器尚未触发；“lost”表示“dev_loss_tmo”计时器已触发且端口最终被移除之前。

/sys/class/tpm/tpmX/device/

定义于文件 sysfs-class-tpm

特定 TPM 实例下的 device/ 目录公开了该 TPM 芯片的属性

/sys/class/tpm/tpmX/device/active

定义于文件 sysfs-class-tpm

如果 TPM 芯片接受命令，“active”属性将打印“1”。非活动的 TPM 芯片仍然包含活动芯片的所有状态（存储根密钥、NVRAM 等），并且可以对操作系统可见，但只接受受限制的命令集。有关可用命令的更多信息，请参见 TPM 主规范第 2 部分，结构，第 17 节。

/sys/class/tpm/tpmX/device/cancel

定义于文件 sysfs-class-tpm

“cancel”属性允许您取消当前挂起的 TPM 命令。向 cancel 写入任何值都将调用 TPM 供应商特定的取消操作。

/sys/class/tpm/tpmX/device/caps

定义于文件 sysfs-class-tpm

“caps”属性包含 TPM 制造商和版本信息。

示例输出

Manufacturer: 0x53544d20
TCG version: 1.2
Firmware version: 8.16

制造商是 TPM 中 4 字节制造商信息空间的十六进制转储。TCG 版本显示芯片支持的 TCG TPM 规范级别。固件版本是芯片的固件版本，并且是制造商特定的。

/sys/class/tpm/tpmX/device/durations

定义于文件 sysfs-class-tpm

“durations”属性显示用于等待短、中、长 TPM 命令的 3 个供应商特定值。所有 TPM 命令在执行时间上都被归类为短、中或长，以便驱动程序不必等待超过必要的时间即可开始轮询结果。

示例输出

3015000 4508000 180995000 [original]

此处短、中、长持续时间以微秒显示。“[original]”表示这些值未修改地从芯片中查询时显示。在错误芯片以毫秒而非微秒报告它们且需要进行缩放以微秒显示的情况下，可以修改持续时间。在这种情况下，“[adjusted]”将取代“[original]”。

/sys/class/tpm/tpmX/device/enabled

定义于文件 sysfs-class-tpm

如果 TPM 芯片已启用，即它应该对操作系统可见，“enabled”属性将打印“1”。此属性可能可见但在禁用 TPM 的某些操作后产生“0”。

/sys/class/tpm/tpmX/device/owned

定义于文件 sysfs-class-tpm

如果 TPM_TakeOwnership 序数在芯片中成功执行，“owned”属性将产生“1”。“0”表示尚未取得所有权。

/sys/class/tpm/tpmX/device/pcrs

定义于文件 sysfs-class-tpm

“pcrs”属性将转储 TPM 中所有平台配置寄存器的当前值。请注意，由于这些值可能不断变化，因此输出仅在特定时间点有效。

示例输出

PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
...

PCR 的数量和表示 PCR 值所需的十六进制字节数将因 TPM 芯片版本而异。对于 TPM 1.1 和 1.2 芯片，PCR 表示 SHA-1 哈希，长度为 20 字节。使用“caps”属性确定 TPM 版本。

/sys/class/tpm/tpmX/device/pubek

定义于文件 sysfs-class-tpm

“pubek”属性如果可能，将返回 TPM 的公共背书密钥。如果 TPM 已建立所有权且版本为 1.2，则未经所有者授权，将无法获取 pubek。由于 TPM 驱动程序不存储任何秘密，因此它无法授权其自身对 pubek 的请求，使其无法访问。公共背书密钥在 TPM 制造时生成，并存在于芯片的整个生命周期。

示例输出

Algorithm: 00 00 00 01
Encscheme: 00 03
Sigscheme: 00 01
Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
Modulus length: 256
Modulus:
B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B

可能的值

Algorithm:    TPM_ALG_RSA                     (1)
Encscheme:    TPM_ES_RSAESPKCSv15             (2)
              TPM_ES_RSAESOAEP_SHA1_MGF1      (3)
Sigscheme:    TPM_SS_NONE                     (1)
Parameters, a byte string of 3 u32 values:
      Key Length (bits):      00 00 08 00     (2048)
      Num primes:             00 00 00 02     (2)
      Exponent Size:          00 00 00 00     (0 means the
                                               default exp)
Modulus Length: 256 (bytes)
Modulus:      The 256 byte Endorsement Key modulus

/sys/class/tpm/tpmX/device/temp_deactivated

定义于文件 sysfs-class-tpm

如果芯片已暂时停用（通常直到下一个电源周期），“temp_deactivated”属性将返回“1”。热启动（重启）是否会清除 TPM 芯片的 temp_deactivated 状态取决于平台。

/sys/class/tpm/tpmX/device/timeouts

定义于文件 sysfs-class-tpm

“timeouts”属性显示 TPM 接口规范超时的 4 个供应商特定值。这些超时的使用由芯片遵循的 TPM 接口规范定义。

示例输出

750000 750000 750000 750000 [original]

四个超时值以微秒显示，末尾带有“[original]”或“[adjusted]”，具体取决于这些值是否由驱动程序从毫秒缩放以微秒报告。

/sys/class/tpm/tpmX/pcr-<H>/<N>

定义于文件 sysfs-class-tpm

以紧凑的十六进制表示法输出哈希库 H 中 PCR 号 N 的值。N 是 PCR 号的数值，H 是哈希的加密字符串表示。

示例输出

cat /sys/class/tpm/tpm0/pcr-sha256/7
2ED93F199692DC6788EFA6A1FE74514AB9760B2A6CEEAEF6C808C13E4ABB0D42

/sys/class/tpm/tpmX/tpm_version_major

定义于文件 sysfs-class-tpm

“tpm_version_major”属性显示 TPM 设备实现的 TCG 规范主要版本。

示例输出

/sys/class/ubi/

定义于文件 sysfs-class-ubi

ubi/ 类子目录属于 UBI 子系统，提供通用的 UBI 信息、每个 UBI 设备的信息和每个 UBI 卷的信息。

/sys/class/ubi/ubiX/avail_eraseblocks

定义于文件 sysfs-class-ubi

可用逻辑擦除块的数量。例如，可以创建一个具有此数量逻辑擦除块的新 UBI 卷。

/sys/class/ubi/ubiX/bad_peb_count

定义于文件 sysfs-class-ubi

底层 MTD 设备上的坏物理擦除块计数。

/sys/class/ubi/ubiX/bgt_enabled

定义于文件 sysfs-class-ubi

如果 UBI 后台线程被禁用，则包含 ASCII“0n”，如果启用，则包含 ASCII“1n”。

/sys/class/ubi/ubiX/dev

定义于文件 sysfs-class-ubi

此 UBI 设备对应的字符设备的主次号（以 <major>:<minor> 格式）。

/sys/class/ubi/ubiX/eraseblock_size

定义于文件 sysfs-class-ubi

此 UBI 设备可能提供的最大逻辑擦除块大小。由于对齐，UBI 卷可能具有较小的逻辑擦除块大小。

/sys/class/ubi/ubiX/max_ec

定义于文件 sysfs-class-ubi

最大物理擦除块擦除计数器值。

/sys/class/ubi/ubiX/max_vol_count

定义于文件 sysfs-class-ubi

此 UBI 设备可以拥有的最大卷数。

/sys/class/ubi/ubiX/min_io_size

定义于文件 sysfs-class-ubi

最小输入/输出单元大小。所有 I/O 只能以包含数字的分数完成。

/sys/class/ubi/ubiX/mtd_num

定义于文件 sysfs-class-ubi

底层 MTD 设备的编号。

/sys/class/ubi/ubiX/reserved_for_bad

定义于文件 sysfs-class-ubi

为坏块处理保留的物理擦除块数量。

/sys/class/ubi/ubiX/ro_mode

定义于文件 sysfs-class-ubi

如果此设备上设置了只读标志，则包含 ASCII“1n”，如果清除，则包含“0n”。当检测到不可恢复的错误时，UBI 设备会将自身标记为只读。

/sys/class/ubi/ubiX/total_eraseblocks

定义于文件 sysfs-class-ubi

底层 MTD 设备上好（未标记为坏）物理擦除块的总数。

/sys/class/ubi/ubiX/ubiX_Y/

定义于文件 sysfs-class-ubi

/sys/class/ubi/ubiX/ubiX_0/、/sys/class/ubi/ubiX/ubiX_1/ 等目录描述了 UBI 设备 X 上的 UBI 卷（卷 0、1 等）。

/sys/class/ubi/ubiX/ubiX_Y/alignment

定义于文件 sysfs-class-ubi

卷对齐 - 此卷的逻辑擦除块大小必须对齐的值。例如，2048 意味着逻辑擦除块大小是 2048 的倍数。换句话说，卷逻辑擦除块大小是 UBI 设备逻辑擦除块大小对齐到对齐值。

/sys/class/ubi/ubiX/ubiX_Y/corrupted

定义于文件 sysfs-class-ubi

如果 UBI 卷正常，则包含 ASCII“0n”，如果损坏（例如，由于卷更新中断），则包含 ASCII“1n”。

/sys/class/ubi/ubiX/ubiX_Y/data_bytes

定义于文件 sysfs-class-ubi

此卷包含的数据量。此值仅对静态卷有意义，对于动态卷，它等同于以字节为单位的总卷大小。

/sys/class/ubi/ubiX/ubiX_Y/dev

定义于文件 sysfs-class-ubi

此 UBI 卷对应的字符设备的主次号（以 <major>:<minor> 格式）。

/sys/class/ubi/ubiX/ubiX_Y/name

定义于文件 sysfs-class-ubi

卷名称。

/sys/class/ubi/ubiX/ubiX_Y/reserved_ebs

定义于文件 sysfs-class-ubi

为该卷保留的物理擦除块计数。等同于逻辑擦除块中的卷大小。

/sys/class/ubi/ubiX/ubiX_Y/type

定义于文件 sysfs-class-ubi

卷类型。动态卷包含 ASCII“dynamicn”，静态卷包含“staticn”。

/sys/class/ubi/ubiX/ubiX_Y/upd_marker

定义于文件 sysfs-class-ubi

如果未为此卷设置更新标记，则包含 ASCII“0n”，如果已设置，则包含“1n”。更新标记在卷更新开始时设置，在结束时清除。因此，更新标记的存在表示该卷在更新中断时正在更新。后者可以使用“corrupted”sysfs 文件检查。

/sys/class/ubi/ubiX/ubiX_Y/usable_eb_size

定义于文件 sysfs-class-ubi

此卷的逻辑擦除块大小。等同于设备逻辑擦除块大小对齐到卷对齐值。

/sys/class/ubi/ubiX/volumes_count

定义于文件 sysfs-class-ubi

此 UBI 设备上的卷数。

/sys/class/ubi/version

定义于文件 sysfs-class-ubi

此文件包含最新支持的 UBI 媒体上格式的版本。目前是 1，没有计划更改。但是，如果未来 UBI 需要无法以兼容方式完成的闪存上格式更改，则将添加新的格式版本。因此，这是一种可能在未来实现向后兼容（但向前不兼容）改进的机制。

/sys/class/ubiX/

定义于文件 sysfs-class-ubi

/sys/class/ubi0、/sys/class/ubi1 等目录描述 UBI 设备（UBI 设备 0、1 等）。它们包含通用的 UBI 设备信息和每个 UBI 卷的信息（每个 UBI 设备可以有许多 UBI 卷）

/sys/class/udc/<udc>/a_alt_hnp_support

定义于文件 sysfs-class-udc

指示 OTG A-Host 是否支持在备用端口进行 HNP。

/sys/class/udc/<udc>/a_hnp_support

定义于文件 sysfs-class-udc

指示 OTG A-Host 是否支持在此端口进行 HNP。

/sys/class/udc/<udc>/b_hnp_enable

定义于文件 sysfs-class-udc

指示 OTG A-Host 是否启用了 HNP 支持。

/sys/class/udc/<udc>/current_speed

定义于文件 sysfs-class-udc

指示此端口当前的协商速度。

/sys/class/udc/<udc>/function

定义于文件 sysfs-class-udc

打印当前运行的 USB Gadget 驱动程序的名称。

/sys/class/udc/<udc>/is_a_peripheral

定义于文件 sysfs-class-udc

指示此端口是 OTG 会话上的默认主机，但使用了 HNP 来切换角色。

/sys/class/udc/<udc>/is_otg

定义于文件 sysfs-class-udc

指示此端口支持 OTG。

/sys/class/udc/<udc>/maximum_speed

定义于文件 sysfs-class-udc

指示此端口支持的最大 USB 速度。

/sys/class/udc/<udc>/soft_connect

定义于文件 sysfs-class-udc

允许用户断开数据上拉电阻，从而导致与 USB 主机的逻辑断开。

/sys/class/udc/<udc>/srp

定义于文件 sysfs-class-udc

允许用户手动启动会话请求协议。

/sys/class/udc/<udc>/state

定义于文件 sysfs-class-udc

指示 USB 设备控制器当前状态。有效状态为：“not-attached”、“attached”、“powered”、“reconnecting”、“unauthenticated”、“default”、“addressed”、“configured”和“suspended”；但并非所有 USB 设备控制器都支持报告所有状态。

/sys/devices 下的符号¶

/sys/devices/*/dev

定义于文件 sysfs-devices

设备对应字符设备的主次号（以 <major>:<minor> 格式）。

/sys/devices/*/devspec

定义于文件 sysfs-devices

如果 CONFIG_OF 启用，则此文件存在。读取时，它返回设备节点的完整名称。

/sys/devices/*/obppath

定义于文件 sysfs-devices

如果 CONFIG_OF 启用，则此文件存在。读取时，它返回设备节点的完整名称。

/sys/devices/*/of_node

定义于文件 sysfs-devices

任何与设备树节点关联的设备都将有一个 of_path 符号链接，指向 /sys/firmware/devicetree/ 中对应的设备节点

/sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/keep_cfg

定义于文件 sysfs-driver-misc-cp500

标志，指示 FPGA 在复位时应保持还是重新加载配置比特流。正常的 FPGA 行为和默认设置是保持配置比特流，并且只复位已配置的逻辑。

复位时重新加载配置可以通过简单的重新启动更新配置比特流。否则，需要对设备进行电源循环才能重新加载新的配置比特流。

此文件可读写。值如下：1 = 复位时保持配置比特流，默认 0 = 复位时重新加载配置比特流

用户: KEBA

/sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/version

定义于文件 sysfs-driver-misc-cp500

FPGA 配置比特流的版本，作为可打印字符串。此文件只读。

用户: KEBA

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/cap

定义于文件 sysfs-driver-dma-ioatdma

DMA 支持的功能。目前有 DMA_PQ、DMA_PQ_VAL、DMA_XOR、DMA_XOR_VAL、DMA_INTERRUPT。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/intr_coalesce

定义于文件 sysfs-driver-dma-ioatdma

可调的每个通道中断延迟值。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_active

定义于文件 sysfs-driver-dma-ioatdma

环中活动的描述符数量。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_size

定义于文件 sysfs-driver-dma-ioatdma

描述符环大小，可用的描述符总数。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/version

定义于文件 sysfs-driver-dma-ioatdma

ioatdma 设备版本。

/sys/devices/platform/firmware\:zynqmp-firmware/feature_config_id

定义于文件 sysfs-driver-firmware-zynqmp

此 sysfs 接口允许用户在运行时配置功能。用户可以启用或禁用在固件中运行的功能，并且用户可以在运行时配置功能的参数。支持的功能是过温和外部看门狗。此处，外部看门狗与 /dev/watchdog 完全不同，因为外部看门狗在固件中运行，用于监控固件而不是 APU（Linux）的健康状况。此外，外部看门狗接口位于 zynqmp soc 之外。

支持的功能配置 ID 如下： 1. PM_FEATURE_OVERTEMP_STATUS = 1，用户可以启用或禁用过温功能。 2. PM_FEATURE_OVERTEMP_VALUE = 2，用户可以配置过温限制，单位为摄氏度。 3. PM_FEATURE_EXTWDT_STATUS = 3，用户可以启用或禁用外部看门狗功能。 4. PM_FEATURE_EXTWDT_VALUE = 4，用户可以配置外部看门狗功能。

用法

选择过温配置 ID 以启用/禁用功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

检查是否选择了过温配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 预期结果为 1。

选择过温配置 ID 以配置 OT 限制 # echo 2 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

检查是否选择了过温配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 预期结果为 2。

选择外部看门狗配置 ID 以启用/禁用功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

检查是否选择了外部看门狗配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 预期结果为 3。

选择外部看门狗配置 ID 以配置时间间隔 # echo 4 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

检查是否选择了外部看门狗配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 预期结果为 4。

用户: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/feature_config_value

定义于文件 sysfs-driver-firmware-zynqmp

此 sysfs 接口允许在运行时配置功能。用户可以启用或禁用在固件中运行的功能。此外，用户可以在运行时配置功能的参数。支持的功能是过温和外部看门狗。此处，外部看门狗与 /dev/watchdog 完全不同，因为外部看门狗在固件中运行，用于监控固件而不是 APU（Linux）的健康状况。此外，外部看门狗接口位于 zynqmp soc 之外。

默认情况下，固件中的功能是禁用的。用户可以通过查询相应的功能配置 ID 来启用功能。

过温的默认限制是 90 摄氏度。外部看门狗的默认定时器间隔是 570 毫秒。

支持的功能配置 ID 如下： 1. PM_FEATURE_OVERTEMP_STATUS = 1，用户可以启用或禁用过温功能。 2. PM_FEATURE_OVERTEMP_VALUE = 2，用户可以配置过温限制，单位为摄氏度。 3. PM_FEATURE_EXTWDT_STATUS = 3，用户可以启用或禁用外部看门狗功能。 4. PM_FEATURE_EXTWDT_VALUE = 4，用户可以配置外部看门狗功能。

用法

启用过温功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查过温功能是否已启用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 1。

禁用过温功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 0 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查过温功能是否已禁用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 0。

将过温限制配置为 50 摄氏度 # echo 2 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 50 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查过温限制是否已配置 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 50。

启用外部看门狗功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查外部看门狗功能是否已启用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 1。

禁用外部看门狗功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 0 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查外部看门狗功能是否已禁用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 0。

配置外部看门狗定时器间隔为 500 毫秒 # echo 4 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 500 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

检查外部看门狗定时器间隔是否已配置 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 预期结果为 500。

用户: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/ggs*

定义于文件 sysfs-driver-firmware-zynqmp

读/写 PMU 全局通用存储器寄存器值，GLOBAL_GEN_STORAGE{0:3}。全局通用存储器寄存器可用于系统在主设备之间传递信息。

该寄存器在系统或上电复位期间复位。FSBL 和其他 Xilinx 软件产品使用了三个寄存器：GLOBAL_GEN_STORAGE{4:6}。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0

用户: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/health_status

定义于文件 sysfs-driver-firmware-zynqmp

此 sysfs 接口允许设置健康状态。如果 PMUFW 使用 CHECK_HEALTHY_BOOT 编译，它将在 FPD WDT 过期时检查健康位。如果健康位由 Linux 中运行的用户应用程序设置，PMUFW 将只进行 APU 重启。如果在 FPD WDT 过期期间健康位未设置，PMUFW 将进行系统重启。

用法

设置健康位

# echo 1 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status

清除健康位

# echo 0 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status

用户: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/pggs*

定义于文件 sysfs-driver-firmware-zynqmp

读/写 PMU 持久全局通用存储器寄存器值，PERS_GLOB_GEN_STORAGE{0:3}。持久全局通用存储器寄存器可用于系统在主设备之间传递信息。

此寄存器仅在上电复位时复位，并通过系统复位保持其值。FSBL 和其他 Xilinx 软件产品使用了四个寄存器：PERS_GLOB_GEN_STORAGE{4:7}。该寄存器仅由 POR 复位。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0

用户: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

定义于文件 sysfs-driver-firmware-zynqmp

此 sysfs 接口允许设置下一次关机请求的关机范围。当执行下一次关机时，PSCI-system_off 的平台特定部分可以使用所选的关机范围。

以下是可用的关机范围（子类型）

subsystem: 只有 APU 及其所有未被其他处理单元使用的外设将被关闭。这可能导致 FPD 电源域被关闭，前提是没有其他处理单元使用 FPD 外设或 DRAM。
ps_only: 完整的 PS 将被关闭，包括 RPU、PMU 等。只有 PL 域（FPGA）保持不变。
system: 整个系统/设备被关闭。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
# echo <scope> > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
# echo "subsystem" > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

用户: Xilinx

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/boot_progress

定义于文件 sysfs-driver-mlxreg-io

这些文件显示数据处理单元板的启动进度状态。有效状态为：- 4 : 操作系统正在启动。- 5 : 操作系统正在运行。- 6 : 低功耗待机。

该文件只读。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/dpu_id

定义于文件 sysfs-driver-mlxreg-io

此文件显示数据处理单元板的硬件 ID。

该文件只读。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/perst_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/phy_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/tpm_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/usbphy_rst

定义于文件 sysfs-driver-mlxreg-io

这些文件允许重置数据处理单元板的硬件组件。分别是 PCI、以太网 PHY、TPM 和 USB PHY 的重置。所有属性的默认值都是 1。写入 0 将导致相关组件重置。

这些文件可读写。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_aux_pwr_or_reload

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_dpu_thermal

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_from_main_board

定义于文件 sysfs-driver-mlxreg-io

这些文件公开了数据处理单元（DPU）板最近一次重置的原因。可能的原因有：- 辅助电源中断或电源重新加载。- 热关机。- 主板发出的重置请求。文件中值为 1 表示这是重置原因，0 表示其他原因。同一时间只能有一个上述原因值为 1，表示最近一次的重置原因。

这些文件是只读的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/ufm_upgrade

定义于文件 sysfs-driver-mlxreg-io

这些文件显示统一网络管理器升级状态。0 - 表示升级完成，1 - 表示其他状态。

该文件只读。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/agb_spi_burn_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_spi_burn_en

定义于文件 sysfs-driver-mlxreg-io

这些文件允许烧录齿轮箱和 FPGA SPI 闪存。属性设置为 1 启用烧录，0 禁用烧录。如果系统处于锁定模式，则不允许写入这些文件。这些文件的目的是在生产流程中允许烧录线卡齿轮箱和 FPGA。

该文件可读写。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_pn

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version_min

定义于文件 sysfs-driver-mlxreg-io

这些文件显示线卡上 CPLD 设备已烧录的 CPLD 主次版本和部件号。

这些文件是只读的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld_upgrade_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_upgrade_en

定义于文件 sysfs-driver-mlxreg-io

这些文件允许 CPLD 和 FPGA 烧录。文件中值为 1 表示烧录已启用，0 表示其他情况。如果系统处于锁定模式，则不允许写入这些文件。这些文件的目的是允许通过 JTAG 菊花链升级线卡 CPLD 和 FPGA。

这些文件可读写。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_pn

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version_min

定义于文件 sysfs-driver-mlxreg-io

这些文件显示线卡上 FPGA 设备已烧录的 FPGA 主次版本和部件号。

这些文件是只读的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/max_power

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/config

定义于文件 sysfs-driver-mlxreg-io

这些文件提供了线卡供电所需的最大功率和线卡配置 ID。

这些文件是只读的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/qsfp_pwr_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/pwr_en

定义于文件 sysfs-driver-mlxreg-io

这些文件允许打开/关闭所有 QSFP 端口和整个线卡的电源。属性设置为 1 表示开机，0 表示关机。

这些文件可读写。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_aux_pwr_or_ref

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_dc_dc_pwr_fail

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_fpga_not_done

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_from_chassis

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_line_card

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_pwr_off_from_chassis

定义于文件 sysfs-driver-mlxreg-io

这些文件显示线路复位原因，如下所示：辅助电源中断或电源刷新、DC-DC 电源故障、FPGA 复位失败、线卡复位失败、机箱断电。文件中值为 1 表示这是复位原因，0 表示其他原因。同一时间只能有一个上述原因值为 1，表示最近一次的复位原因。

这些文件是只读的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/vpd_wp

定义于文件 sysfs-driver-mlxreg-io

此文件允许覆盖线卡 VPD 硬件写保护模式。当属性设置为 1 时，写保护被禁用；当设置为 0 时，写保护被启用。默认值为 0。如果系统处于锁定模式，则不允许写入此文件。此文件的目的是在生产流程中允许线卡 VPD 烧录。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic2_health

定义于文件 sysfs-driver-mlxreg-io

此文件显示第二个 ASIC 的健康状态。可能的值为：0 - 健康失败，2 - 健康正常，3 - ASIC 处于启动状态。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_health

定义于文件 sysfs-driver-mlxreg-io

此文件显示 ASIC 健康状态。可能的值为：0 - 健康失败，2 - 健康正常，3 - ASIC 处于启动状态。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_pg_fail

定义于文件 sysfs-driver-mlxreg-io

此文件显示 ASIC 功率正常状态。文件中值为 1 表示 ASIC 功率正常失败，0 表示其他情况。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic_reset

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/asic2_reset

定义于文件 sysfs-driver-mlxreg-io

这些文件允许通过写入 1 来重置每个 ASIC。

这些文件只写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_active_image

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_auth_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/bios_upgrade_fail

定义于文件 sysfs-driver-mlxreg-io

这些文件表示 BIOS 状态

bios_active_image: 当前活动 BIOS 图像的位置：0: 顶部，1: 底部。报告的值应与在 BIOS 安全模式为 0 的情况下操作系统期望的值相对应。此位与 Intel 双 BIOS 在同一闪存上的顶部交换功能相关。

bios_auth_fail: BIOS 升级失败，因为提供的 BIOS 图像未正确签名。

bios_upgrade_fail: BIOS 升级因其他原因失败，而非身份验证原因。例如，由于物理 SPI 闪存问题。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/clk_brd1_boot_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/clk_brd2_boot_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/clk_brd_fail

定义于文件 sysfs-driver-mlxreg-io

这些文件与系统中的时钟板状态相关。- clk_brd1_boot_fail: 关于第一个时钟板从 CI 启动失败的警告。- clk_brd2_boot_fail: 关于第二个时钟板从 CI 启动失败的警告。- clk_brd_fail: 关于公共时钟板启动失败的错误。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/clk_brd_prog_en

定义于文件 sysfs-driver-mlxreg-io

此文件启用时钟板的编程。默认值为 0（编程禁用）。如果系统处于锁定模式，则不允许写入此文件。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/comm_chnl_ready

定义于文件 sysfs-driver-mlxreg-io

此文件用于向远程端（例如 BMC）指示系统主机 CPU 已准备好向远程端发送遥测数据。为指示，应将文件写入 1。

该文件只写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config1

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config2

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统静态拓扑标识，例如系统的静态 I2C 拓扑、系统内 FPGA 设备的数量和类型等。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/config3

定义于文件 sysfs-driver-mlxreg-io

此文件指示 COME 模块硬件配置。该值通过 GPIO 引脚由硬件推送。目的是暴露同一系统 SKU 的一些细微 BOM 更改。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_pn

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_pn

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_pn

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_pn

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version_min

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version_min

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version_min

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version_min

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统上配备的 CPLD 设备已烧录的 CPLD 部件号和次要版本。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld1_version

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld2_version

定义于文件 sysfs-driver-mlxreg-io

这些文件显示已烧录到载板和交换机板上的 CPLD 版本。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld3_version

定义于文件 sysfs-driver-mlxreg-io

这些文件显示已烧录到 LED 或齿轮箱板上的 CPLD 版本。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld4_version

定义于文件 sysfs-driver-mlxreg-io

这些文件显示已烧录到 LED 板上的 CPLD 版本。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld5_pn

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld5_version

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/cpld5_version_min

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统上配备的第 5 个 CPLD 设备已烧录的 CPLD 部件号、版本和次要版本。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot1_ap_reset

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot2_ap_reset

定义于文件 sysfs-driver-mlxreg-io

这些文件旨在监控外部信任根（EROT）处理器向应用处理器（AP）发出的 RESET 输出状态。通过读取此文件，可以确定 EROT 是否已使 AP 固件失效或撤销，此时它将使 AP 保持 RESET 状态，直到加载有效的固件。这可以保护 AP 免受运行未经授权的固件的影响。在正常流程中，AP 复位应在 EROT 验证固件完整性后释放，并且应尽快完成，以便 AP 在 CPU 开始与每个 ASIC 通信之前启动。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot1_recovery

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot2_recovery

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot1_reset

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot2_reset

定义于文件 sysfs-driver-mlxreg-io

这些文件旨在在 EROT 设备故障后执行外部信任根（EROT）恢复序列。这些 EROT 设备保护 ASIC 免受未经授权的访问，在正常流程中，其复位应随系统电源一起释放——最早的通电阶段，以便 EROT 可以在 CPU 开始与 ASIC 通信之前开始启动和认证过程。在断言恢复信号的同时向 EROT 发出复位将导致 EROT 应用处理器进入恢复模式，以便可以更新/恢复 EROT 固件。对于复位/恢复，相关文件应通过 1/0 进行切换。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot1_wp

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/erot2_wp

定义于文件 sysfs-driver-mlxreg-io

这些文件允许在 EROT 设备故障后访问外部信任根 (EROT) 进行复位和恢复序列。默认值为 0（编程禁用）。如果系统处于锁定模式，则不允许写入此文件。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/fan_dir

定义于文件 sysfs-driver-mlxreg-io

此文件显示系统风扇方向：正向 - 相关位设置为 0；反向 - 相关位设置为 1。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/global_wp_request

定义于文件 sysfs-driver-mlxreg-io

当此文件写入 1 时，会激活允许访问写保护闪存的请求。此类请求只能由配备 BMC（板管理控制器）的系统执行，BMC 可以授予对受保护闪存的访问权限。如果 BMC 允许访问，它将通过“global_wp_response”响应。BMC 决定授予访问的时间窗口。授予窗口到期后，BMC 将值改回 0。默认值为 0。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/global_wp_response

定义于文件 sysfs-driver-mlxreg-io

当此文件设置为 1 时，表示 BMC 已授予主机 CPU 对受保护闪存的访问权限。默认值为 0。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_cap

定义于文件 sysfs-driver-mlxreg-io

此文件指示通过 JTAG 链更新 CPLD/FPGA 设备场可用方法

b00 - 通过 LPC 总线寄存器内存空间进行现场更新。b01 - 保留。b10 - 保留。b11 - 通过 CPU GPIOs 位操作进行现场更新。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/jtag_enable

定义于文件 sysfs-driver-mlxreg-io

这些文件启用和禁用对 JTAG 域的访问。默认情况下，对 JTAG 域的访问是禁用的。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_enable

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_enable

定义于文件 sysfs-driver-mlxreg-io

这些文件允许线卡启用状态控制。预期行为：当 lc{n}_enable 写入 1 时，相关线卡从复位状态释放；当写入 0 时，线卡保持复位状态。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_pwr

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_pwr

定义于文件 sysfs-driver-mlxreg-io

这些文件控制线卡的电源开关。预期行为：当 lc{n}_pwr 写入 1 时，相关线卡通电；当写入 0 时，线卡断电。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc1_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc2_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc3_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc4_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc5_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc6_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc7_rst_mask

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lc8_rst_mask

定义于文件 sysfs-driver-mlxreg-io

这些文件清除由 ASIC 强制执行的线卡复位位，当 ASIC 由于某些异常行为而设置此位时。预期行为：当 lc{n}_rst_mask 写入 1 时，相关线卡复位位被清除；当写入 0 时，没有效果。

这些文件只写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/lid_open

定义于文件 sysfs-driver-mlxreg-io

1 - 表示系统盖已打开，否则为 0。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/mac_reset

定义于文件 sysfs-driver-mlxreg-io

当属性设置为 0 时，此文件允许重置 ASIC MT52132，原因是一些异常的 ASIC 行为。预期行为：当 mac_reset 写入 1 时，ASIC MT52132 从复位状态释放；当写入 0 时，保持复位状态。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/os_started

定义于文件 sysfs-driver-mlxreg-io

当此文件写入 1 时，它向可编程设备指示操作系统正在接管控制。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pcie_asic_reset_dis

定义于文件 sysfs-driver-mlxreg-io

当属性设置为 1 时，此文件允许在 PCIe 根复合体重置期间保持 ASIC 运行。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/phy_reset

定义于文件 sysfs-driver-mlxreg-io

当属性设置为 0 时，此文件允许重置 PHY 88E1548，原因是一些异常的 PHY 行为。预期行为：当 phy_reset 写入 1 时，所有 PHY 88E1548 从复位状态释放；当写入 0 时，保持复位状态。

这些文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pm_mgmt_en

定义于文件 sysfs-driver-mlxreg-io

此文件分配电源管理控制所有权。当电源管理控制由硬件提供时，如果系统电源预算不足，硬件将自动关闭一个或多个先前已通电的线卡。这可能是当某些电源单元失去功率正常状态时发生的情况。当 pm_mgmt_en 写入 1 时，软件的电源管理控制被启用；当写入 0 时，硬件的电源管理控制。请注意，无论 pm_mgmt_en 属性如何设置，如果系统电源预算不足，硬件将不允许任何新的线卡通电。同样，如果软件尝试同时打开多个线卡电源，硬件将在系统有足够电源预算的情况下为线卡供电。默认值为 0。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu1_on

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu2_on

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_cycle

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_down

定义于文件 sysfs-driver-mlxreg-io

这些文件允许断言系统电源循环，开关电源单元以及系统主电源域关机。预期行为：当 pwr_cycle 写入 1 时：辅助电源域将下降，并在短时间（约 1 秒）后上升。当 psu1_on 或 psu2_on 写入 1 时，相关单元将从电源断开；当写入 0 时，连接。如果两者都写入 1，电源的主电源域将下降。当 pwr_down 写入 1 时，系统主电源域将下降。

这些文件只写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu3_on

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/psu4_on

定义于文件 sysfs-driver-mlxreg-io

这些文件控制电源单元的开关。预期行为：当 psu3_on 或 psu4_on 写入 1 时，相关单元将断开与电源的连接；当写入 0 时，连接。

这些文件只写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/pwr_converter_prog_en

定义于文件 sysfs-driver-mlxreg-io

此文件启用电源转换器的编程。默认值为 0（编程禁用）。如果系统处于锁定模式，则不允许写入此文件。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/qsfp_pwr_good

定义于文件 sysfs-driver-mlxreg-io

此文件显示 QSFP 端口电源状态。当任何 QSFP 端口插入时，值为 0。当没有 QSFP 端口插入时，值为 1。可能的值为：0 - 电源正常，1 - 电源不正常。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_ac_ok_fail

定义于文件 sysfs-driver-mlxreg-io

此文件显示因交流电源故障导致的系统复位原因。文件中值为 1 表示这是复位原因，0 表示其他原因。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_ac_pwr_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_platform

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_soc

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_pwr_off

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统复位原因，如下所示：交流电源故障导致的复位、通过 CPLD 断言复位信号由软件调用的复位、由 SOC 通过 ACPI 寄存器断言信号导致的复位、通过 CPLD 断言断电信号由软件调用的复位。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_aux_pwr_or_ref

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_asic_thermal

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_halt

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_hotswap_or_wd

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_fw_reset

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pb

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_main_pwr_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_short_pb

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sw_reset

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统复位原因，如下所示：辅助电源中断或电源刷新、ASIC 热关机、暂停、热插拔、看门狗、固件复位、长按电源按钮、短按电源按钮、软件复位。文件中值为 1 表示这是复位原因，0 表示其他原因。同一时间只能有一个上述原因值为 1，表示最近一次的复位原因。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_pwr_fail

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_comex

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_system

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_voltmon_upgrade_fail

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统复位原因，如下所示：ComEx 电源故障、ComEx 发出的复位、系统平台复位、电压监测设备升级失败导致的复位。文件中值为 1 表示这是复位原因，0 表示其他原因。同一时间只能有一个位值为 1，表示最近一次的复位原因。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_thermal

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_comex_wd

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_from_asic

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_reload_bios

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_sff_wd

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_wd

定义于文件 sysfs-driver-mlxreg-io

这些文件显示系统复位原因，如下所示：COMEX 热关机；看门狗断电或复位由以下组件之一引发：COMEX、交换机板或小型化夹层卡；ASIC 请求的复位；BIOS 重新加载导致的复位。文件中值为 1 表示这是复位原因，0 表示其他原因。同一时间只能有一个上述原因值为 1，表示最近一次的复位原因。

这些文件是只读的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_long_pwr_pb

定义于文件 sysfs-driver-mlxreg-io

如果此文件设置为 1，表示系统因长按电源按钮而复位。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_pwr_converter_fail

定义于文件 sysfs-driver-mlxreg-io

此文件显示因电源转换器设备故障导致的系统复位原因。文件中值为 1 表示这是复位原因，0 表示其他原因。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/reset_swb_dc_dc_pwr_fail

定义于文件 sysfs-driver-mlxreg-io

如果系统因交换板上配备的任何 DC-DC 电源转换器设备故障而发生复位，此文件将显示 1。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/select_iio

定义于文件 sysfs-driver-mlxreg-io

此文件允许 iio 设备选择。

属性 select_iio 可以写入 0 或 1。它选择可以访问的 iio 设备中的哪一个。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/shutdown_unlock

定义于文件 sysfs-driver-mlxreg-io

此文件允许在热关机事件后解锁 ASIC。当 ASIC 强制系统热关机时，ASIC 会被锁定，系统启动后将无法使用。软件可以通过将此属性设置为 1，然后通过将 pwr_cycle 属性设置为 1（主电源域的电源循环）来执行系统电源循环来决定解锁它。在将 shutdown_unlock 设置为 1 之前，建议验证系统重启原因是 reset_asic_thermal 或 reset_thermal_spc_or_pciesw。如果未将 shutdown_unlock 设置为 1，则从锁定状态释放 ASIC 的唯一方法是通过外部电源分配单元进行完整的系统电源循环。默认值为 1。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/shutdown_unlock

定义于文件 sysfs-driver-mlxreg-io

当 ASIC 过热时，系统保护硬件机制会强制系统重启。系统重启后，ASIC 会处于锁定状态。要解锁 ASIC，应将此文件写入 1。默认值为 0。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/spi_chnl_select

定义于文件 sysfs-driver-mlxreg-io

此文件允许选择 SPI 芯片以进行外部信任根 (EROT) 设备的带外恢复。文件可以写入 0 或 1。它选择可以通过 SPI 设备访问的哪个 EROT。

该文件可读写。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/ufm_version

定义于文件 sysfs-driver-mlxreg-io

此文件公开了可烧录电压调节器设备的固件版本。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/voltreg_update_status

定义于文件 sysfs-driver-mlxreg-io

此文件公开了可烧录电压调节器设备的配置更新状态。状态值如下：0 - 正常；1 - CRC 故障；2 - I2C 故障；3 - 进行中。

该文件只读。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/vpd_wp

定义于文件 sysfs-driver-mlxreg-io

当属性设置为 1 时，此文件允许覆盖系统 VPD 硬件写保护。

该文件可读写。

/sys/devices/system/cpu/cpuX/topology/book_id

定义于文件 sysfs-devices-system-cpu

cpuX 的 book ID。通常它是硬件平台的标识符（而不是内核的）。实际值取决于架构和平台。它仅在 s390 上使用。值：整数

/sys/devices/system/cpu/cpuX/topology/book_siblings

定义于文件 sysfs-devices-system-cpu

cpuX 在同一 book_id 内的硬件线程的内部内核映射。它仅在 s390 上使用。值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/book_siblings_list

定义于文件 sysfs-devices-system-cpu

cpuX 在同一 book_id 内的硬件线程的可读列表。格式类似于 0-3, 8-11, 14,17。它仅在 s390 上使用。值：十进制列表。

/sys/devices/system/cpu/cpuX/topology/cluster_cpus

定义于文件 sysfs-devices-system-cpu

同一集群内 CPU 的内部内核映射。值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/cluster_cpus_list

定义于文件 sysfs-devices-system-cpu

同一集群内 CPU 的可读列表。格式类似于 0-3, 8-11, 14,17。值：十进制列表。

/sys/devices/system/cpu/cpuX/topology/cluster_id

定义于文件 sysfs-devices-system-cpu

cpuX 的集群 ID。通常它是硬件平台的标识符（而不是内核的）。实际值取决于架构和平台。值：整数

/sys/devices/system/cpu/cpuX/topology/core_cpus

定义于文件 sysfs-devices-system-cpu

同一核心内 CPU 的内部内核映射。（已弃用名称：“thread_siblings”）值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/core_cpus_list

定义于文件 sysfs-devices-system-cpu

同一核心内 CPU 的可读列表。格式类似于 0-3, 8-11, 14,17。（已弃用名称：“thread_siblings_list”）。值：十进制列表。

/sys/devices/system/cpu/cpuX/topology/core_id

定义于文件 sysfs-devices-system-cpu

cpuX 的 CPU 核心 ID。通常它是硬件平台的标识符（而不是内核的）。实际值取决于架构和平台。值：整数

/sys/devices/system/cpu/cpuX/topology/die_cpus

定义于文件 sysfs-devices-system-cpu

同一芯片内 CPU 的内部内核映射。值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/die_cpus_list

定义于文件 sysfs-devices-system-cpu

同一芯片内 CPU 的可读列表。格式类似于 0-3, 8-11, 14,17。值：十进制列表。

/sys/devices/system/cpu/cpuX/topology/die_id

定义于文件 sysfs-devices-system-cpu

cpuX 的 CPU 芯片 ID。通常它是硬件平台的标识符（而不是内核的）。实际值取决于架构和平台。值：整数

/sys/devices/system/cpu/cpuX/topology/drawer_id

定义于文件 sysfs-devices-system-cpu

cpuX 的抽屉 ID。通常它是硬件平台的标识符（而不是内核的）。实际值取决于架构和平台。它仅在 s390 上使用。值：整数

/sys/devices/system/cpu/cpuX/topology/drawer_siblings

定义于文件 sysfs-devices-system-cpu

cpuX 在同一 drawer_id 内的硬件线程的内部内核映射。它仅在 s390 上使用。值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/drawer_siblings_list

定义于文件 sysfs-devices-system-cpu

cpuX 在同一 drawer_id 内的硬件线程的可读列表。格式类似于 0-3, 8-11, 14,17。它仅在 s390 上使用。值：十进制列表。

/sys/devices/system/cpu/cpuX/topology/package_cpus

定义于文件 sysfs-devices-system-cpu

共享同一 physical_package_id 的 CPU 的内部内核映射。（已弃用名称：“core_siblings”）。值：十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/package_cpus_list

定义于文件 sysfs-devices-system-cpu

共享同一 physical_package_id 的 CPU 的可读列表。格式类似于 0-3, 8-11, 14,17。（已弃用名称：“core_siblings_list”）值：十进制列表。

/sys/devices/system/cpu/cpu[0-9]+/dscr

定义于文件 sysfs-devices-system-cpu

CPU 上数据流控制寄存器 (DSCR) 的默认值。当内核执行时以及任何尚未自行设置 DSCR 的进程都会使用此默认值。如果一个进程曾设置 DSCR（通过直接访问 SPR），那么该值将为该进程保留，并在其执行的任何 CPU 上使用（覆盖此处描述的值）。如果由进程设置，该值将被子进程继承。值：64 位无符号整数（位字段）

/sys/devices/system/cpu/dscr_default

定义于文件 sysfs-devices-system-cpu

写入等同于向所有 CPU 上的 /sys/devices/system/cpu/cpuN/dscr 写入。读取返回最后写入的值或 0。此值不是全局默认值：它是一种同时设置所有每 CPU 默认值的方式。值：64 位无符号整数（位字段）

/sys/devices/system/node/has_cpu

在文件 sysfs-devices-node 中定义

具有一个或多个 CPU 的节点。

/sys/devices/system/node/has_high_memory

在文件 sysfs-devices-node 中定义

具有常规内存或高内存的节点。取决于 CONFIG_HIGHMEM。

/sys/devices/system/node/has_normal_memory

在文件 sysfs-devices-node 中定义

具有常规内存的节点。

/sys/devices/system/node/nodeX

在文件 sysfs-devices-node 中定义

当 CONFIG_NUMA 启用时，这是一个目录，包含节点 X 的信息，例如哪些 CPU 是该节点的本地 CPU。每个文件将在下文详细说明。

/sys/devices/system/node/nodeX/accessY/

在文件 sysfs-devices-node 中定义

该节点与访问类别“Y”的其他节点的关系。

/sys/devices/system/node/nodeX/accessY/initiators/

在文件 sysfs-devices-node 中定义

包含指向内存发起节点（对该目标节点的内存具有“Y”类别访问权限）的符号链接的目录。不在列表中的节点中的 CPU 和其他内存发起者访问此节点的内存时，性能可能会有所不同。

/sys/devices/system/node/nodeX/accessY/initiators/read_bandwidth

在文件 sysfs-devices-node 中定义

从该访问类别中的链接发起节点访问时，此节点的读取带宽（MB/s）。

/sys/devices/system/node/nodeX/accessY/initiators/read_latency

在文件 sysfs-devices-node 中定义

从该访问类别中的链接发起节点访问时，此节点的读取延迟（纳秒）。

/sys/devices/system/node/nodeX/accessY/initiators/write_bandwidth

在文件 sysfs-devices-node 中定义

从该访问类别中的链接发起节点访问时，此节点的写入带宽（MB/s）。

/sys/devices/system/node/nodeX/accessY/initiators/write_latency

在文件 sysfs-devices-node 中定义

从该类别中的链接发起节点访问时，此节点的写入延迟（纳秒）。

/sys/devices/system/node/nodeX/accessY/targets/

在文件 sysfs-devices-node 中定义

包含指向内存目标（此发起节点具有“Y”类别访问权限）的符号链接的目录。

/sys/devices/system/node/nodeX/compact

在文件 sysfs-devices-node 中定义

当此文件被写入时，该节点内的所有内存将被压缩。完成后，内存将被释放为尽可能多连续页面的块。

/sys/devices/system/node/nodeX/cpulist

在文件 sysfs-devices-node 中定义

与该节点关联的 CPU。

/sys/devices/system/node/nodeX/cpumap

在文件 sysfs-devices-node 中定义

该节点的 CPU 映射。

/sys/devices/system/node/nodeX/distance

在文件 sysfs-devices-node 中定义

该节点与系统中所有其他节点之间的距离。

/sys/devices/system/node/nodeX/hugepages/hugepages-<size>/

在文件 sysfs-devices-node 中定义

该节点的巨页大小控制/查询属性。参见巨页 (HugeTLB Pages)

/sys/devices/system/node/nodeX/meminfo

在文件 sysfs-devices-node 中定义

提供有关节点分布和内存利用率的信息。类似于 /proc/meminfo，参见 /proc 文件系统

/sys/devices/system/node/nodeX/memory_failure/delayed

在文件 sysfs-devices-node 中定义

在一个 NUMA 节点上的原始中毒页面中，有多少页面被内存错误恢复尝试延迟。延迟的中毒页面通常会由内核重试。

/sys/devices/system/node/nodeX/memory_failure/failed

在文件 sysfs-devices-node 中定义

在一个 NUMA 节点上的原始中毒页面中，有多少页面被内存错误恢复尝试失败。这通常意味着关键恢复操作失败。

/sys/devices/system/node/nodeX/memory_failure/ignored

在文件 sysfs-devices-node 中定义

在一个 NUMA 节点上的原始中毒页面中，有多少页面被内存错误恢复尝试忽略，通常是因为不支持此类页面，内核放弃了恢复。

/sys/devices/system/node/nodeX/memory_failure/recovered

在文件 sysfs-devices-node 中定义

在一个 NUMA 节点上的原始中毒页面中，有多少页面被内存错误恢复尝试恢复。

/sys/devices/system/node/nodeX/memory_failure/total

在文件 sysfs-devices-node 中定义

NUMA 节点上原始中毒页面（因内存错误导致数据损坏的页面）的总数。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/

在文件 sysfs-devices-node 中定义

包含内存侧缓存级别“Y”的属性的目录。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/address_mode

在文件 sysfs-devices-node 中定义

地址模式：0 表示保留，1 表示扩展线性。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/indexing

在文件 sysfs-devices-node 中定义

缓存的关联性索引：0 表示直接映射，非零表示已索引。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/line_size

在文件 sysfs-devices-node 中定义

缓存未命中时从下一缓存级别访问的字节数。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/size

在文件 sysfs-devices-node 中定义

此内存侧缓存的大小（字节）。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/write_policy

在文件 sysfs-devices-node 中定义

缓存写入策略：0 表示写回，1 表示直写，其他或未知。

/sys/devices/system/node/nodeX/numastat

在文件 sysfs-devices-node 中定义

节点的命中/未命中统计信息，单位为页面。参见 Numa 策略命中/未命中统计

/sys/devices/system/node/nodeX/vmstat

在文件 sysfs-devices-node 中定义

节点的区域化虚拟内存统计信息。这是 numastat 的超集。

/sys/devices/system/node/nodeX/x86/sgx_total_bytes

在文件 sysfs-devices-node 中定义

SGX 物理内存的总大小（字节）。

/sys/devices/system/node/online

在文件 sysfs-devices-node 中定义

在线节点。

/sys/devices/system/node/possible

在文件 sysfs-devices-node 中定义

可能在某个时间点上线（online）的节点。

/sys/devices/system/xen_memory/xen_memory0/info/current_kb

在文件 sysfs-devices-system-xen_memory 中定义

此域内存预留的当前大小（KiB）。

/sys/devices/system/xen_memory/xen_memory0/info/high_kb

在文件 sysfs-devices-system-xen_memory 中定义

气球（balloon）中的高内存量（KiB）。

/sys/devices/system/xen_memory/xen_memory0/info/low_kb

在文件 sysfs-devices-system-xen_memory 中定义

气球（balloon）中的低（或常规）内存量（KiB）。

/sys/devices/system/xen_memory/xen_memory0/max_retry_count

在文件 sysfs-devices-system-xen_memory 中定义

气球驱动程序在放弃之前尝试增加气球的最大次数。另请参见下面的“retry_count”。值为零表示永远重试，这是默认值。

/sys/devices/system/xen_memory/xen_memory0/max_schedule_delay

在文件 sysfs-devices-system-xen_memory 中定义

“schedule_delay”（见下文）将增加到的限制。默认值为 32 秒。

/sys/devices/system/xen_memory/xen_memory0/retry_count

在文件 sysfs-devices-system-xen_memory 中定义

气球驱动程序尝试增加气球大小的当前次数。默认值为 1。如果 max_retry_count 为零（无限制），这意味着驱动程序将尝试以“schedule_delay”延迟重试。

/sys/devices/system/xen_memory/xen_memory0/schedule_delay

在文件 sysfs-devices-system-xen_memory 中定义

两次尝试增加气球之间等待的时间（秒）。每次无法增加气球时，“schedule_delay”都会增加（直到达到“max_schedule_delay”，此时将使用最大值）。

/sys/devices/system/xen_memory/xen_memory0/scrub_pages

在文件 sysfs-devices-system-xen_memory 中定义

控制在将页面返回给 Xen 供其他域使用之前对其进行擦洗。可以通过 xen_scrub_pages 命令行参数设置。默认值由 CONFIG_XEN_SCRUB_PAGES_DEFAULT 控制。

/sys/devices/system/xen_memory/xen_memory0/target

在文件 sysfs-devices-system-xen_memory 中定义

调整此域内存预留的目标页面数。

/sys/devices/system/xen_memory/xen_memory0/target_kb

在文件 sysfs-devices-system-xen_memory 中定义

与上面的 target 相同，但值以 KiB 为单位。

/sys/firmware 下的符号¶

/sys/firmware/acpi/pm_profile

在文件 sysfs-acpi-pmprofile 中定义

ACPI pm_profile sysfs 接口公开了平台在 ACPI FADT Preferred_PM_Profile 字段中提供的首选电源管理（和性能）配置文件。

整数值直接从 FADT 中检索并传递。

值：有关可能的值，请参阅 ACPI 规范第 5.2.9 节“固定 ACPI 描述表 (FADT)”中表 5.9“FADT 格式”中的 Preferred_PM_Profile 字段定义。

ACPI 规范第 5.2.9 节“固定 ACPI 描述表 (FADT)”中表 5.9“FADT 格式”中的 Preferred_PM_Profile 字段定义。

截至 ACPI 6.5，定义了以下值

0	未指定
1	桌面
2	移动
3	工作站
4	企业服务器
5	SOHO 服务器
6	一体机电脑
7	高性能服务器
8	平板电脑
>8	保留

/sys/firmware/opal/dump

在文件 sysfs-firmware-opal-dump 中定义

此目录公开了通过 OPAL 固件接口与 FSP 和平台转储交互的接口。

这仅适用于 powerpc/powernv 平台。

initiate_dump	当写入“1”时，我们将启动一次转储。读取此文件以获取支持的命令。
0xXX-0xYYYY	类型为 0xXX 且 ID 为 0xYYYY（十六进制）的转储目录。不应依赖此目录的名称采用此格式，只需确保它在所有转储中是唯一的。要确定转储的类型和 ID，请使用 id 和 type 文件。不要依赖任何特定大小的转储类型或转储 ID。

每个转储都有以下文件

id	转储 ID 的十六进制 ASCII 表示形式（例如“0x01”）
type	转储类型的 ASCII 表示形式，格式为“0x%x %s”，其中 ID 为十六进制，后跟转储类型的描述（或“unknown”）。当无法从固件获取类型时，使用类型“0xffffffff unknown”。例如：“0x02 System/Platform Dump”
dump	包含转储的二进制文件。转储的大小即为此文件的大小。
acknowledge	当写入“ack”时，我们将确认已向服务处理器检索到转储。然后它将删除转储，使其无法访问。读取此文件将获得支持的操作列表。

/sys/firmware/opal/elog

在文件 sysfs-firmware-opal-elog 中定义

此目录公开了通过 OPAL 固件接口检索到的错误日志条目。

每个错误日志都由唯一的 ID 标识，并将一直存在，直到明确向固件确认。

每个日志条目在 /sys/firmware/opal/elog 中都有一个目录。

如果日志条目空间不足，服务处理器可能会在固件检索之前或 Linux 检索/确认之前清除日志条目。

如果 Linux 已检索日志条目但未明确向固件确认，并且服务处理器需要更多日志条目空间，则日志消息的唯一剩余副本可能存在于 Linux 中。

通常，用户空间守护程序会监视新条目，将其读出并确认。

服务处理器可能能够存储比固件更多的日志条目，因此在您从 Linux 确认事件后，您可能会立即从队列中获得另一个在过去某个时间生成的事件。

原始日志格式是二进制格式。我们目前在内核中完全不解析它，留给用户空间解决此问题。将来，我们可能会在内核中进行更多解析，并添加更多文件，以便简单的用户空间进程更容易提取更多信息。

对于每个日志条目（目录），有以下文件

id	错误日志 ID 的十六进制 ASCII 表示形式 - 例如“0x01”。
type	错误日志类型 ID 和类型描述的 ASCII 表示形式。目前仅为“0x00 PEL” - 平台错误日志。将来可能会有其他类型。
raw	一个只读二进制文件，可读取以获取原始日志条目。这些文件小于 16KB，通常只有数百字节，平均约为 2KB。
acknowledge	向此文件写入“ack”将向固件确认错误日志（如果适用，也会向服务处理器确认）。确认后不久，日志条目将从 sysfs 中删除。读取此文件将列出支持的操作（目前仅限确认）。

/sys/fs 下的符号¶

/sys/fs/o2cb/

在文件 o2cb 中定义

Ocfs2-tools 查看“interface-revision”以获取版本信息。每个 logmask/ 文件控制一组调试打印，并可以写入字符串“allow”、“deny”或“off”。读取文件返回当前状态。

用户: ocfs2-tools。建议的更改足以发送到 ocfs2-devel@lists.linux.dev。

/sys/fs/orangefs/acache/*

在文件 sysfs-fs-orangefs 中定义

属性缓存可配置设置。

/sys/fs/orangefs/capcache/*

在文件 sysfs-fs-orangefs 中定义

能力缓存可配置设置。

/sys/fs/orangefs/ccache/*

在文件 sysfs-fs-orangefs 中定义

凭证缓存可配置设置。

/sys/fs/orangefs/ncache/*

在文件 sysfs-fs-orangefs 中定义

名称缓存可配置设置。

/sys/fs/orangefs/op_timeout_secs

在文件 sysfs-fs-orangefs 中定义

服务操作超时时间（秒）。

/sys/fs/orangefs/perf_counter_reset

在文件 sysfs-fs-orangefs 中定义

向 perf_counter_reset 写入 0 或 1，以重置 /sys/fs/orangefs/perf_counters 中除设置了 PINT_PERF_PRESERVE 的计数器之外的所有计数器。

/sys/fs/orangefs/perf_counters/*

在文件 sysfs-fs-orangefs 中定义

各种缓存的计数器和设置。只读。

/sys/fs/orangefs/perf_history_size

在文件 sysfs-fs-orangefs 中定义

perf_counters 缓存统计信息有 N 个样本，或 perf_history_size 个样本。默认值为 1。

每隔 perf_time_interval_secs 就会重置（第一个）样本。

如果 N 大于 1，则重置“当前”样本集，并且其他 N-1 个间隔的样本仍然可用。

/sys/fs/orangefs/perf_time_interval_secs

在文件 sysfs-fs-orangefs 中定义

性能计数器间隔的长度（秒）。

/sys/fs/orangefs/slot_timeout_secs

在文件 sysfs-fs-orangefs 中定义

“插槽”超时时间（秒）。“插槽”是共享内存段中用于内核模块和用户空间之间通信的索引缓冲区。插槽被请求和等待，等待时间在 slot_timeout_secs 后超时。

/sys/hypervisor 下的符号¶

/sys/hypervisor/compilation/compile_date

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：包含 Xen 虚拟机管理程序的构建时间戳。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“<denied>”。

/sys/hypervisor/compilation/compiled_by

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：包含构建 Xen 虚拟机管理程序的人员信息。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“<denied>”。

/sys/hypervisor/compilation/compiler

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：用于构建 Xen 虚拟机管理程序的编译器。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“<denied>”。

/sys/hypervisor/properties/capabilities

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：受支持的访客系统类型列表，以空格分隔。每种类型格式为：<class>-<major>.<minor>-<arch>，其中

<class>

“xen” -- x86：半虚拟化，arm：标准 “hvm” -- 仅限 x86：全虚拟化

<major>

主要访客接口版本

<minor>

次要访客接口版本

<arch>

架构，例如：“x86_32”：32 位 x86 访客，无 PAE “x86_32p”：32 位 x86 访客，带 PAE “x86_64”：64 位 x86 访客 “armv7l”：32 位 arm 访客 “aarch64”：64 位 arm 访客

/sys/hypervisor/properties/changeset

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：虚拟机管理程序的变更集 (Git 提交)。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“<denied>”。

/sys/hypervisor/properties/features

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：Xen 虚拟机管理程序为访客支持的功能，在 include/xen/interface/features.h 中定义，以十六进制值打印。

/sys/hypervisor/properties/pagesize

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：虚拟机管理程序的默认页面大小，以十六进制值打印。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“0”。

/sys/hypervisor/properties/virtual_start

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：虚拟机管理程序的虚拟地址，以十六进制值表示。

/sys/hypervisor/start_flags/*

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：Xen 启动标志中的所有位都表示为布尔文件，如果设置则返回“1”，否则返回“0”。这取代了已废弃的 /proc/xen/capabilities，后者在 dom0 上包含“control_d”，否则为空。现在此标志除了“privileged”标志外，还以“initdomain”形式公开；所有其他可能的标志都可作为“unknownXX”访问。

/sys/hypervisor/type

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：虚拟机管理程序类型：“xen”：Xen 虚拟机管理程序

/sys/hypervisor/uuid

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行： Xen 虚拟机管理程序已知的访客 UUID。

/sys/hypervisor/version/extra

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：Xen 版本格式为 <major>.<minor><extra>。这是 <extra> 部分。在虚拟机管理程序中存在特殊安全设置的情况下，可能会返回“<denied>”。

/sys/hypervisor/version/major

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：Xen 版本格式为 <major>.<minor><extra>。这是 <major> 部分。

/sys/hypervisor/version/minor

在文件 sysfs-hypervisor-xen 中定义

如果在 Xen 下运行：Xen 版本格式为 <major>.<minor><extra>。这是 <minor> 部分。

/sys/kernel 下的符号¶

/sys/kernel/notes

在文件 sysfs-kernel-notes 中定义

/sys/kernel/notes 文件包含运行中的 vmlinux 的 .notes 段的二进制表示。

/sys/module 下的符号¶

/sys/module/<MODULENAME>

在文件 sysfs-module 中定义

位于内核中的模块名称。如果模块作为动态模块加载，此模块名称将始终显示。如果模块直接内置于内核中，则仅当它具有版本或至少一个参数时才会显示。

注意：内置模块的创建条件并非设计如此，将来可能会移除。

/sys/module/<MODULENAME>/parameters

在文件 sysfs-module 中定义

此目录包含可运行时更改的模块的各个参数的单独文件。有关这些参数的内容及其作用，请参阅各个模块的文档。

注意：单个参数名称和值不被视为稳定，只有它们将放置在 sysfs 中的此位置这一事实是稳定的。有关不同参数稳定性的详细信息，请参阅各个驱动程序文档。

/sys/module/<MODULENAME>/refcnt

在文件 sysfs-module 中定义

如果模块可以从内核卸载，此文件将包含模块的当前引用计数。

注意：如果模块内置于内核中，或者如果 CONFIG_MODULE_UNLOAD 内核配置值未启用，则此文件将不存在。

/sys/module/<MODULENAME>/srcversion

在文件 sysfs-module 中定义

如果模块源具有 MODULE_VERSION，此文件将包含源代码的校验和。

/sys/module/<MODULENAME>/version

在文件 sysfs-module 中定义

如果模块源具有 MODULE_VERSION，此文件将包含源代码的版本。

审计登录会话 ID¶

在文件 procfs-audit_loginuid 中定义

读取 /proc/$pid/sessionid 伪文件以获取进程 $pid 的审计登录会话 ID，形式为十进制无符号整数（%u, u32）。它会自动设置，每个新登录都会按序列分配。

用户: 审计和登录应用程序

审计登录 UID¶

在文件 procfs-audit_loginuid 中定义

写入 /proc/$pid/loginuid 伪文件以设置，读取以获取进程 $pid 的审计登录 UID，形式为十进制无符号整数（%u, u32）。如果未设置，则无需权限即可设置。如果已设置，访问者必须在初始用户命名空间中具有 CAP_AUDIT_CONTROL 才能写入。如果 AUDIT_FEATURE_LOGINUID_IMMUTABLE 启用，则不能再次写入。如果 AUDIT_FEATURE_ONLY_UNSET_LOGINUID 启用，则不能取消设置。

用户: 审计和登录应用程序

内核系统调用接口¶

内核系统调用接口

在文件 syscalls 中定义

此接口与 POSIX 接口大部分匹配，并基于 POSIX 和其他基于 Unix 的接口。它将只随着时间推移而增加，而不会移除内容。

请注意，此接口对于 Linux 支持的每个架构都不同。有关每个系统调用要映射的系统调用号的详细信息，请参阅特定于架构的文档。

vDSO¶

vDSO

在文件 vdso 中定义

在某些架构上，当内核加载任何用户空间程序时，它会将一个 ELF DSO 映射到该程序的地址空间中。此 DSO 称为 vDSO，它通常包含有用且高度优化的实际系统调用替代方案。

这些函数根据您平台的 ABI 调用。在许多平台上，它们的调用方式与普通 C 函数相同。在其他平台（例如：powerpc）上，它们的调用约定与系统调用相同，这与普通 C 函数不同。请在合理的上下文（sensible context）中调用它们。（例如，如果您在 x86 上将 CS 设置为奇怪的值，vDSO 函数有权崩溃。）此外，如果您向 vDSO 函数传递一个坏指针，您可能会得到 SIGSEGV 而不是 -EFAULT。

要找到 DSO，请解析传递给程序入口点的辅助向量。AT_SYSINFO_EHDR 条目将指向 vDSO。

vDSO 使用符号版本控制；每当您从 vDSO 请求符号时，请指定您期望的版本。

动态链接到 glibc 的程序将自动使用 vDSO。否则，您可以使用 tools/testing/selftests/vDSO/parse_vdso.c 中的参考解析器。

除非另有说明，否则任何给定版本的符号集以及这些符号的 ABI 都被认为是稳定的。不过，它们可能因架构而异。

注意: 截至本文撰写之时，此 ABI 文档已针对 x86_64 进行了确认。其他使用 vDSO 的架构的维护者应确认其架构是否正确。

Linux 内核

目录

本页

ABI 稳定符号¶

/dev/fw 下的符号¶

/sys/accessibility 下的符号¶

/sys/block 下的符号¶

/sys/bus 下的符号¶

Symbols under /sys/class¶

/sys/devices 下的符号¶

/sys/firmware 下的符号¶

/sys/fs 下的符号¶

/sys/hypervisor 下的符号¶

/sys/kernel 下的符号¶

/sys/module 下的符号¶

内核系统调用接口¶

vDSO¶

<class>	“xen” -- x86：半虚拟化，arm：标准 “hvm” -- 仅限 x86：全虚拟化
<major>	主要访客接口版本
<minor>	次要访客接口版本
<arch>	架构，例如：“x86_32”：32 位 x86 访客，无 PAE “x86_32p”：32 位 x86 访客，带 PAE “x86_64”：64 位 x86 访客 “armv7l”：32 位 arm 访客 “aarch64”：64 位 arm 访客

ABI 稳定符号¶

/dev/fw 下的符号¶

/sys/accessibility 下的符号¶

/sys/block 下的符号¶

/sys/bus 下的符号¶

Symbols under /sys/class¶

/sys/devices 下的符号¶

/sys/firmware 下的符号¶

/sys/fs 下的符号¶

/sys/hypervisor 下的符号¶

/sys/kernel 下的符号¶

/sys/module 下的符号¶

热相关事件的通知机制¶

审计登录会话 ID¶

审计登录 UID¶

内核系统调用接口¶

vDSO¶