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 表示 soft 驱动程序)。此目录包含控制语音合成器本身的文件,而不是控制 speakup 屏幕阅读器。此目录中的参数在所有受支持的合成器中具有相同的名称和功能。频率、音调、速率和音量的值范围对于所有受支持的合成器都是相同的,给定的范围由驱动程序在内部映射,以或多或少地适合各个合成器为给定参数支持的值范围。以下是对软合成器的值和参数的描述,该合成器是目前最常用的。

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

在文件 sysfs-driver-speakup 中定义

这是发送到合成器的字符串,以使其开始说大写字母。对于软合成器和大多数其他合成器,这会导致声音的音调高于当前设置的音调。

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

在文件 sysfs-driver-speakup 中定义

这是发送到合成器的字符串,以使其停止说大写字母。对于软合成器和大多数其他合成器,这会将声音的音调降回到当前设置的音调。

/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 中定义

这控制内核为合成器提供的 jiffys 数量。将此值设置得过高可能会使系统不稳定,甚至崩溃。

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

在文件 sysfs-driver-speakup 中定义

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

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

在文件 sysfs-driver-speakup 中定义

获取或设置合成器说出的标点符号量。软驱动程序的范围似乎是 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 中定义

获取或设置语音合成器的音调。软驱动程序的范围似乎是 0-2。如果使用 espeak 和 espeakup 连接器,这似乎没有任何区别。待办事项:espeakup 是否支持不同的音调?

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

在文件 sysfs-driver-speakup 中定义

待办事项

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

在文件 sysfs-driver-speakup 中定义

获取或设置合成器使用的语音,如果合成器支持多种语音。软驱动的范围为 0-7。请注意,虽然 espeak 支持多种语音,但当 speakup 和 espeak 之间使用 espeakup 连接器时,此参数不会设置语音。

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

在文件 sysfs-driver-speakup 中定义

获取或设置语音合成器的音量。范围为 0-9,其中 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 扬声器蜂鸣声的持续时间。待办事项:单位是什么?节拍数?

/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 中定义

此文件包含各种常规公告,其中大多数无法分类。您将找到诸如“您杀死了 Speakup”、“我活着”、“正在离开帮助”、“已停放”、“未停放”等消息。您还将在此处找到屏幕边缘和光标跟踪模式的名称。

/sys/accessibility/speakup/i18n/characters

在文件 sysfs-driver-speakup 中定义

通过此 sys 条目,Speakup 使您能够更改 Speakup 发音给定字符的方式。例如,您可以更改某些标点符号的发音方式。您甚至可以更改 Speakup 发音某些字母的方式。有关更多详细信息,请参阅 Speakup 用户指南(源文件中的 spkguide.txt)中的“12. 更改字符的发音”。

/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 会说:“小键盘 3 是字符,说下一个。”消息“字符,说下一个”命名了一个 Speakup 函数,它来自此 function_names 文件。

/sys/accessibility/speakup/i18n/key_names

在文件 sysfs-driver-speakup 中定义

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

/sys/accessibility/speakup/i18n/states

在文件 sysfs-driver-speakup 中定义

此文件包含键状态的名称。同样,这些是帮助系统的一部分。例如,如果您按下了 speakup + 小键盘 3,您会听到:“speakup 小键盘 3 是转到底部边缘。”

speakup 键已按下,因此键状态的名称为 speakup。

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

/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 设置为 0,则如果例如在读取整个屏幕之前使用了 say screen 命令,则在键盘上键入将中断 speakup。

如果将 no_interrupt 设置为 1,则如果使用了 say screen 命令,并且随后在键盘上键入,则 speakup 将继续说出整个屏幕,直到完成为止。

/sys/accessibility/speakup/punc_all

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为 4 时,speakup 应该说出的所有标点符号的列表。

/sys/accessibility/speakup/punc_level

在文件 sysfs-driver-speakup 中定义

控制屏幕显示时(而不是复习时)说出的标点符号级别。级别范围从零(无标点符号)到四(所有标点符号)。 1 对应于 punc_some,2 对应于 punc_most,3 和 4 都对应于 punc_all。某些硬件合成器可能具有不同的级别,每个级别都对应于 punc_level 的 3 和 4。另请注意,如果 punc_level 设置为零,并且 key_echo 设置为 1,则键入的标点符号仍会在键入时被说出。

/sys/accessibility/speakup/punc_most

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为 2 时,speakup 应该说出的所有标点符号的列表。

/sys/accessibility/speakup/punc_some

在文件 sysfs-driver-speakup 中定义

这是当 punc_level 设置为 1 时,speakup 应该说出的所有标点符号的列表。

/sys/accessibility/speakup/reading_punc

在文件 sysfs-driver-speakup 中定义

几乎与 punc_level 相同,区别在于 reading_punc 控制使用 speakup 的屏幕复习命令复习屏幕时的标点符号级别。另一个区别是,reading_punc 设置为 3 时会说出 punc_all,而 reading_punc 设置为 4 时会说出所有标点符号,包括空格。

/sys/accessibility/speakup/repeats

在文件 sysfs-driver-speakup 中定义

speakup 重复的字符列表。通常,当有三个以上的连续字符时,speakup 只会读取三个字符。例如,“......”将被读取为点、点、点。如果将 . 添加到 repeats 中的字符列表中,“......”将被读取为点、点、点,共六次。

/sys/accessibility/speakup/say_control

在文件 sysfs-driver-speakup 中定义

如果设置为 1,则 speakup 会在按下 shift、alt 和 control 键时说出这些键。如果将 say_control 设置为 0,则在按下 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 的说词复习命令以说出当前正在复习的单词时,单词的拼写速度。零只是一个接一个地说出字母,而值 1 到 4 似乎会在 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,则设置此项。

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

在文件 sysfs-block 中定义

支持完整性的块设备的元数据格式。 例如,T10-DIF-TYPE1-CRC。

/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 中定义

每 512 字节数据可用的完整性标签空间字节数。

/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/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/dax

在文件 sysfs-block 中定义

[只读] 此文件指示设备是否支持直接访问 (DAX),CPU 可寻址存储使用该功能绕过页面缓存。 如果为真,则显示“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 目录包含每个访问范围一个目录,每个范围都使用扇区(只读)属性文件来描述,以指示范围的第一个扇区,并使用 nr_sectors(只读)属性文件来指示从范围的第一个扇区开始的范围中的扇区总数。 例如,双执行器硬盘将具有以下 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

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 中定义

[读写] 此文件用于控制(打开/关闭)磁盘的 iostats 记帐。

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

在文件 sysfs-block 中定义

[读写] 此文件用于控制(打开/关闭)直通命令的磁盘 iostats 记帐。

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

在文件 sysfs-block 中定义

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

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

在文件 sysfs-block 中定义

[只读] 对于分区块设备(分区属性指示“主机管理”或“主机感知”),属于任何以下分区状态:显式打开、隐式打开或关闭的分区之和,受此值限制。 如果此值为 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 中定义

[只读] 对于分区块设备(分区属性指示“主机管理”或“主机感知”),属于任何以下分区状态:显式打开或隐式打开的分区之和,受此值限制。 如果此值为 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/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/<磁盘>/queue/physical_block_size

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/read_ahead_kb

在文件 sysfs-block 中定义

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

对于 MADV_HUGEPAGE,预读大小可能会超过此设置,因为它的粒度基于大页大小。

/sys/block/<磁盘>/queue/rotational

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/rq_affinity

在文件 sysfs-block 中定义

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

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

/sys/block/<磁盘>/queue/scheduler

在文件 sysfs-block 中定义

[读写] 读取时,此文件将显示此块设备的当前和可用的 IO 调度器。当前活动的 IO 调度器将包含在 [] 方括号中。将 IO 调度器名称写入此文件会将此块设备的控制权切换到新的 IO 调度器。请注意,将 IO 调度器名称写入此文件将尝试加载该 IO 调度器模块(如果它尚未在系统中存在)。

/sys/block/<磁盘>/queue/stable_writes

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/virt_boundary_mask

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/wbt_lat_usec

在文件 sysfs-block 中定义

[读写] 如果设备已注册用于回写节流,则此文件显示目标最小读取延迟。如果在给定的时间窗口内(请参阅 wb_window_usec)超过此延迟,则回写节流将开始缩减写入。将值“0”写入此文件将禁用该功能。将值“-1”写入此文件会将该值重置为默认设置。

/sys/block/<磁盘>/queue/write_cache

在文件 sysfs-block 中定义

[读写] 读取时,此文件将显示设备是否启用了回写缓存。前者将返回“write back”,后者将返回“write through”。写入此文件可以更改内核对设备的视图,但不会更改设备状态。这意味着从“回写”切换到“直写”可能不安全,因为这也会消除内核发出的缓存刷新。

/sys/block/<磁盘>/queue/write_same_max_bytes

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/write_zeroes_max_bytes

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/zone_append_max_bytes

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/zone_write_granularity

在文件 sysfs-block 中定义

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

/sys/block/<磁盘>/queue/zoned

在文件 sysfs-block 中定义

[只读] zoned 指示设备是否为分区块设备,如果确实是分区块设备,则指示设备的区域模型。zoned 指示的可能值对于常规块设备为“none”,对于分区块设备为“host-aware”或“host-managed”。ZBC(分区块命令)和 ZAC(分区设备 ATA 命令集)标准中描述了 host-aware 和 host-managed 分区块设备的特性。这些标准还定义了“drive-managed”区域模型。但是,由于驱动器管理的分区块设备不支持区域命令,因此它们将被视为常规块设备,并且 zoned 将报告“none”。

/sys/block/<磁盘>/stat

在文件 sysfs-block 中定义

/sys/block/<磁盘>/stat 文件显示磁盘 <磁盘> 的 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 中定义

要配置的事件日志大小。如果 evl 条目为 64 字节,则默认值为 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 中定义

要绑定到 wq 的驱动程序名称。

/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 中定义

指示在共享 wq 上提交 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 中定义

如果 WQ 容量支持位 WQ 功能为 1,则显示此 WQ 中的当前条目数。

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

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

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

/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 和版本的空格分隔元组。specifier_id 和版本是相应单元目录条目的 u24 的十六进制字符串表示。每个元组中的 specifier_id 和版本之间用冒号分隔。

用户: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 中单元目录的偏移量,以四字节为单位。十进制字符串表示。

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

在文件 sysfs-bus-firewire 中定义

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

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

u64 EUI-64 : u24 directory_ID : u16 LUN

没有 0x 前缀,没有空格。以前的 sbp2 驱动程序(在 firewire-sbp2 取代后于 2.6.37 中删除)使用了稍微短一些的格式,该格式与 SAM 不太接近。

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

/sys/bus/fsl-mc/autorescan

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

将零值写入此属性将禁用执行 fsl-mc 总线自动重新扫描的 DPRC IRQ。非零值将启用 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 中定义

该文件保存端点设备的 OEM PK 哈希值,该值是使用 BHI(引导主机接口)寄存器读取获得的,前提是至少已尝试过一次设备通电。如果在设备至少通电一次之前读取,则该文件将读取所有 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] 表示“开启”和“关闭”,即 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 总线上的哪个 IO 端口上出现。

用户: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。向 bConfigurationValue 写入 0 或 -1 将重置活动配置(取消配置设备)。写入另一个值将更改活动配置。

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

写入 -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-持久性”功能。对于集线器,此功能始终启用,并且其设备目录将不包含此文件。

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

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

定义在文件 sysfs-bus-usb

设备与 USB 主机连接的速度,以兆比特/秒为单位。即 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 的 USB TMC 文档“通用串行总线测试和测量类规范 (USBTMC) 修订版 1.0”的 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 的 USB TMC 文档“通用串行总线测试和测量类,子类 USB488 规范 (USBTMC-USB488) 修订版 1.0”的 4.2.2 节中找到。

这些文件是只读的。

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

定义在文件 sysfs-bus-vmbus

将哪些主/子通道绑定到哪个虚拟处理器的映射。格式: <channel 的 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

主机是否支持 VM 的休眠。

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

/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

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

详情请参阅 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

前端写入的扇区数。

/sys/class 下的符号

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

定义于文件 sysfs-class-backlight

通过查询硬件显示实际亮度。

用户: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/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,除非驱动程序设置为其他值。用户可以向 lifespan 文件回显 0-10000 之间的值,以设置更新之间的时间长度,单位为毫秒。

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

定义于文件 sysfs-class-infiniband

(只读)显示固件版本

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

定义于文件 sysfs-class-infiniband

(读写)使用诸如节点主机名之类的信息更新节点描述,以便 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

(只读)节点类型 (CA, RNIC, usNIC, usNIC UDP, 交换机或路由器)

node_guid

(只读)节点 GUID

sys_image_guid

(只读)系统镜像 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:(只读)在一个或多个物理通道上检测到的次要链路错误总数。

port_rcv_errors:(只读)端口上收到的包含错误的包总数。

port_rcv_remote_physical_errors:(只读)端口上收到的用 EBP 分隔符标记的包总数。

port_rcv_switch_relay_errors:(只读)由于无法被交换机中继转发而在端口上接收到的已丢弃的包的总数。

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

port_xmit_constraint_errors:(只读)由于出站原始过滤或出站分区或 IP 版本检查失败而未从交换机物理端口发送的包总数。

port_rcv_constraint_errors:(只读)由于入站原始过滤或入站分区或 IP 版本检查失败而在交换机物理端口上接收到的已丢弃的包总数。

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

excessive_buffer_overrun_errors:(只读)此计数器指示输入缓冲区溢出。它表示端口可能配置错误,可能是由子网管理器 (SM) 或用户干预造成的。它也可以指示硬件问题或极差的链路信号完整性

数据信息:

port_xmit_data:(只读)在所有 VL 上传输的数据字节总数,除以 4(通道)。这是一个 64 位计数器

port_rcv_data:(只读)在所有 VL 上接收的数据字节总数,除以 4(通道)。这是一个 64 位计数器。

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

port_rcv_packets:(只读)包总数(这可能包括包含错误的包。这是一个 64 位计数器。

link_downed:(只读)端口训练状态机未能完成链路错误恢复过程并导致链路断开的总次数。

unicast_rcv_packets:(只读)单播包总数,包括包含错误的单播包。

unicast_xmit_packets:(只读)从端口的所有 VL 上传输的单播包总数。这可能包括包含错误的单播包。

multicast_rcv_packets:(只读)组播包总数,包括包含错误的组播包。

multicast_xmit_packets:(只读)从端口的所有 VL 上传输的组播包总数。这可能包括包含错误的组播包。

杂项信息:

port_xmit_discards:(只读)由于端口关闭或拥塞而端口丢弃的出站包总数。

VL15_dropped:(只读)由于端口的资源限制(例如,缺少缓冲区)而丢弃的传入 VL15 包的数量。

port_xmit_wait:(只读)端口有数据要传输但整个时间段内都没有发送数据的计时周期数(由于信用不足或缺少仲裁)。

这些文件中的每一个都包含来自端口的性能管理 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

(只读)端口 LID

rate

(只读)端口数据速率(活动宽度 * 活动速度)

lid_mask_count

(只读)端口 LID 掩码计数

sm_sl

(只读)端口子网的子网管理器 SL

sm_lid

(只读)端口子网的子网管理器 LID

state

(只读)端口状态(DOWN、INIT、ARMED、ACTIVE 或 ACTIVE_DEFER)

phys_state

(只读)端口物理状态(Sleep、Polling、LinkUp 等)

cap_mask

(只读)端口功能掩码。此处有 2 位是可设置的 - IsCommunicationManagementSupported(当加载 CM 模块时设置)和 IsSM(通过打开 issmN 文件设置)。

定义于文件 sysfs-class-infiniband

(只读)链路层类型信息(Infiniband 或以太网类型)

/sys/class/infiniband/<hca>/ports/<端口号>/gid_attrs/ndevs/<gid索引>

定义于文件 sysfs-class-infiniband

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

/sys/class/infiniband/<hca>/ports/<端口号>/gid_attrs/types/<gid索引>

定义于文件 sysfs-class-infiniband

关联 GID 的 RoCE 类型位于索引 <gid索引>。对于基于 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

(只读)

硬件修订号

hca_type

(只读)

主机通道适配器类型

/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

(只读)硬件修订号

hca_type

(只读)驱动程序简称。通常应与总线驱动程序结构中的名称匹配 (例如 pci_driver::name)

board_id

(只读)制造电路板 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

(只读)硬件修订号

board_id

(只读)制造电路板 ID

nctxts

(只读)可用的上下文总数。

serial

(只读)电路板序列号

chip_reset

(只写)将 “reset” 写入此文件以重置芯片(如果可能)。仅当没有使用芯片资源的用户上下文打开时才允许。

boardversion

(只读)人类可读的电路板信息

nfreectxts

(只读)可用的空闲用户端口(上下文)数。

tempsense

(只读)热感应信息

/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

(只读)PSM2 拥塞控制使用的 CCA 表,后跟表条目。二进制属性。

cc_settings_bin

(只读)拥塞设置:端口控制、控制映射和拥塞条目的 16 个条目数组 - 增加、计时器、事件日志触发阈值和最小注入速率延迟。二进制属性。

cc_prescan

(读写)启用预扫描以加快 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/

(只读)用于转换 sl->vl 的 32 个文件 (0 - 31)

sl2sc/

(只读)用于转换 sl->sc 的 32 个文件 (0 - 31)

vl2mtu/

(只读)用于确定 vl 的 MTU 的 16 个文件 (0 - 15)

/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

(读写)用于用户进程到 sdma 引擎分配的 cpu 列表。

vl

(只读)显示 sdma 引擎映射到的虚拟通道 (vl)。

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

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 的 irq 将转向 cpu 8。这假设在上面的 /proc/interrupts 文件中,N 是“sdma3”的 irq 号,M 是“sdma4”的 irq 号。

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

(只读)硬件修订号

hca_type

(只读)主机通道适配器类型

board_id

(只读)制造电路板 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。默认情况下,不会为 QP0 操作启用任何 VF。

smi_enabled

(只读)

指示当前是否为指示的 VF/端口启用 smi

enable_smi_admin

(读写)

由管理员使用以请求为指示的 VF/端口启用或禁用 smi 功能。0 = 禁用,1 = 启用。

请求的启用将在 VF 的下一次重置时发生(例如,拥有 VF 的 VM 上的驱动程序重新启动)。

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

/sys/class/infiniband/mlx4_X/iov/ports/<端口号>/gids/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<端口号>/admin_guids/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<端口号>/pkeys/<n>

/sys/class/infiniband/mlx4_X/iov/ports/<端口号>/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>

(只读)物理端口 gids n = 0..127

admin_guids/<n>

(读写)允许检查或更改给定 GUID 的管理状态 n = 0..127

pkeys/<n>

(只读)显示物理密钥表的内容 n = 0..126

mcgs/

(只读)多播组表

<m>/gid_idx/0

(只读)显示 GID 映射 m = 1..2

<m>/pkey_idx/<n>

(读写)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

(只读)硬件修订号

hca_type

(只读)主机通道适配器类型:MT23108、MT25208(MT23108 兼容模式)、MT25208 或 MT25204

board_id

(只读)制造电路板 ID

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

/sys/class/infiniband/ocrdmaX/hca_type

定义于文件 sysfs-class-infiniband

hca_type:(只读) 显示固件版本

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

/sys/class/infiniband/ocrdmaX/hw_rev

定义于文件 sysfs-class-infiniband

hw_rev:(只读) 硬件修订号

/sys/class/infiniband/qedrX/hw_rev

/sys/class/infiniband/qedrX/hca_type

定义于文件 sysfs-class-infiniband

hw_rev

(只读)

硬件修订号

hca_type

(只读)

显示 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

(只读)拥塞控制表大小,后跟表条目。

cc_settings_bin

(只读)拥塞设置:端口控制、控制映射和 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

(只写)

led_override

(只写)

hrtbt_enable

(读写)

status

(只读)

status_str

(只读)显示有关链路状态、可能的电缆/交换机问题和硬件错误的信息。可能的状态包括 - “Initted”、“Present”、“IB_link_up”、“IB_configured” 或 “Fatal_Hardware_Error”。

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

定义于文件 sysfs-class-infiniband

(只读)该目录包含 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

(只读)显示已安装的软件和驱动程序的版本信息。

hw_rev

(只读)硬件修订号

hca_type

(只读)主机通道适配器类型

board_id

(只读)制造电路板 ID

boardversion

(只读)芯片架构的当前版本

nctxts

(只读)返回可用的用户端口(上下文)数

localbus_info

(只读)人类可读的本地总线信息

tempsense

(只读)以十进制显示温度感应寄存器

serial

(只读)HCA 的序列号

nfreectxts

(只读)可用的空闲用户端口(上下文)数。

chip_reset

(只写)通过将 “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

(只读)制造电路板 ID

config

(只读)报告此 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

(只读)

硬件修订号

hca_type

(只读)

主机通道适配器类型

board_id

(只读)

显示 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>-<端口号>/add_target

在文件 sysfs-driver-ib_srp 中定义

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

  • id_ext,一个 16 位十六进制数,指定 16 字节 SRP 目标端口标识符中的 8 字节标识符扩展。目标端口标识符由 ib_srp 在 SRP_LOGIN_REQ 请求中发送到目标。

  • ioc_guid,一个 16 位十六进制数,指定 16 字节目标端口标识符的 8 字节 I/O 控制器 GUID 部分。

  • dgid,一个 32 位十六进制数,指定目标 GID。

  • pkey,一个 4 位十六进制数,指定 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 列表折叠后,其 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 列表长度。仅当启用了部分内存描述符列表支持 (allow_ext_sg=1) 时,指定的值超过 cmd_sg_entries 才是安全的。

  • 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 设备的 userspace 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:false

  • 1:true

/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 中定义

与 SRP 目标通信时,是否允许 ib_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 中定义

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

/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 发起方”或“SRP 目标”。

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

在文件 sysfs-transport-srp 中定义

用于与远程端口通信的传输层的状态。如果传输层正在运行,则为“running”;如果遇到传输层错误但 fast_io_fail_tmo 计时器尚未触发,则为“blocked”;在 fast_io_fail_tmo 计时器触发之后,并且在 “dev_loss_tmo” 计时器触发之前,为 “fail-fast”;在 “dev_loss_tmo” 计时器触发之后,并且在最终删除端口之前,为 “lost”。

/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 Main Specification part 2, Structures, section 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’。热启动(重启)是否会清除处于 temp_deactivated 状态的 TPM 芯片是特定于平台的。

/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 规范主版本。

示例输出

2

/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 中定义

与设备树节点关联的任何设备都将有一个指向 /sys/firmware/devicetree/ 中相应设备节点的 of_path 符号链接

/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 以配置过温限制 # 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 的平台特定部分可以使用所选的关机范围。

以下是可用的关机范围(子类型)

子系统

仅关闭 APU 及其所有未被其他处理单元使用的外围设备。如果其他处理单元不使用 FPD 外围设备或 DRAM,则可能会导致 FPD 电源域关闭。

ps_only

将关闭完整的 PS,包括 RPU、PMU 等。仅保持 PL 域 (FPGA) 不受影响。

系统

将关闭完整的系统/设备。

用法

# 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-*/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,则报告的值应与操作系统期望的值相对应。此位与同一闪存上的 DualBios 的 Intel top-swap 功能相关。

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 或 Gearbox 板上烧录的 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 中定义

这些文件显示了系统上配备的第五个 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) 处理器的 RESET 输出到应用处理器 (AP) 的状态。 通过读取此文件,可以确定 EROT 是否已使 AP 固件失效或撤销,此时它会将 AP 置于 RESET 状态,直到加载有效的固件。 这可以保护 AP 免受未经授权的固件运行。 在正常流程中,EROT 验证固件的完整性后,应尽快释放 AP 复位,以便 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*/jtag_cap

在文件 sysfs-driver-mlxreg-io 中定义

此文件指示通过 JTAG 链进行 CPLD/FPGA 设备现场更新的可用方法

b00 - 通过 LPC 总线寄存器内存空间进行现场更新。 b01 - 保留。 b10 - 保留。 b11 - 通过 CPU GPIO 位操作进行现场更新。

该文件是只读的。

/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 中定义

此文件允许在属性由于某些异常 ASIC 行为设置为 0 时复位 ASIC MT52132。预期行为:当写入 mac_reset 为 1 时,ASIC MT52132 将从复位状态释放;当为 0 时,将保持在复位状态。

这些文件是可读/写的。

/sys/devices/platform/mlxplat/mlxreg-io/hwmon/hwmon*/os_started

在文件 sysfs-driver-mlxreg-io 中定义

此文件在写入 1 时,指示可编程设备 OS 正在接管控制权。

该文件是可读/写的。

/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 中定义

当属性由于某些异常 PHY 行为设置为 0 时,此文件允许复位 PHY 88E1548。预期行为:当写入 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

在文件 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*/spi_chnl_select

在文件 sysfs-driver-mlxreg-io 中定义

此文件允许为外部信任根 (EROT) 设备带外恢复选择 SPI 芯片。文件可以写入 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 中定义

同一 book_id 中 cpuX 的硬件线程的内部内核映射。它仅在 s390 上使用。值:十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/book_siblings_list

在文件 sysfs-devices-system-cpu 中定义

同一 book_id 中 cpuX 的硬件线程的人类可读列表。格式类似于 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 中定义

同一 die 中 CPU 的内部内核映射。值:十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/die_cpus_list

在文件 sysfs-devices-system-cpu 中定义

同一 die 中 CPU 的人类可读列表。格式类似于 0-3、8-11、14、17。值:十进制列表。

/sys/devices/system/cpu/cpuX/topology/die_id

在文件 sysfs-devices-system-cpu 中定义

cpuX 的 CPU die ID。通常它是硬件平台的标识符(而不是内核的)。实际值取决于体系结构和平台。值:整数

/sys/devices/system/cpu/cpuX/topology/drawer_id

在文件 sysfs-devices-system-cpu 中定义

cpuX 的 drawer ID。通常它是硬件平台的标识符(而不是内核的)。实际值取决于体系结构和平台。它仅在 s390 上使用。值:整数

/sys/devices/system/cpu/cpuX/topology/drawer_siblings

在文件 sysfs-devices-system-cpu 中定义

同一 drawer_id 中 cpuX 的硬件线程的内部内核映射。它仅在 s390 上使用。值:十六进制位掩码。

/sys/devices/system/cpu/cpuX/topology/drawer_siblings_list

在文件 sysfs-devices-system-cpu 中定义

同一 drawer_id 中 cpuX 的硬件线程的人类可读列表。格式类似于 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/cpuX/topology/physical_package_id

在文件 sysfs-devices-system-cpu 中定义

cpuX 的物理封装 ID。通常对应于物理插槽号,但实际值取决于体系结构和平台。值:整数

/sys/devices/system/cpu/cpuX/topology/ppin

在文件 sysfs-devices-system-cpu 中定义

每个插槽的受保护处理器清单号。值:十六进制。

/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 对于该节点是本地的。每个文件的详细信息如下。

/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/秒。

/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/秒。

/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 中定义

该节点的 cpumap。

/sys/devices/system/node/nodeX/distance

在文件 sysfs-devices-node 中定义

节点与系统中所有其他节点之间的距离。

/sys/devices/system/node/nodeX/hugepages/hugepages-<size>/

在文件 sysfs-devices-node 中定义

该节点的大页大小控制/查询属性。请参阅 HugeTLB 页面

/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/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 中定义

可能在某个时刻上线的节点。

/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 中定义

气球中的高内存量(以 KiB 为单位)。

/sys/devices/system/xen_memory/xen_memory0/info/low_kb

在文件 sysfs-devices-system-xen_memory 中定义

气球中低(或正常)内存的量(以 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 6.5,定义了以下值

0

未指定

1

桌面

2

移动

3

工作站

4

企业服务器

5

SOHO 服务器

6

设备 PC

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 为十六进制,并带有转储类型的描述(或“未知”)。当我们无法从固件获取类型时,将使用类型“0xffffffff 未知”。例如,“0x02 系统/平台转储”

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”:不带 PAE 的 32 位 x86 客户机 “x86_32p”:带 PAE 的 32 位 x86 客户机 “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/<模块名称>/parameters

在文件 sysfs-module 中定义

此目录包含各个文件,这些文件是模块的各个参数,可以在运行时更改。有关这些参数的内容及其作用,请参阅各个模块的文档。

注意:各个参数名称和值被认为是不稳定的,只有它们将被放置在 sysfs 中的这个位置才是稳定的。有关不同参数的稳定性详细信息,请参阅各个驱动程序的文档。

/sys/module/<模块名称>/refcnt

在文件 sysfs-module 中定义

如果模块可以从内核卸载,则此文件将包含模块的当前引用计数。

注意:如果模块内置于内核中,或者如果未启用 CONFIG_MODULE_UNLOAD 内核配置值,则此文件将不存在。

/sys/module/<模块名称>/srcversion

在文件 sysfs-module 中定义

如果模块源代码具有 MODULE_VERSION,则此文件将包含源代码的校验和。

/sys/module/<模块名称>/version

在文件 sysfs-module 中定义

如果模块源代码具有 MODULE_VERSION,则此文件将包含源代码的版本。

审计登录会话 ID

审计登录会话 ID

定义在文件 procfs-audit_loginuid

读取 /proc/$pid/sessionid 伪文件以获取进程 $pid 的审计登录会话 ID,格式为十进制无符号整数(%u, u32)。它是自动设置的,每次新登录时都会按顺序分配。

用户:审计和登录应用程序

审计登录 UID

审计登录 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 函数不同。从合理的上下文中调用它们。(例如,如果您在 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 的体系结构的维护人员应确认它对他们的体系结构是正确的。

文件 stable/firewire-cdev

具有以下 ABI

文件 stable/o2cb

具有以下 ABI

文件 stable/procfs-audit_loginuid

具有以下 ABI

文件 stable/syscalls

具有以下 ABI

文件 stable/sysfs-acpi-pmprofile

具有以下 ABI

文件 stable/sysfs-block

具有以下 ABI

文件 stable/sysfs-bus-firewire

具有以下 ABI

文件 stable/sysfs-bus-fsl-mc

具有以下 ABI

文件 stable/sysfs-bus-mhi

具有以下 ABI

文件 stable/sysfs-bus-nvmem

具有以下 ABI

文件 stable/sysfs-bus-usb

具有以下 ABI

文件 stable/sysfs-bus-vmbus

具有以下 ABI

文件 stable/sysfs-bus-w1

具有以下 ABI

文件 stable/sysfs-bus-xen-backend

具有以下 ABI

文件 stable/sysfs-class-backlight

具有以下 ABI

文件 stable/sysfs-class-infiniband

所有 infiniband 设备通用的 sysfs 接口

具有以下 ABI

文件 stable/sysfs-class-rfkill

rfkill - 射频 (RF) 连接器杀死开关支持

有关此子系统的详细信息,请参阅 rfkill - RF 杀死开关支持

有关此接口已弃用的 /sys/class/rfkill/*/claim 旋钮,请参阅 removed/sysfs-class-rfkill

具有以下 ABI

文件 stable/sysfs-class-tpm

具有以下 ABI

文件 stable/sysfs-class-ubi

具有以下 ABI

文件 stable/sysfs-class-udc

具有以下 ABI

文件 stable/sysfs-devices

注意

本文档记录了除 有关如何访问 sysfs 中的信息的规则 中记录的任何设备的其他属性

具有以下 ABI

文件 stable/sysfs-devices-node

具有以下 ABI

文件 stable/sysfs-devices-system-cpu

具有以下 ABI

文件 stable/sysfs-devices-system-xen_memory

具有以下 ABI

文件 stable/sysfs-driver-aspeed-vuart

具有以下 ABI

文件 stable/sysfs-driver-dma-idxd

具有以下 ABI

文件 stable/sysfs-driver-dma-ioatdma

具有以下 ABI

文件 stable/sysfs-driver-firmware-zynqmp

具有以下 ABI

文件 stable/sysfs-driver-ib_srp

具有以下 ABI

文件 stable/sysfs-driver-misc-cp500

具有以下 ABI

文件 stable/sysfs-driver-mlxreg-io

具有以下 ABI

文件 stable/sysfs-driver-qla2xxx

具有以下 ABI

文件 stable/sysfs-driver-speakup

具有以下 ABI

文件 stable/sysfs-driver-usb-usbtmc

具有以下 ABI

文件 stable/sysfs-driver-w1_ds2438

具有以下 ABI

文件 stable/sysfs-driver-w1_ds28e04

具有以下 ABI

文件 stable/sysfs-driver-w1_ds28ea00

具有以下 ABI

文件 stable/sysfs-firmware-opal-dump

具有以下 ABI

文件 stable/sysfs-firmware-opal-elog

具有以下 ABI

文件 stable/sysfs-fs-orangefs

具有以下 ABI

文件 stable/sysfs-hypervisor-xen

具有以下 ABI

文件 stable/sysfs-kernel-notes

具有以下 ABI

文件 stable/sysfs-module

/sys/module 树由以下结构组成

具有以下 ABI

文件 stable/sysfs-platform-wmi-bmof

具有以下 ABI

文件 stable/sysfs-transport-srp

具有以下 ABI

文件 stable/thermal-notification

具有以下 ABI

文件 stable/vdso

具有以下 ABI