ABI 穩定符號¶

記錄開發者定義為穩定的介面。

使用者空間程式可以自由使用這些介面，不受任何限制，並且這些介面的向後相容性將至少保證 2 年。

大多數介面（如系統呼叫）預計永遠不會改變，並且始終可用。

/dev/fw 下的符號¶

/dev/fw[0-9]+

在檔案 firewire-cdev 中定義

字元裝置檔案 /dev/fw* 是 firewire-core 和使用者空間中實現的 IEEE 1394 裝置驅動程式之間的介面。基於 ioctl(2) 和 read(2) 的 ABI 在 <linux/firewire-cdev.h> 中定義和記錄。

此 ABI 提供了 firewire-core 也向核心空間 IEEE 1394 驅動程式公開的大部分功能。

每個 /dev/fw* 都與一個 IEEE 1394 節點關聯，該節點可以是遠端節點或本地節點。對 /dev/fw* 檔案的操作具有不同的範圍

與檔案關聯的 1394 節點

非同步請求傳輸

獲取配置 ROM

查詢節點 ID

查詢此節點和本地節點之間路徑的最大速度

節點所連線的 1394 匯流排（即“卡”）

同步流傳輸和接收

非同步流傳輸和接收

非同步廣播請求傳輸

PHY 資料包傳輸和接收

在匯流排的 IRM 處分配、重新分配、解除分配同步資源（通道、頻寬）

查詢本地節點、根節點、IRM、匯流排管理器的節點 ID

查詢週期時間

匯流排復位啟動，匯流排復位事件接收

所有 1394 匯流排

在本地鏈路層上分配 IEEE 1212 地址範圍，接收對此類地址範圍的入站請求，非同步響應入站請求

向本地節點的配置 ROM 新增描述符或目錄

由於操作範圍不同，並且為了讓使用者空間實現不同的訪問許可權模型，某些操作僅限於與本地節點關聯的 /dev/fw* 檔案

向本地節點的配置 ROM 新增描述符或目錄

PHY 資料包傳輸和接收

在整個生命週期內，/dev/fw* 檔案始終與一個特定節點關聯。匯流排拓撲變化，以及隨之而來的節點 ID 變化，由 firewire-core 跟蹤。ABI 使用者無需瞭解拓撲。

支援以下檔案操作

open(2): 目前唯一有用的標誌是 O_RDWR。
ioctl(2): 啟動各種操作。有些立即生效，有些在 ioctl 返回時或之後非同步執行。有關所有 ioctl 的描述，請參閱 <linux/firewire-cdev.h> 中的內聯文件。
poll(2)、select(2)、epoll_wait(2) 等: 監視事件是否可供讀取。
read(2): 接收各種事件。有像出站非同步事務完成或同步緩衝區完成這樣的請求事件，以及像匯流排復位、請求接收或 PHY 資料包接收這樣的非請求事件。始終使用足夠大的讀取緩衝區來接收可能到達的最大事件。有關所有事件型別以及哪些 ioctl 影響事件接收的描述，請參閱 <linux/firewire-cdev.h>。
mmap(2): 為同步接收或傳輸分配 DMA 緩衝區，並將其對映到程序地址空間。引數應按如下方式使用：addr = NULL，length = 所需的緩衝區大小（即，資料包數量乘以最大資料包大小），prot = 接收至少為 PROT_READ，傳輸至少為 PROT_WRITE，flags = MAP_SHARED，fd = /dev/fw* 的控制代碼，offset = 0。

同步接收以每個資料包一個緩衝區的方式工作，多通道接收除外，多通道接收以緩衝區填充模式工作。

munmap(2): 從程序地址空間中解除對映同步 I/O 緩衝區。
close(2): 除了停止和釋放與檔案描述符關聯的 I/O 上下文外，還要回滾對本地節點配置 ROM 的任何更改。解除分配在 IRM 處標記為核心輔助重新分配和解除分配的同步通道和頻寬。
使用者: libraw1394; libdc1394; libhinawa; linux-firewire-utils, fwhack 等工具...

/sys/accessibility 下的符號¶

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

在檔案 sysfs-driver-speakup 中定義

在 /sys/accessibility/speakup 中有一個與當前使用的合成器驅動程式（例如 soft 驅動程式）對應的目錄。此目錄包含控制語音合成器本身的檔案，而不是控制 speakup 螢幕閱讀器。此目錄中的引數在所有支援的合成器中具有相同的名稱和功能。freq、pitch、rate 和 vol 的值範圍對於所有支援的合成器都是相同的，給定範圍由驅動程式內部對映以或多或少地適應單個合成器對給定引數支援的值範圍。下面是 soft 合成器的值和引數描述，它是目前最常用的。

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

在檔案 sysfs-driver-speakup 中定義

這是傳送到合成器的字串，用於使其開始朗讀大寫字母。對於 soft 合成器和大多數其他合成器，這會使語音的音高升至當前設定的音高之上。

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

在檔案 sysfs-driver-speakup 中定義

這是傳送到合成器的字串，用於使其停止朗讀大寫字母。對於 soft 合成器和大多數其他合成器，這會將語音的音高返回到當前設定的音高。

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

在檔案 sysfs-driver-speakup 中定義

待辦

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

在檔案 sysfs-driver-speakup 中定義

控制標點符號是由 speakup 朗讀還是由合成器朗讀。

例如，speakup 將“>”讀作“greater”，而 soft 驅動程式使用的 espeak 合成器將“>”讀作“greater than”。零表示 speakup 朗讀標點符號。一表示合成器自己朗讀標點符號。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定等待合成器重新整理完成的超時時間。當電纜出現故障並且重新整理通知丟失時，可以使用此功能。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定語音合成器的頻率。範圍是 0-9。

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

在檔案 sysfs-driver-speakup 中定義

待辦

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定合成器的語調，即音高範圍。範圍是 0-9。

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

在檔案 sysfs-driver-speakup 中定義

這控制核心向合成器提供多少個 jiffy。設定過高可能會使系統不穩定，甚至導致系統崩潰。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定合成器的音高。範圍是 0-9。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定合成器朗讀的標點符號數量。soft 驅動程式的範圍似乎是 0-2。待辦：這與 speakup 的 punc_level 或 reading_punc 有何關係。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定合成器的語速。範圍從零（最慢）到九（最快）。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定語音合成器的音調。soft 驅動程式的範圍似乎是 0-2。如果使用 espeak 和 espeakup 聯結器，這似乎沒有區別。待辦：espeakup 是否支援不同的音調？

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

在檔案 sysfs-driver-speakup 中定義

待辦

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

在檔案 sysfs-driver-speakup 中定義

如果合成器能夠以多種語音說話，則獲取或設定合成器使用的語音。soft 驅動程式的範圍是 0-7。請注意，雖然 espeak 支援多種語音，但當 speakup 和 espeak 之間使用 espeakup 聯結器時，此引數不會設定語音。

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

在檔案 sysfs-driver-speakup 中定義

獲取或設定語音合成器的音量。範圍是 0-9，零為最輕，九為最響。

/sys/accessibility/speakup/attrib_bleep

在檔案 sysfs-driver-speakup 中定義

在使用 speakup 審查命令時，當有屬性變化（如前景色或背景色）時，PC 揚聲器會發出蜂鳴聲。1 = 開，0 = 關。

/sys/accessibility/speakup/bell_pos

在檔案 sysfs-driver-speakup 中定義

這與打字機的鈴聲非常相似。例如，如果將 72 回顯到 bell_pos，則在行上鍵入字元超過 72 時，PC 揚聲器會發出蜂鳴聲。

/sys/accessibility/speakup/bleep_time

在檔案 sysfs-driver-speakup 中定義

這控制 speakup 產生的 PC 揚聲器蜂鳴聲的持續時間。待辦：單位是什麼？Jiffy 嗎？

/sys/accessibility/speakup/bleeps

在檔案 sysfs-driver-speakup 中定義

這控制在使用 speakup 的審查命令時是否透過 PC 揚聲器聽到蜂鳴聲。待辦：它接受什麼值？

/sys/accessibility/speakup/cur_phonetic

在檔案 sysfs-driver-speakup 中定義

這允許 speakup 在逐字母瀏覽單詞時語音化地朗讀字母。這不會影響鍵入字元時的拼寫。當 cur_phonetic=1 時，speakup 在游標移過字母時會語音化地朗讀字元。當 cur_phonetic=0 時，speakup 會正常朗讀字母。

/sys/accessibility/speakup/cursor_time

在檔案 sysfs-driver-speakup 中定義

這控制使用方向鍵時游標延遲。當連線非常慢時，使用預設設定，當使用方向鍵移動或退格等時，speakup 會朗讀錯誤的字元。將其設定為更高的值以調整延遲並更好地同步游標位置和語音。

/sys/accessibility/speakup/delimiters

在檔案 sysfs-driver-speakup 中定義

從 speakup 中分隔單詞。待辦：新增更多資訊

/sys/accessibility/speakup/ex_num

在檔案 sysfs-driver-speakup 中定義

待辦

/sys/accessibility/speakup/i18n/announcements

在檔案 sysfs-driver-speakup 中定義

此檔案包含各種通用通知，其中大部分無法歸類。您會找到諸如“You killed Speakup”、“I’m alive”、“leaving help”、“parked”、“unparked”等訊息。您還會在此處找到螢幕邊緣和游標跟蹤模式的名稱。

/sys/accessibility/speakup/i18n/characters

在檔案 sysfs-driver-speakup 中定義

透過此 sys 條目，Speakup 允許您更改 Speakup 發音給定字元的方式。例如，您可以更改某些標點符號的發音方式。您甚至可以更改 Speakup 發音某些字母的方式。有關更多詳細資訊，請參閱 Speakup 使用者指南（原始檔中的 spkguide.txt 檔案）中的“12. Changing the Pronunciation of Characters”。

/sys/accessibility/speakup/i18n/chartab

在檔案 sysfs-driver-speakup 中定義

待辦

/sys/accessibility/speakup/i18n/colors

在檔案 sysfs-driver-speakup 中定義

當您使用“朗讀屬性”功能時，Speakup 會朗讀前景色和背景色的名稱。這些名稱來自 i18n/colors 檔案。

/sys/accessibility/speakup/i18n/ctl_keys

在檔案 sysfs-driver-speakup 中定義

在這裡，您會找到控制鍵的名稱。這些名稱與 Speakup 的 say_control 功能一起使用。

/sys/accessibility/speakup/i18n/formatted

在檔案 sysfs-driver-speakup 中定義

這組訊息包含嵌入式格式程式碼，用於指定顯示資料的型別和寬度。如果更改這些訊息，則必須保留所有格式程式碼，並且它們必須以預設訊息中使用的順序出現。

/sys/accessibility/speakup/i18n/function_names

在檔案 sysfs-driver-speakup 中定義

在這裡，您會找到 Speakup 功能的名稱列表。這些名稱由幫助系統使用。例如，假設您已啟用幫助模式並按下數字鍵盤 3。Speakup 會說：“keypad 3 is character, say next.”。訊息“character, say next”是 Speakup 功能的名稱，它來自此 function_names 檔案。

/sys/accessibility/speakup/i18n/key_names

在檔案 sysfs-driver-speakup 中定義

同樣，key_names 也由 Speakup 的幫助系統使用。在前面的示例中，Speakup 說您按下了“keypad 3.”。此名稱來自 key_names 檔案。

/sys/accessibility/speakup/i18n/states

在檔案 sysfs-driver-speakup 中定義

此檔案包含鍵狀態的名稱。同樣，這些是幫助系統的一部分。例如，如果您按下了 speakup + 數字鍵盤 3，您會聽到：“speakup keypad 3 is go to bottom edge.”

speakup 鍵被按下，因此鍵狀態的名稱是 speakup。

訊息的這一部分來自 states 集合。

/sys/accessibility/speakup/key_echo

在檔案 sysfs-driver-speakup 中定義

控制 Speakup 是否在鍵入時朗讀按鍵。1 = 開啟，0 = 關閉或不回顯按鍵。

/sys/accessibility/speakup/keymap

在檔案 sysfs-driver-speakup 中定義

Speakup 鍵盤對映將按鍵重新對映到 Speakup 功能。它使用二進位制格式。需要一個名為 genmap 的特殊程式將文字鍵盤對映編譯成二進位制格式，然後將其載入到 /sys/accessibility/speakup/keymap 中。

/sys/accessibility/speakup/no_interrupt

在檔案 sysfs-driver-speakup 中定義

控制鍵入是否中斷 speakup 的輸出。當 no_interrupt 設定為零時，如果例如在螢幕完全讀取之前使用了“朗讀螢幕”命令，則鍵盤鍵入會中斷 speakup。

當 no_interrupt 設定為一時，如果使用了“朗讀螢幕”命令，然後使用者鍵入鍵盤，speakup 將繼續朗讀整個螢幕，直到完成。

/sys/accessibility/speakup/punc_all

在檔案 sysfs-driver-speakup 中定義

這是當 punc_level 設定為 4 時，speakup 應該朗讀的所有標點符號的列表。

/sys/accessibility/speakup/punc_level

在檔案 sysfs-driver-speakup 中定義

控制螢幕顯示時（而非回顧時）朗讀的標點符號級別。級別範圍從零（無標點符號）到四（所有標點符號）。一對應 punc_some，二對應 punc_most，三和四都對應 punc_all。某些硬體合成器可能具有不同的級別，分別對應 punc_level 的三和四。另請注意，如果 punc_level 設定為零，並且 key_echo 設定為一，則鍵入的標點符號仍會在鍵入時朗讀。

/sys/accessibility/speakup/punc_most

在檔案 sysfs-driver-speakup 中定義

這是當 punc_level 設定為二時，speakup 應該朗讀的所有標點符號的列表。

/sys/accessibility/speakup/punc_some

在檔案 sysfs-driver-speakup 中定義

這是當 punc_level 設定為一時，speakup 應該朗讀的所有標點符號的列表。

/sys/accessibility/speakup/reading_punc

在檔案 sysfs-driver-speakup 中定義

與 punc_level 幾乎相同，不同之處在於 reading_punc 控制使用 speakup 的螢幕審查命令審查螢幕時標點符號的級別。另一個區別是 reading_punc 設定為三時朗讀 punc_all，reading_punc 設定為四時朗讀所有標點符號，包括空格。

/sys/accessibility/speakup/repeats

在檔案 sysfs-driver-speakup 中定義

speakup 重複的字元列表。通常，當連續出現三個以上字元時，speakup 只朗讀其中三個字元。例如，“......”將被朗讀為 dot, dot, dot。如果將 . 新增到 repeats 中的字元列表，“......”將被朗讀為 dot, dot, dot, times six。

/sys/accessibility/speakup/say_control

在檔案 sysfs-driver-speakup 中定義

如果設定為一，當按下 Shift、Alt 和 Control 鍵時，speakup 會朗讀這些鍵。如果 say_control 設定為零，當按下 Shift、Ctrl 和 Alt 鍵時，它們將不被朗讀。

/sys/accessibility/speakup/say_word_ctl

在檔案 sysfs-driver-speakup 中定義

待辦

/sys/accessibility/speakup/silent

在檔案 sysfs-driver-speakup 中定義

待辦

/sys/accessibility/speakup/spell_delay

在檔案 sysfs-driver-speakup 中定義

這控制當 speakup 的“朗讀單詞”審查命令被快速按下兩次以朗讀當前審查的單詞時，單詞的拼讀速度。零表示字母一個接一個地朗讀，而一到四的值似乎會在 speakup 拼寫每個字母之間引入更多停頓。

/sys/accessibility/speakup/synth

在檔案 sysfs-driver-speakup 中定義

獲取或設定當前使用的合成器驅動程式。讀取 synth 返回當前使用的合成器驅動程式。寫入 synth 將切換到給定的合成器驅動程式，前提是它要麼內置於核心中，要麼已作為模組載入。

/sys/accessibility/speakup/synth_direct

在檔案 sysfs-driver-speakup 中定義

將寫入 synth_direct 的任何內容直接傳送到正在使用的語音合成器，繞過 speakup。這可用於使合成器朗讀字串，或向合成器傳送控制序列以更改合成器的行為。

/sys/accessibility/speakup/version

在檔案 sysfs-driver-speakup 中定義

讀取 version 返回 speakup 的版本以及當前使用的合成器驅動程式的版本。

/sys/block 下的符號¶

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

在檔案 sysfs-block 中定義

儲存裝置可能會報告比邏輯塊大小更大的物理塊大小（例如，一個具有 4KB 物理扇區的驅動器向作業系統公開 512 位元組邏輯塊）。此引數指示分割槽起始位置與磁碟自然對齊的偏移位元組數。

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

在檔案 sysfs-block 中定義

支援丟棄功能的裝置可能會以大於匯出邏輯塊大小的單位內部分配空間。discard_alignment 引數指示分割槽起始位置與內部分配單元的自然對齊的偏移位元組數。

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

在檔案 sysfs-block 中定義

/sys/block/<disk>/<partition>/stat 檔案顯示分割槽 <partition> 的 I/O 統計資訊。其格式與 /sys/block/<disk>/stat 的格式相同。

/sys/block/<disk>/alignment_offset

在檔案 sysfs-block 中定義

儲存裝置可能會報告比邏輯塊大小更大的物理塊大小（例如，一個具有 4KB 物理扇區的驅動器向作業系統公開 512 位元組邏輯塊）。此引數指示裝置起始位置與磁碟自然對齊的偏移位元組數。

/sys/block/<disk>/atomic_write_boundary_bytes

在檔案 sysfs-block 中定義

[只讀] 裝置可能需要內部拆分跨越給定邏輯塊地址邊界的原子寫入 I/O。此引數指定原子邊界的大小（以位元組為單位）（如果裝置報告）。此值必須是 2 的冪，並且至少與 atomic_write_unit_max_bytes 大小相同。任何合併原子寫入 I/O 的嘗試都不得導致合併的 I/O 跨越此邊界（如果有）。

/sys/block/<disk>/atomic_write_max_bytes

在檔案 sysfs-block 中定義

[只讀] 此引數指定裝置報告的最大原子寫入大小。此引數與寫入合併相關，其中合併的原子寫入操作不得超過此位元組數。此引數可能大於 atomic_write_unit_max_bytes 中的值，因為 atomic_write_unit_max_bytes 將向下舍入為 2 的冪，並且 atomic_write_unit_max_bytes 也可能受到其他一些佇列限制（如 max_segments）的限制。此引數——以及 atomic_write_unit_min_bytes 和 atomic_write_unit_max_bytes——不會大於 max_hw_sectors_kb，但可能大於 max_sectors_kb。

/sys/block/<disk>/atomic_write_unit_max_bytes

在檔案 sysfs-block 中定義

[只讀] 此引數定義可以使用原子寫入操作原子寫入的最大塊。此值必須是 atomic_write_unit_min 的倍數，並且必須是 2 的冪。此值不會大於 atomic_write_max_bytes。

/sys/block/<disk>/atomic_write_unit_min_bytes

在檔案 sysfs-block 中定義

[只讀] 此引數指定可以使用原子寫入操作原子寫入的最小塊。所有原子寫入操作都必須在 atomic_write_unit_min 邊界開始，並且必須是 atomic_write_unit_min 的倍數。此值必須是 2 的冪。

/sys/block/<disk>/discard_alignment

在檔案 sysfs-block 中定義

支援丟棄功能的裝置可能會以大於匯出邏輯塊大小的單位內部分配空間。discard_alignment 引數指示裝置起始位置與內部分配單元的自然對齊的偏移位元組數。

/sys/block/<disk>/diskseq

在檔案 sysfs-block 中定義

/sys/block/<disk>/diskseq 檔案報告磁碟序列號，這是一個分配給每個驅動器的單調遞增數字。某些裝置（如迴圈裝置）在每次更改後端檔案時都會重新整理此數字。值型別為 64 位無符號整數。

/sys/block/<disk>/hidden

在檔案 sysfs-block 中定義

[只讀] 塊裝置是隱藏的。它不會產生事件，也無法從使用者空間或使用 blkdev_get* 開啟。用於多路徑裝置的底層元件。

/sys/block/<disk>/inflight

在檔案 sysfs-block 中定義

報告裝置驅動程式中當前正在進行（掛起/正在處理）的 I/O 請求數量。此數量可能小於塊裝置佇列中排隊的請求數量。報告包含 2 個欄位：一個用於讀取請求，一個用於寫入請求。值型別為無符號整數。參見 /sys/block/<dev>/stat 中的塊層統計資訊，其中包含一個用於正在進行的請求的單一值。這與 /sys/block/<disk>/queue/nr_requests 相關，對於 SCSI 裝置也與其 queue_depth 相關。

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

在檔案 sysfs-block 中定義

指示儲存裝置是否能夠儲存完整性元資料。如果裝置支援 T10 PI，則設定為此標誌。如果儲存介質已使用 T10 保護資訊格式化，則此標誌設定為 1。如果儲存介質未啟用 T10 保護資訊格式化，則此標誌設定為 0。

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

在檔案 sysfs-block 中定義

支援完整性的塊裝置的元資料格式。例如 T10-DIF-TYPE1-CRC。此欄位描述了塊裝置可以傳送和接收的 T10 保護資訊型別。如果裝置可以儲存應用程式完整性元資料但未使用 T10 保護資訊配置檔案，則此欄位包含“nop”。如果裝置不支援完整性元資料，則此欄位包含“none”。

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

在檔案 sysfs-block 中定義

描述由一個完整性元組保護的資料位元組數。通常是裝置的邏輯塊大小。

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

在檔案 sysfs-block 中定義

指示塊層是否應驗證支援傳送完整性元資料的裝置所提供讀取請求的完整性。

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

在檔案 sysfs-block 中定義

每個 protection_interval_bytes 可用的完整性標籤空間位元組數，通常是裝置的邏輯塊大小。此欄位描述了應用程式標籤的大小，如果儲存裝置已使用 T10 保護資訊格式化並允許使用應用程式標籤。tag_size 以位元組為單位報告，並指示為每個塊（protection_interval_bytes）新增不透明標籤的可用空間。如果裝置不支援 T10 保護資訊（即使裝置提供應用程式完整性元資料空間），此欄位設定為 0。

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

在檔案 sysfs-block 中定義

指示塊層是否應自動為繫結到支援接收完整性元資料的裝置的寫入請求生成校驗和。

/sys/block/<disk>/partscan

在檔案 sysfs-block 中定義

/sys/block/<disk>/partscan 檔案報告磁碟是否啟用了分割槽掃描。如果分割槽掃描已啟用，則返回“1”；否則返回“0”。值型別為 32 位無符號整數，但只有“0”和“1”是有效值。

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

在檔案 sysfs-block 中定義

[讀寫] 此檔案允許關閉磁碟熵貢獻。此檔案的預設值為“1”（開啟）。

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

在檔案 sysfs-block 中定義

[只讀] chunk_sectors 根據磁碟型別具有不同的含義。對於 RAID 裝置 (dm-raid)，chunk_sectors 表示 RAID 卷條帶段的大小（以 512B 扇區為單位）。對於分割槽塊裝置（無論是主機感知還是主機管理），chunk_sectors 表示裝置分割槽的大小（以 512B 扇區為單位），最終裝置最後一個分割槽可能較小。

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

在檔案 sysfs-block 中定義

/sys/block/<disk>/queue/ 的此子目錄的存在表示裝置支援內聯加密。此子目錄包含描述裝置內聯加密能力的檔案。有關內聯加密的更多資訊，請參閱內聯加密。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案的存在表明裝置支援硬體封裝的內聯加密金鑰，即只能由專用硬體解封裝和使用的金鑰 blob。有關硬體封裝的內聯加密金鑰的更多資訊，請參閱內聯加密。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案顯示裝置在內聯加密請求中接受的資料單元號的最大長度（以位為單位）。

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

在檔案 sysfs-block 中定義

[只讀] 對於裝置支援的每個加密模式（即加密/解密演算法）的內聯加密，此位置將存在一個檔案。它將包含一個十六進位制數字，該數字是該加密模式支援的資料單元大小（以位元組為單位）的位掩碼。

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

AES-256-XTS

AES-128-CBC-ESSIV

Adiantum

例如，如果裝置支援資料單元大小為 512 和 4096 位元組的 AES-256-XTS 內聯加密，則檔案 /sys/block/<disk>/queue/crypto/modes/AES-256-XTS 將存在幷包含“0x1200”。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案顯示裝置用於內聯加密的金鑰槽數量。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案的存在表明裝置支援原始內聯加密金鑰，即以原始明文形式在軟體中管理的金鑰。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案指示裝置是否支援直接訪問 (DAX)，DAX 用於 CPU 可定址儲存以繞過頁快取。如果為 true，則顯示“1”；否則顯示“0”。

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

在檔案 sysfs-block 中定義

[只讀] 支援丟棄功能的裝置可能會使用大於邏輯塊大小的單位內部分配空間。discard_granularity 引數指示裝置報告的內部分配單元的大小（以位元組為單位）。否則，discard_granularity 將設定為與裝置的物理塊大小匹配。discard_granularity 為 0 表示裝置不支援丟棄功能。

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

在檔案 sysfs-block 中定義

[讀寫] 雖然 discard_max_hw_bytes 是裝置的硬體限制，但此設定是軟體限制。某些裝置在發出大量丟棄操作時會表現出較大的延遲，將此值設定得更低將使 Linux 發出較小的丟棄操作，並可能有助於減少大量丟棄操作引起的延遲。

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

在檔案 sysfs-block 中定義

[只讀] 支援丟棄功能的裝置可能在單個操作中可修剪或未對映的位元組數方面具有內部限制。discard_max_hw_bytes 引數由裝置驅動程式設定為單個操作中可丟棄的最大位元組數。發往裝置的丟棄請求不得超過此限制。discard_max_hw_bytes 值為 0 表示裝置不支援丟棄功能。

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

在檔案 sysfs-block 中定義

[只讀] 將始終返回 0。不要依賴於丟棄的任何特定行為，並且不要讀取此檔案。

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

在檔案 sysfs-block 中定義

報告使用者空間地址必須具有的對齊方式，以便透過 O_DIRECT 和其他驅動程式特定的直通機制用於原始塊裝置訪問。

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

在檔案 sysfs-block 中定義

[只讀] 塊驅動程式是否支援寫入請求的 FUA 標誌。FUA 代表強制單元訪問。如果設定了 FUA 標誌，則意味著寫入請求必須繞過儲存裝置的易失性快取。

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

在檔案 sysfs-block 中定義

[只讀] 這是裝置的硬體扇區大小，以位元組為單位。

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

在檔案 sysfs-block 中定義

[只讀] /sys/block/xxx/queue/ 目錄的此子目錄的存在表明裝置能夠並行執行針對不同扇區範圍的請求。例如，如果裝置正確地宣傳其執行器的扇區範圍，則單 LUN 多執行器硬碟將具有 independent_access_ranges 目錄。

independent_access_ranges 目錄包含每個訪問範圍的一個目錄，每個範圍都使用 sector (RO) 屬性檔案指示範圍的第一個扇區，並使用 nr_sectors (RO) 屬性檔案指示從範圍的第一個扇區開始的範圍內的扇區總數。例如，雙執行器硬碟將具有以下 independent_access_ranges 條目。

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

扇區和 nr_sectors 屬性使用 512B 扇區單位，無論裝置的實際塊大小如何。獨立訪問範圍不重疊，並且包含裝置容量內的所有扇區。訪問範圍按範圍起始扇區的遞增順序編號，即範圍 0 的扇區屬性始終為 0。

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

在檔案 sysfs-block 中定義

[讀寫] 讀取時，此檔案顯示輪詢是啟用 (1) 還是停用 (0)。向此檔案寫入“0”將停用此裝置的輪詢。寫入任何非零值將啟用此功能。

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

在檔案 sysfs-block 中定義

[讀寫] 此引數用於控制將執行何種輪詢。它現在固定為 -1，即經典輪詢。在此模式下，CPU 將重複請求完成，而不放棄任何時間。<已棄用>

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

在檔案 sysfs-block 中定義

[讀寫] io_timeout 是請求超時時間，以毫秒為單位。如果請求在此時間內未完成，則會呼叫塊驅動程式超時處理程式。該超時處理程式可以決定重試請求、使其失敗或啟動裝置恢復策略。

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

在檔案 sysfs-block 中定義

[讀寫] 此檔案用於控制磁碟的 I/O 統計資訊記賬（開/關）。

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

在檔案 sysfs-block 中定義

[讀寫] 此檔案用於控制磁碟對直通命令的 I/O 統計資訊記賬（開/關）。

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

在檔案 sysfs-block 中定義

[只讀] 這是儲存裝置可以定址的最小單位。通常為 512 位元組。

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

在檔案 sysfs-block 中定義

[只讀] 對於分割槽塊裝置（ zoned 屬性指示“主機管理”或“主機感知”），屬於任何分割槽狀態：EXPLICIT OPEN、IMPLICIT OPEN 或 CLOSED 的分割槽總和受此值限制。如果此值為 0，則沒有限制。

如果主機嘗試超出此限制，驅動程式應報告 BLK_STS_ZONE_ACTIVE_RESOURCE 錯誤，使用者空間可能會將其視為 EOVERFLOW 錯誤碼。

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

在檔案 sysfs-block 中定義

[只讀] 丟棄請求中 DMA 散佈/聚集條目的最大數量。

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

在檔案 sysfs-block 中定義

[只讀] 這是單個數據傳輸支援的最大千位元組數。

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

在檔案 sysfs-block 中定義

[只讀] DMA 散佈/聚集列表中具有完整性資料的元素的最大數量，這些元素將由塊層核心提交給關聯的塊驅動程式。

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

在檔案 sysfs-block 中定義

[只讀] 對於分割槽塊裝置（ zoned 屬性指示“主機管理”或“主機感知”），屬於任何分割槽狀態：EXPLICIT OPEN 或 IMPLICIT OPEN 的分割槽總和受此值限制。如果此值為 0，則沒有限制。

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

在檔案 sysfs-block 中定義

[讀寫] 這是塊層允許的檔案系統請求的最大千位元組數。必須小於或等於硬體允許的最大大小。寫入 0 以使用預設核心設定。

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

在檔案 sysfs-block 中定義

[只讀] DMA 散佈/聚集列表中單個元素的最大大小（以位元組為單位）。

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

在檔案 sysfs-block 中定義

[只讀] 提交到關聯塊驅動程式的 DMA 散佈/聚集列表中的元素的最大數量。

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

在檔案 sysfs-block 中定義

[只讀] 支援的最大寫入流數量，如果不支援則為 0。如果支援，有效值為 1 到 max_write_streams（含）之間。

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

在檔案 sysfs-block 中定義

[只讀] 儲存裝置可能會報告粒度或首選最小 I/O 大小，這是裝置可以在不產生效能損失的情況下執行的最小請求。對於磁碟驅動器，這通常是物理塊大小。對於 RAID 陣列，這通常是條帶塊大小。minimum_io_size 的適當對齊倍數是需要大量 I/O 操作的工作負載的首選請求大小。

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

在檔案 sysfs-block 中定義

[讀寫] 標準 I/O 電梯操作包括嘗試合併連續 I/O。對於已知的隨機 I/O 負載，這些嘗試將始終失敗，導致核心花費額外的週期。這允許以兩種方式之一關閉此行為：當設定為 1 時，停用複雜的合併檢查，但啟用與先前 I/O 請求的簡單一次性合併。當設定為 2 時，所有合併嘗試都被停用。預設值為 0，啟用所有型別的合併嘗試。

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

在檔案 sysfs-block 中定義

[讀寫] 這控制塊層中可為讀寫請求分配的請求數量。請注意，分配的總數可能是此數量的兩倍，因為它僅適用於讀或寫（而非累積總和）。

為了避免透過請求飢餓導致的優先順序反轉，當 CONFIG_BLK_CGROUP 啟用時，請求佇列會為每個 cgroup 維護一個單獨的請求池，並且此引數適用於每個此類每塊 cgroup 請求池。換句話說，如果存在 N 個塊 cgroup，每個請求佇列最多可以有 N 個請求池，每個池都由 nr_requests 獨立管理。

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

在檔案 sysfs-block 中定義

[只讀] nr_zones 指示分割槽塊裝置（“主機感知”或“主機管理”分割槽模型）的總分割槽數量。對於常規塊裝置，此值始終為 0。

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

在檔案 sysfs-block 中定義

[只讀] 儲存裝置可能會報告最佳 I/O 大小，這是裝置用於持續 I/O 的首選單位。磁碟驅動器很少報告此值。對於 RAID 陣列，它通常是條頻寬度或內部磁軌大小。optimal_io_size 的適當對齊倍數是需要持續吞吐量的工作負載的首選請求大小。如果未報告最佳 I/O 大小，則此檔案包含 0。

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

在檔案 sysfs-block 中定義

[只讀] 這是物理儲存裝置可以原子寫入的最小單位。它通常與邏輯塊大小相同，但可能更大。一個例子是 SATA 驅動器，它具有 4KB 扇區，但向作業系統公開 512 位元組的邏輯塊大小。對於堆疊塊裝置，physical_block_size 變數包含元件裝置的最大 physical_block_size。

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

在檔案 sysfs-block 中定義

[讀寫] 此塊裝置上檔案系統預讀的最大千位元組數。

對於 MADV_HUGEPAGE，預讀大小可能會超過此設定，因為其粒度基於大頁面大小。

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

在檔案 sysfs-block 中定義

[讀寫] 此檔案用於指示裝置是旋轉型別還是非旋轉型別。

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

在檔案 sysfs-block 中定義

[讀寫] 如果此選項設定為“1”，塊層會將請求完成遷移到最初提交請求的 CPU“組”。對於某些工作負載，由於快取效應，這可以顯著減少 CPU 週期。

對於需要最大化完成處理分佈的儲存配置，將此選項設定為“2”會強制完成在請求 CPU 上執行（繞過“組”聚合邏輯）。

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

在檔案 sysfs-block 中定義

[讀寫] 讀取時，此檔案將顯示此塊裝置的當前和可用 I/O 排程程式。當前活動的 I/O 排程程式將用 [] 括號括起來。向此檔案寫入 I/O 排程程式名稱將把此塊裝置的控制權切換到新的 I/O 排程程式。請注意，向此檔案寫入 I/O 排程程式名稱將嘗試載入該 I/O 排程程式模組，如果它尚未存在於系統中。

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

在檔案 sysfs-block 中定義

[讀寫] 如果記憶體在用於此裝置的寫入請求時不得修改，則此檔案將包含“1”。在這種情況下，如果核心正在執行頁面回寫，核心將等待回寫完成，然後才允許再次修改頁面，而不是像通常那樣允許立即修改。此限制產生於裝置多次訪問記憶體，並且每次都必須看到相同資料的情況——例如，一次用於計算校驗和，一次用於實際寫入資料。如果不存在此類限制，則此檔案將包含“0”。此檔案可用於測試目的。

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

在檔案 sysfs-block 中定義

[只讀] 此檔案顯示塊裝置的 I/O 段記憶體對齊掩碼。對該裝置的 I/O 請求將在以下情況下在段之間拆分：前一個段的記憶體地址末尾或當前段的記憶體地址開頭未與 virt_boundary_mask + 1 位元組對齊。

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

在檔案 sysfs-block 中定義

[讀寫] 如果裝置已註冊用於回寫限流，則此檔案顯示目標最小讀取延遲。如果此延遲在給定時間視窗內（參見 wb_window_usec）被超過，則回寫限流將開始縮減寫入。向此檔案寫入“0”值將停用此功能。向此檔案寫入“-1”值將把值重置為預設設定。

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

在檔案 sysfs-block 中定義

[讀寫] 讀取時，此檔案將顯示裝置是否啟用了寫回快取。前一種情況將返回“write back”，後一種情況將返回“write through”。寫入此檔案可以改變核心對裝置的看法，但它不會改變裝置狀態。這意味著將設定從“write back”切換到“write through”可能不安全，因為那也會消除核心發出的快取重新整理。

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

在檔案 sysfs-block 中定義

[只讀] 某些裝置支援寫相同操作，其中單個數據塊可以寫入儲存上連續的幾個塊範圍。這可用於擦除磁碟區域或初始化 RAID 配置中的驅動器。write_same_max_bytes 指示單個寫相同命令中可寫入的位元組數。如果 write_same_max_bytes 為 0，則裝置不支援寫相同。

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

在檔案 sysfs-block 中定義

[只讀] 寫入流的粒度，以位元組為單位。寫入流的粒度是應該一起丟棄或覆蓋的大小，以避免裝置中的寫入放大。

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

在檔案 sysfs-block 中定義

[只讀] 支援寫入零操作的裝置，其中可以發出單個請求以將儲存上連續塊的範圍清零，而請求中不包含任何有效載荷。這可用於最佳化向裝置寫入零。write_zeroes_max_bytes 指示單個寫入零命令中可以寫入的位元組數。如果 write_zeroes_max_bytes 為 0，則裝置不支援寫入零。

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

在檔案 sysfs-block 中定義

[只讀] 這是可以使用區域追加寫入操作 (REQ_OP_ZONE_APPEND) 寫入分割槽塊裝置的順序區域的最大位元組數。對於常規塊裝置，此值始終為 0。

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

在檔案 sysfs-block 中定義

[只讀] 這表示分割槽塊裝置（具有報告“host-managed”或“host-aware”的 zoned 屬性的裝置）的順序分割槽中寫入操作的對齊約束（以位元組為單位）。對於常規塊裝置，此值始終為 0。

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

在檔案 sysfs-block 中定義

[只讀] zoned 指示裝置是否為分割槽塊裝置以及如果確實是分割槽裝置則指示其分割槽模型。zoned 指示的可能值為常規塊裝置的“none”以及分割槽塊裝置的“host-aware”或“host-managed”。主機感知和主機管理分割槽塊裝置的特性在 ZBC (Zoned Block Commands) 和 ZAC (Zoned Device ATA Command Set) 標準中描述。這些標準還定義了“drive-managed”分割槽模型。但是，由於驅動器管理分割槽塊裝置不支援分割槽命令，它們將被視為常規塊裝置，並且 zoned 將報告“none”。

/sys/block/<disk>/stat

在檔案 sysfs-block 中定義

/sys/block/<disk>/stat 檔案顯示磁碟 <disk> 的 I/O 統計資訊。它們包含 11 個欄位

1	成功完成的讀取操作
2	合併的讀取操作
3	讀取扇區數
4	讀取耗時 (毫秒)
5	完成的寫入操作
6	合併的寫入操作
7	寫入扇區數
8	寫入耗時 (毫秒)
9	當前正在進行的 I/O 運算元
10	執行 I/O 耗時 (毫秒)
11	執行 I/O 加權耗時 (毫秒)
12	完成的丟棄操作
13	合併的丟棄操作
14	丟棄扇區數
15	丟棄耗時 (毫秒)
16	完成的重新整理請求
17	重新整理耗時 (毫秒)

有關更多詳細資訊，請參閱 I/O 統計欄位

/sys/bus 下的符號¶

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

在檔案 sysfs-driver-dma-idxd 中定義

字元裝置驅動程式分配給此裝置的主裝置號。

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

在檔案 sysfs-driver-dma-idxd 中定義

上次執行的裝置管理命令的狀態/錯誤。也包含上次配置錯誤。寫入此檔案將清除狀態。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示此裝置是否可配置。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置下分配的引擎。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置的錯誤資訊。

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

在檔案 sysfs-driver-dma-idxd 中定義

要配置的事件日誌大小。預設值為 64 個條目，如果 evl 條目為 64 位元組，則佔用 4k 大小。僅在支援此功能的平臺上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置下分配的組。

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

在檔案 sysfs-driver-dma-idxd 中定義

IAA (IAX) 能力掩碼。匯出到使用者空間供應用程式使用。此屬性僅在版本 2 或更高版本的 IAA 裝置上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

批處理中工作描述符的最大數量。當裝置不支援批處理時不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置支援的最大引擎數量。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置下可建立的最大組數量。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置支援的讀取緩衝區總數。讀取緩衝區代表 DSA 實現中的資源，這些資源由引擎分配以支援操作。參見 DSA 規範 v1.2 9.2.4 總讀取緩衝區。當裝置不支援讀取緩衝區分配控制時，此屬性不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

從源地址讀取以執行操作的位元組數。最大傳輸大小取決於提交描述符的工作佇列。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置支援的最大工作佇列數量。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置支援的最大工作佇列大小。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置的 NUMA 節點號。

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

在檔案 sysfs-driver-dma-idxd 中定義

操作能力位掩碼指定此裝置支援的操作型別。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示此裝置是否啟用了使用者 PASID（程序地址空間識別符號）。

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

在檔案 sysfs-driver-dma-idxd 中定義

訪問裝置中低頻寬記憶體的操作一次可能使用的最大讀取緩衝區數量。參見 DSA 規範 v1.2 9.2.8 GENCFG 全域性讀取緩衝區限制。當裝置不支援讀取緩衝區分配控制時，此屬性不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置的狀態資訊。可以是啟用或停用。

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

在檔案 sysfs-driver-dma-idxd 中定義

硬體版本號。

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

在檔案 sysfs-driver-dma-idxd 中定義

此裝置下分配的工作佇列。

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

在檔案 sysfs-driver-dma-idxd 中定義

此引擎所屬的組。

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

在檔案 sysfs-driver-dma-idxd 中定義

允許控制組中引擎可以同時處理的批處理描述符的數量，作為 ENGCAP 暫存器中指定的最大批處理描述符在進行中值的一部分。可接受的值為 0（預設）、1（最大值的 1/2）、2（最大值的 1/4）和 3（最大值的 1/8）。僅在支援此功能的平臺上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

允許控制組中引擎可以同時處理的工作描述符的數量，作為 ENGCAP 暫存器中指定的最大工作描述符在進行中值的一部分。可接受的值為 0（預設）、1（最大值的 1/2）、2（最大值的 1/4）和 3（最大值的 1/8）。僅在支援此功能的平臺上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示組中所有引擎一次可能使用的最大讀取緩衝區數量。參見 DSA 規範 v1.2 9.2.18 GRPCFG 允許讀取緩衝區。當裝置不支援讀取緩衝區分配控制時，此屬性不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示為組中引擎使用而保留的讀取緩衝區數量。參見 DSA 規範 v1.2 9.2.18 GRPCFG 保留讀取緩衝區。當裝置不支援讀取緩衝區分配控制時，此屬性不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

為組啟用全域性讀取緩衝區限制。參見 DSA 規範 v1.2 9.2.18 GRPCFG 使用全域性讀取緩衝區限制。當裝置不支援讀取緩衝區分配控制時，此屬性不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示工作佇列是否啟用了 ATS 停用。0 表示 ATS 已啟用，1 表示工作佇列已停用 ATS。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示工作佇列是否允許在故障時阻塞以支援按需分頁。

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

在檔案 sysfs-driver-dma-idxd 中定義

字元裝置驅動程式分配給此工作佇列的次裝置號。

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

在檔案 sysfs-driver-dma-idxd 中定義

要繫結到工作佇列的驅動程式名稱。

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

在檔案 sysfs-driver-dma-idxd 中定義

顯示此應用程式導致的完成記錄 (CR) 故障失敗次數。當驅動程式無法將 CR 的地址調入故障時，故障計數器會遞增。通常這是由於提交的描述符中程式設計的地址錯誤或惡意提交者故意使用錯誤的 CR 地址造成的。

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

在檔案 sysfs-driver-dma-idxd 中定義

顯示此應用程式導致的完成記錄 (CR) 故障次數。

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

在檔案 sysfs-driver-dma-idxd 中定義

顯示開啟檔案的應用程式的程序 ID。這對於想要終止開啟檔案的應用程式的監視守護程式來說是很有用的資訊。

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

在檔案 sysfs-driver-dma-idxd 中定義

指示在共享工作佇列上提交 enqcmds 的重試次數。設定屬性的最大值限制為 64。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列所屬的組 ID。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列的最大批處理大小。不能超過裝置最大批處理大小。可配置引數。當裝置不支援批處理時不可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列的最大傳輸大小。不能超過裝置最大傳輸大小。可配置引數。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列的工作佇列模式型別。

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

在檔案 sysfs-driver-dma-idxd 中定義

如果工作佇列能力中的工作佇列佔用支援位為 1，則顯示此工作佇列中的當前條目數。

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

在檔案 sysfs-driver-dma-idxd 中定義

顯示以點陣圖格式表示的操作能力位，由 %*pb printk() 輸出格式說明符呈現。當工作佇列被停用時可以配置此屬性，以便將工作佇列配置為接受與允許的操作相關的特定位。僅在支援此功能的平臺上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列的優先順序值，它是相對於同一組中其他工作佇列的值，用於控制從同一組中的多個工作佇列排程工作時的服務質量。

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

在檔案 sysfs-driver-dma-idxd 中定義

控制工作佇列是否啟用了 PRS 停用。0 表示 PRS 已啟用，1 表示工作佇列已停用 PRS。如果設定此選項，它將覆蓋 block_on_fault 屬性。僅在支援此功能的平臺上可見。

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

在檔案 sysfs-driver-dma-idxd 中定義

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

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

在檔案 sysfs-driver-dma-idxd 中定義

工作佇列的當前狀態。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列中可透過有限門戶填充的條目數。

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

在檔案 sysfs-driver-dma-idxd 中定義

此工作佇列的型別，它可以是核心空間中工作佇列使用的“kernel”型別，或者使用者空間中應用程式工作佇列使用的“user”型別。

/sys/bus/firewire/devices/*/

在檔案 sysfs-bus-firewire 中定義

IEEE 1394 節點裝置和單元裝置的通用屬性。只讀。在節點裝置的生命週期內可變。在單元裝置的生命週期內不可變。有關語義定義，請參閱 IEEE 1212。

僅當 IEEE 1394 節點的根目錄或 IEEE 1394 單元的單元目錄實際包含相應條目時，才會建立這些屬性。

hardware_version: u24 的十六進位制字串表示。
hardware_version_name: 相應文字描述符葉的內容。
model: u24 的十六進位制字串表示。
model_name: 相應文字描述符葉的內容。
specifier_id: u24 的十六進位制字串表示。根據 IEEE 1212，在單元目錄中是強制性的。
vendor: u24 的十六進位制字串表示。根據 IEEE 1212，在根目錄中是強制性的。
vendor_name: 相應文字描述符葉的內容。
version: u24 的十六進位制字串表示。根據 IEEE 1212，在單元目錄中是強制性的。

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

在檔案 sysfs-bus-firewire 中定義

IEEE 1394 節點裝置屬性。只讀。在節點裝置的生命週期內可變。有關語義定義，請參閱 IEEE 1212。

config_rom: 配置 ROM 暫存器的內容。二進位制屬性；一個主機位元組序 u32 陣列。
guid: 配置 ROM 匯流排資訊塊中的節點 EUI-64。u64 的十六進位制字串表示。

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

在檔案 sysfs-bus-firewire 中定義

IEEE 1394 節點裝置屬性。只讀且不可變。值：1：sysfs 條目表示本地節點（控制器卡）。

0：sysfs 條目表示遠端節點。

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

在檔案 sysfs-bus-firewire 中定義

IEEE 1394 節點裝置屬性。只讀。在節點裝置的生命週期內可變。有關語義定義，請參閱 IEEE 1212。

units: IEEE 1394 節點中所有單元的摘要。包含以空格分隔的每個單元的 specifier_id 和 version 元組。每個元組中的 specifier_id 和 version 以冒號分隔，是相應單元目錄條目中 u24 的十六進位制字串表示。
使用者: udev 規則設定 /dev/fw[0-9]+ 字元裝置檔案的所有權和訪問許可權或 ACL

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

在檔案 sysfs-bus-firewire 中定義

IEEE 1394 單元裝置屬性。只讀。在單元裝置的生命週期內不可變。有關語義定義，請參閱 IEEE 1212。

modalias: 與裝置建立時 uevent 中的 MODALIAS 相同。
rom_index: 單元目錄在父裝置（節點裝置）配置 ROM 中的偏移量，以四字（quadlets）為單位。十進位制字串表示。

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

舊稱

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

在檔案 sysfs-bus-firewire 中定義

SCSI 目標埠識別符號和 SBP-2 目標邏輯單元的邏輯單元識別符號。這些識別符號在 SAM-2...SAM-4 附錄 A 中指定。它們是 SBP-2 連線目標的持久且全球唯一的屬性。

只讀屬性，在目標的生命週期內不可變。格式，自 2.6.22 版（2007 年 5 月）以來 firewire-sbp2 公開的格式：冒號分隔的十六進位制字串表示形式

u64 EUI-64 : u24 directory_ID : u16 LUN

不帶 0x 字首，不帶空格。前一個 sbp2 驅動程式（在 2.6.37 版中被 firewire-sbp2 取代後移除）使用了稍短的格式，與 SAM 不那麼接近。

使用者: udev 規則以建立 /dev/disk/by-id/ 符號連結

/sys/bus/fsl-mc/autorescan

在檔案 sysfs-bus-fsl-mc 中定義

向此屬性寫入零值將停用 DPRC IRQ，從而停止對 fsl-mc 匯流排的自動重新掃描。非零值將啟用 DPRC IRQ。

使用者: 使用者空間驅動程式和管理工具

/sys/bus/fsl-mc/rescan

在檔案 sysfs-bus-fsl-mc 中定義

向此屬性寫入非零值將強制系統重新掃描 fsl-mc 匯流排，並同步 fsl-mc 匯流排下的物件和管理複合體韌體。

使用者: 使用者空間驅動程式和管理工具

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

在檔案 sysfs-bus-mhi 中定義

該檔案儲存透過 BHI（引導主機介面）暫存器讀取獲得的端點裝置的 OEM PK Hash 值，至少在嘗試上電該裝置一次之後。如果裝置未至少上電一次就讀取，該檔案將全部讀取 0。

使用者: 任何對裝置資訊感興趣的使用者空間應用程式或客戶端。

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

在檔案 sysfs-bus-mhi 中定義

該檔案儲存透過 BHI（引導主機介面）暫存器讀取獲得的客戶端裝置的序列號，至少在嘗試上電該裝置一次之後。如果裝置未至少上電一次就讀取，該檔案將全部讀取 0。

使用者: 任何對裝置資訊感興趣的使用者空間應用程式或客戶端。

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

在檔案 sysfs-bus-mhi 中定義

在 MHI 控制器上啟動 SoC 復位。SoC 復位是最後的復位手段，需要完全重新初始化。如果裝置無響應，這可以作為一種恢復方法；或者作為系統管理任務，用於載入新韌體。

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

在檔案 sysfs-bus-mhi 中定義

向此檔案寫入非零值將強制裝置進入 EDL（緊急下載）模式。此條目僅適用於能夠使用 MHI 規範 v1.2 中定義的標準 EDL 觸發機制進入 EDL 模式的裝置。一旦進入 EDL 模式，快閃記憶體程式設計器映像可以下載到裝置以進入快閃記憶體程式設計器執行環境。如果使用者希望使用 QDL（高通下載，用於透過 EDL 下載韌體）更新韌體，這會很有用。

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

在檔案 sysfs-bus-nvmem 中定義

此讀/寫屬性允許使用者將讀寫裝置設定為只讀，然後從使用者空間再改回讀寫。這可用於解鎖和重新鎖定裝置的防寫，這些裝置通常處於鎖定狀態，除了偶爾的程式設計操作。讀取返回“0”或“1”分別表示讀寫模式或只讀模式。寫入解析“YyTt1NnFf0”之一，或“[oO][NnFf]”表示“on”和“off”，即 kstrtobool() 支援的格式。注意：此檔案僅在 CONFIG_NVMEM_SYSFS 啟用時存在。

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

在檔案 sysfs-bus-nvmem 中定義

此檔案允許使用者讀/寫原始 NVMEM 內容。此檔案的寫入許可權取決於 nvmem 供應商配置。注意：此檔案僅在 CONFIG_NVMEM_SYSFS 啟用時存在。

例如

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

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

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

在檔案 sysfs-bus-nvmem 中定義

此只讀屬性允許使用者讀取 NVMEM 裝置型別。支援的型別有“Unknown”、“EEPROM”、“OTP”、“Battery backed”、“FRAM”。注意：此檔案僅在 CONFIG_NVMEM_SYSFS 啟用時存在。

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

在檔案 sysfs-driver-qla2xxx 中定義

qla2xxx-udev.sh 目前會查詢 uevent CHANGE 事件，以指示驅動程式已生成韌體轉儲並可供檢索。

使用者: qla2xxx-udev.sh。建議的更改應傳送至 linux-driver@qlogic.com

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

在檔案 sysfs-driver-aspeed-vuart 中定義

配置 UART 的主機側在主機 <-> BMC LPC 總線上出現的 I/O 埠。

使用者: OpenBMC。建議的更改應傳送至 openbmc@lists.ozlabs.org

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

在檔案 sysfs-driver-aspeed-vuart 中定義

配置 UART 的主機側在主機 <-> BMC LPC 總線上出現的之中斷號。

使用者: OpenBMC。建議的更改應傳送至 openbmc@lists.ozlabs.org

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

在檔案 sysfs-driver-aspeed-vuart 中定義

配置透過 BMC LPC 匯流排傳送到主機的序列中斷的極性。設定為 0 為低電平有效，設定為 1 為高電平有效。

使用者: OpenBMC。建議的更改應傳送至 openbmc@lists.ozlabs.org

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

在檔案 sysfs-bus-usb 中定義

向此檔案寫入 1 會告訴核心，此裝置在復位時將轉換為另一種模式。驅動程式不會對此類裝置使用復位進行錯誤處理。

使用者: usb_modeswitch

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

在檔案 sysfs-bus-usb 中定義

如果 CONFIG_PM 啟用，則此檔案存在。讀取時，它返回 USB 裝置處於活動狀態（即未處於掛起狀態）的總時間（以毫秒為單位）。此檔案是隻讀的。

工具可以使用此檔案和 connected_duration 檔案計算裝置處於活動狀態的時間百分比。例如

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

將給出整數百分比。請注意，這不包括計數器迴繞。

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

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

在檔案 sysfs-bus-usb 中定義

如果啟用了 CONFIG_PM，則此檔案存在。讀取時，它返回 USB 裝置連線到機器的總時間（以毫秒為單位）。此檔案是隻讀的。

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

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

在檔案 sysfs-bus-usb 中定義

裝置的活動配置的 bConfigurationValue。將 0 或 -1 寫入 bConfigurationValue 將重置活動配置（取消配置裝置）。寫入其他值將更改活動配置。

請注意，某些裝置違反 USB 規範，其配置值為 0。將 0 寫入這些裝置的 bConfigurationValue 將安裝該配置，而不是取消配置裝置。

寫入 -1 將始終取消配置裝置。

使用者: libusb

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

在檔案 sysfs-bus-usb 中定義

裝置連線到的 USB 匯流排的匯流排號。

使用者: libusb

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

在檔案 sysfs-bus-usb 中定義

包含裝置快取描述符的二進位制檔案。二進位制資料由裝置描述符和每個裝置配置的描述符組成。請注意，配置描述符的 wTotalLength 不可信，因為裝置可能具有比其宣稱的更小的配置描述符。每個（子）描述符的 bLength 欄位是可信的，可用於一次向前查詢一個（子）描述符，直到找到下一個描述符。從該檔案讀取的所有描述符都採用匯流排位元組序格式。

使用者: libusb

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

在檔案 sysfs-bus-usb 中定義

USB 總線上的裝置地址。

使用者: libusb

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

在檔案 sysfs-bus-usb 中定義

每個 USB 裝置目錄都將包含一個名為 power/autosuspend 的檔案。此檔案儲存裝置必須空閒的時間（以秒為單位），然後才能自動掛起。0 表示裝置將盡快自動掛起。負值將完全阻止裝置自動掛起，寫入負值將恢復已掛起的裝置。

新建立裝置的自動掛起延遲設定為 usbcore.autosuspend 模組引數的值。

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

在檔案 sysfs-bus-usb 中定義

USB 裝置目錄可以包含一個名為 power/persist 的檔案。該檔案包含一個布林值（0 或 1），指示裝置是否啟用了“USB-Persist”功能。對於集線器，此功能始終啟用，其裝置目錄將不包含此檔案。

有關更多資訊，請參閱系統掛起期間的 USB 裝置永續性。

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

在檔案 sysfs-bus-usb 中定義

裝置連線到 USB 主機的速度，單位為 Mbit/秒。即 1.5 / 12 / 480 / 5000 中的一個。

使用者: libusb

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

在檔案 sysfs-bus-usb 中定義

讀取時，如果此介面的介面驅動程式支援自動掛起，則此檔案返回 1。如果沒有任何驅動程式宣告此介面，它也返回 1，因為如果所有其他介面驅動程式都處於空閒狀態，未宣告的介面不會阻止裝置自動掛起。如果驅動程式尚未新增自動掛起支援，則檔案返回 0。

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

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

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

定義於檔案 sysfs-driver-usb-usbtmc

這些檔案顯示了裝置本身描述的各種 USB TMC 功能。位欄位的完整描述可在 USB-IF 釋出的名為“通用序列匯流排測試和測量類規範 (USBTMC) 修訂版 1.0”的 USB TMC 文件第 4.2.1.8 節中找到。

這些檔案是隻讀的。

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

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

定義於檔案 sysfs-driver-usb-usbtmc

這些檔案顯示了裝置本身描述的各種 USB TMC 功能。位欄位的完整描述可在 USB-IF 釋出的名為“通用序列匯流排測試和測量類，子類 USB488 規範 (USBTMC-USB488) 修訂版 1.0”的 USB TMC 文件第 4.2.2 節中找到。

這些檔案是隻讀的。

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

定義於檔案 sysfs-bus-vmbus

主/子通道繫結到哪個虛擬處理器的對映。格式：<通道的 child_relid:繫結的 CPU 編號>

使用者: tools/hv/lsvmbus

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

定義於檔案 sysfs-bus-vmbus

每個通道資訊的目錄 NN 是與通道關聯的 VMBUS relid。

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

定義於檔案 sysfs-bus-vmbus

VCPU（子）通道親和於

使用者: tools/hv/lsvmbus 和其他除錯工具

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

定義於檔案 sysfs-bus-vmbus

我們向主機發出訊號的次數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

主機到客戶機通道中斷掩碼

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

我們已接受中斷（傳入）的次數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

傳入環形緩衝區從滿到不滿轉換，同時資料包等待緩衝區空間可用時，導致客戶機到主機中斷的次數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

出站環形緩衝區從空到非空轉換時，導致客戶機到主機中斷的次數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

通道訊號延遲。此檔案僅適用於使用監視器頁機制的效能關鍵通道（儲存、網路等）。

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

與通道關聯的監視器位。此檔案僅適用於使用監視器頁機制的效能關鍵通道（儲存、網路等）。

使用者: 除錯工具和使用者空間驅動程式

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

定義於檔案 sysfs-bus-vmbus

首次遇到出站環形緩衝區滿條件的寫入操作次數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

遇到出站環形緩衝區滿條件的寫入操作總數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

客戶機到主機通道中斷掩碼

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

通道中斷掛起狀態。此檔案僅適用於使用監視器頁機制的效能關鍵通道（儲存、網路等）。

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

可讀位元組數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

uio_hv_generic 為環形緩衝區建立的二進位制檔案

使用者: 使用者空間驅動程式

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

定義於檔案 sysfs-bus-vmbus

與 VMBUS 通道關聯的子通道 ID

使用者: 除錯工具和使用者空間驅動程式

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

定義於檔案 sysfs-bus-vmbus

可寫位元組數

使用者: 除錯工具

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

定義於檔案 sysfs-bus-vmbus

裝置的 VMBus 介面型別 GUID

使用者: tools/hv/lsvmbus

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

定義於檔案 sysfs-bus-vmbus

裝置的 16 位裝置 ID

使用者: tools/hv/lsvmbus 和使用者級 RDMA 庫

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

定義於檔案 sysfs-bus-vmbus

裝置的 VMBus 介面例項 GUID

使用者: tools/hv/lsvmbus

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

定義於檔案 sysfs-bus-vmbus

裝置主通道的 VMBus child_relid

使用者: tools/hv/lsvmbus

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

定義於檔案 sysfs-bus-vmbus

VMBUS 裝置附加到的 NUMA 節點，如果節點未知則為 -1。

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

定義於檔案 sysfs-bus-vmbus

裝置的 16 位供應商 ID

使用者: tools/hv/lsvmbus 和使用者級 RDMA 庫

/sys/bus/vmbus/hibernation

定義於檔案 sysfs-bus-vmbus

主機是否支援虛擬機器的休眠。

使用者: 為休眠設定交換分割槽/檔案的守護程序。

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

定義於檔案 sysfs-driver-w1_ds28e04

讀取/寫入 DS28E04-100 的 EEPROM 記憶體內容，有關詳細資訊請參閱核心驅動程式 w1_ds28e04

使用者: 任何希望與 DS28E04-100 通訊的使用者空間應用程式

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

定義於檔案 sysfs-driver-w1_ds2438

寫入內容到 DS2438 的偏移暫存器，有關詳細資訊請參閱核心驅動程式 w1_ds2438

使用者: 任何希望與 DS2438 通訊的使用者空間應用程式

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

定義於檔案 sysfs-driver-w1_ds2438

讀取 DS2438 的 page1 內容，有關詳細資訊請參閱核心驅動程式 w1_ds2438

使用者: 任何希望與 DS2438 通訊的使用者空間應用程式

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

定義於檔案 sysfs-driver-w1_ds28e04

讀取/寫入 DS28E04-100 的兩個 PIO 內容，有關詳細資訊請參閱核心驅動程式 w1_ds28e04

使用者: 任何希望與 DS28E04-100 通訊的使用者空間應用程式

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

定義於檔案 sysfs-bus-w1

匯流排掃描間隔，微秒分量。一些通常與物理訪問控制系統相關的 1-Wire 裝置連線/生成存在時間短至 100 毫秒 - 因此需要數十到數百毫秒的掃描間隔。

有關詳細資訊，請參閱 1-wire (w1) 子系統簡介。

使用者: 任何希望瞭解匯流排掃描間隔的使用者空間應用程式

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

定義於檔案 sysfs-driver-w1_ds28ea00

支援 DS28EA00 鏈序列功能，有關詳細資訊請參閱核心驅動程式 w1_therm

使用者: 任何希望與 DS28EA00 通訊的使用者空間應用程式

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

定義於檔案 sysfs-platform-wmi-bmof

二進位制 MOF 元資料，用於描述可用 ACPI WMI 介面的詳細資訊。

有關詳細資訊，請參閱 WMI 嵌入式二進位制 MOF 驅動程式。

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

定義於檔案 sysfs-bus-xen-backend

裝置型別。例如：'vbd'（塊裝置）、'vif'（網路裝置）或 'vfb'（幀緩衝裝置）之一。

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

定義於檔案 sysfs-bus-xen-backend

此後端裝置的 XenStore 節點（位於 /local/domain/NNN/ 下）。

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

定義於檔案 sysfs-bus-xen-backend

裝置狀態。以下之一：'Unknown'（未知）、'Initialising'（初始化中）、'Initialised'（已初始化）、'Connected'（已連線）、'Closing'（關閉中）、'Closed'（已關閉）、'Reconfiguring'（重新配置中）、'Reconfigured'（已重新配置）。

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

定義於檔案 sysfs-bus-xen-backend

塊裝置是隻讀（'r'）還是讀寫（'w'）。

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

定義於檔案 sysfs-bus-xen-backend

提供此後端塊裝置儲存的物理裝置的主:次編號（十六進位制）。

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

定義於檔案 sysfs-bus-xen-backend

來自前端的重新整理請求數量。

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

定義於檔案 sysfs-bus-xen-backend

因後端忙於處理之前的請求而延遲的請求數量。

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

定義於檔案 sysfs-bus-xen-backend

來自前端的讀取請求數量。

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

定義於檔案 sysfs-bus-xen-backend

前端讀取的扇區數量。

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

定義於檔案 sysfs-bus-xen-backend

來自前端的寫入請求數量。

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

定義於檔案 sysfs-bus-xen-backend

前端寫入的扇區數量。

Symbols under /sys/class¶

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

定義於檔案 sysfs-class-backlight

透過查詢硬體顯示實際亮度。由於硬體實現差異，這可能與“brightness”中的值不匹配。例如，某些硬體可能以不同方式處理消隱或具有自定義節電功能。使用者空間通常應使用“brightness”中的值進行決策。

使用者: HAL

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

定義於檔案 sysfs-class-backlight

控制背光電源，值與 fb.h 中的 FB_BLANK_* 相容

0 (FB_BLANK_UNBLANK)：電源開啟。

4 (FB_BLANK_POWERDOWN)：電源關閉

使用者: HAL

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

定義於檔案 sysfs-class-backlight

控制此 <backlight> 的亮度。值介於 0 和 max_brightness 之間。此檔案還將顯示驅動程式中儲存的亮度級別，這可能不是實際亮度（請參閱 actual_brightness）。

使用者: HAL

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

定義於檔案 sysfs-class-backlight

<backlight> 的最大亮度。

使用者: HAL

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

定義於檔案 sysfs-class-backlight

由 <backlight> 控制的介面型別。“firmware”（韌體）：驅動程式使用標準韌體介面。“platform”（平臺）：驅動程式使用平臺特定介面。“raw”（原始）：驅動程式直接控制硬體暫存器。

一般情況下，當單個裝置有多個背光介面可用時，韌體控制應優於平臺控制，平臺控制應優於原始控制。使用韌體介面可降低硬體和作業系統獨立更新背光狀態造成的混淆機率。平臺介面主要是韌體介面標準化之前的遺留。

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

定義於檔案 sysfs-class-bluetooth

此只寫屬性允許使用者在寫入任意資料時觸發藍牙裝置上的供應商復位方法。復位可以透過裝置傳輸（例如 UART/USB）完成，也可以不透過裝置傳輸完成，還可以透過帶外方法（例如 GPIO）完成。

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

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

定義於檔案 sysfs-class-infiniband

可選的“hw_counters”子目錄可以位於父裝置或埠子目錄下，或兩者兼有。如果存在，則有硬體提供的一系列計數器。它們可能與 counters 目錄中的某些計數器匹配，但通常包含許多其他計數器。除了各種計數器之外，還有一個名為“lifespan”的檔案，用於配置核心在訪問計數器時更新計數器的頻率（如果未訪問計數器，則不會更新）。lifespan 以毫秒為單位，預設為 10，除非驅動程式另行設定。使用者可以將 0-10000 之間的值寫入 lifespan 檔案，以設定更新之間的時間長度（以毫秒為單位）。

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

定義於檔案 sysfs-class-infiniband

(RO) 顯示韌體版本

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

定義於檔案 sysfs-class-infiniband

(RW) 使用節點主機名等資訊更新節點描述，以便 IB 網路管理軟體將其檢視與實際世界關聯起來。

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

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

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

定義於檔案 sysfs-class-infiniband

node_type	(RO) 節點型別（CA、RNIC、usNIC、usNIC UDP、交換機或路由器）
node_guid	(RO) 節點 GUID
sys_image_guid	(RO) 系統映象 GUID

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

定義於檔案 sysfs-class-infiniband

錯誤資訊:

symbol_error: (RO) 在一個或多個物理通道上檢測到的次要鏈路錯誤總數。

port_rcv_errors : (RO) 埠上收到的包含錯誤的報文總數。

port_rcv_remote_physical_errors : (RO) 埠上收到的標記有 EBP 分隔符的報文總數。

port_rcv_switch_relay_errors : (RO) 埠上收到的因無法透過交換機中繼轉發而被丟棄的報文總數。

link_error_recovery: (RO) 埠訓練狀態機成功完成鏈路錯誤恢復過程的總次數。

port_xmit_constraint_errors: (RO) 由於出站原始過濾或出站分割槽或 IP 版本檢查失敗，未從交換機物理埠傳輸的報文總數。

port_rcv_constraint_errors: (RO) 由於入站原始過濾或入站分割槽或 IP 版本檢查失敗，在交換機物理埠上收到的被丟棄的報文總數。

local_link_integrity_errors: (RO) 本地物理錯誤計數超過 LocalPhyErrors 指定閾值的次數。

excessive_buffer_overrun_errors: (RO) 此計數器表示輸入緩衝區溢位。它表示埠可能配置錯誤，無論是透過子網管理器 (SM) 還是使用者干預。它也可能表示硬體問題或極差的鏈路訊號完整性。

資料資訊:

port_xmit_data: (RO) 在所有 VL 上傳輸的資料八位位元組總數，除以 4（通道）。這是一個 64 位計數器。

port_rcv_data: (RO) 在所有 VL 上接收的資料八位位元組總數，除以 4（通道）。這是一個 64 位計數器。

port_xmit_packets: (RO) 從此埠在所有 VL 上傳輸的報文總數。這可能包括帶有錯誤的報文。這是一個 64 位計數器。

port_rcv_packets: (RO) 報文總數（這可能包括包含錯誤的報文）。這是一個 64 位計數器。

link_downed: (RO) 埠訓練狀態機在鏈路錯誤恢復過程中失敗並使鏈路斷開的總次數。

unicast_rcv_packets: (RO) 單播報文總數，包括包含錯誤的單播報文。

unicast_xmit_packets: (RO) 從該埠在所有 VL 上傳輸的單播報文總數。這可能包括帶有錯誤的單播報文。

multicast_rcv_packets: (RO) 多播報文總數，包括包含錯誤的多播報文。

multicast_xmit_packets: (RO) 從該埠在所有 VL 上傳輸的多播報文總數。這可能包括帶有錯誤的多播報文。

其他資訊:

port_xmit_discards: (RO) 埠因埠關閉或擁塞而丟棄的出站報文總數。

VL15_dropped: (RO) 由於埠資源限制（例如，緩衝區不足）而丟棄的傳入 VL15 報文數量。

port_xmit_wait: (RO) 埠有資料要傳輸但在整個滴答中未傳送任何資料（由於信用不足或缺少仲裁）的滴答數。

這些檔案中的每一個都包含來自埠的效能管理 PortCounters 屬性的相應值，如 InfiniBand 架構規範中所述。

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

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

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

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

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

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

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

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

定義於檔案 sysfs-class-infiniband

lid	(RO) 埠 LID
rate	(RO) 埠資料速率（活動寬度 * 活動速度）
lid_mask_count	(RO) 埠 LID 掩碼計數
sm_sl	(RO) 埠子網的子網管理器 SL
sm_lid	(RO) 埠子網的子網管理器 LID
state	(RO) 埠狀態（DOWN、INIT、ARMED、ACTIVE 或 ACTIVE_DEFER）
phys_state	(RO) 埠物理狀態（睡眠、輪詢、鏈路向上等）
cap_mask	(RO) 埠功能掩碼。此處有兩個位可設定 - IsCommunicationManagementSupported（在載入 CM 模組時設定）和 IsSM（透過開啟 issmN 檔案設定）。

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

定義於檔案 sysfs-class-infiniband

(RO) 鏈路層型別資訊（InfiniBand 或乙太網型別）

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

定義於檔案 sysfs-class-infiniband

與 GID 關聯的網路裝置名稱位於索引 <gid-index> 處。

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

定義於檔案 sysfs-class-infiniband

關聯 GID 的 RoCE 型別位於索引 <gid-index> 處。對於基於 IB 和 RoCE v1 的 GID，這可以是“IB/RoCE v1”，對於基於 RoCE v2 的 GID，這可以是“RoCE v2”。

/sys/class/infiniband/bnxt_reX/hw_rev

/sys/class/infiniband/bnxt_reX/hca_type

定義於檔案 sysfs-class-infiniband

hw_rev	(RO)	硬體版本號
hca_type	(RO)	主機通道介面卡型別

/sys/class/infiniband/cxgb4_X/hw_rev

/sys/class/infiniband/cxgb4_X/hca_type

/sys/class/infiniband/cxgb4_X/board_id

定義於檔案 sysfs-class-infiniband

hw_rev	(RO) 硬體版本號
hca_type	(RO) 驅動程式簡稱。通常應與其匯流排驅動程式結構（例如 pci_driver::name）中的名稱匹配。
board_id	(RO) 製造板 ID。（供應商 + 裝置資訊）

適用於 Intel IB 驅動程式 qib 的 sysfs 介面

/sys/class/infiniband/hfi1_X/hw_rev

/sys/class/infiniband/hfi1_X/board_id

/sys/class/infiniband/hfi1_X/nctxts

/sys/class/infiniband/hfi1_X/serial

/sys/class/infiniband/hfi1_X/chip_reset

/sys/class/infiniband/hfi1_X/boardversion

/sys/class/infiniband/hfi1_X/nfreectxts

/sys/class/infiniband/hfi1_X/tempsense

定義於檔案 sysfs-class-infiniband

hw_rev	(RO) 硬體版本號
board_id	(RO) 製造板 ID
nctxts	(RO) 可用上下文總數。
serial	(RO) 板序列號
chip_reset	(WO) 如果可能，將“reset”寫入此檔案以復位晶片。僅當沒有使用晶片資源的使用者上下文開啟時才允許。
boardversion	(RO) 人類可讀的板資訊
nfreectxts	(RO) 可用的空閒使用者埠（上下文）數量。
tempsense	(RO) 熱感資訊

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

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

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

定義於檔案 sysfs-class-infiniband

每埠擁塞控制。

cc_table_bin	(RO) PSM2 擁塞控制使用的 CCA 表大小，後跟表條目。二進位制屬性。
cc_settings_bin	(RO) 擁塞設定：埠控制、控制對映和擁塞條目的 16 個條目陣列 - 增加、計時器、事件日誌觸發閾值和最小注入速率延遲。二進位制屬性。
cc_prescan	(RW) 啟用預掃描以加快 BECN 響應。寫入“on”啟用，寫入“off”停用。

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

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

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

定義於檔案 sysfs-class-infiniband

sc2vl/	(RO) 32 個檔案（0 - 31），用於轉換 sl->vl
sl2sc/	(RO) 32 個檔案（0 - 31），用於轉換 sl->sc
vl2mtu/	(RO) 16 個檔案（0 - 15），用於確定 vl 的 MTU

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

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

定義於檔案 sysfs-class-infiniband

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

cpu_list	(RW) 使用者程序到 sdma 引擎分配的 CPU 列表。
vl	(RO) 顯示 sdma 引擎對映到的虛擬通道 (vl)。

此介面允許使用者控制裝置的親和性設定。例如，要設定 sdma 引擎中斷親和性和使用者程序的執行緒親和性，以使用在 NUMA 配置或物理 CPU 位置方面“接近”的 sdma 引擎，使用者將執行

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

確保當程序在 CPU 4、5、6 或 7 上執行並使用 vl=0 時，驅動程式選擇 sdma 引擎 3，並且 sdma 引擎 3 的中斷被引導到 CPU 3。類似地，當程序在 CPU 9、10、11 或 12 上執行並設定 vl=1 時，將選擇引擎 4，並且 sdma 引擎 4 的中斷被引導到 CPU 8。這假定在上述 N 是“sdma3”的中斷號，M 是 /proc/interrupts 檔案中“sdma4”的中斷號。

適用於 QLogic qedr NIC 驅動程式的 sysfs 介面

/sys/class/infiniband/mlx4_X/hw_rev

/sys/class/infiniband/mlx4_X/hca_type

/sys/class/infiniband/mlx4_X/board_id

定義於檔案 sysfs-class-infiniband

hw_rev	(RO) 硬體版本號
hca_type	(RO) 主機通道介面卡型別
board_id	(RO) 製造板 ID

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

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

定義於檔案 sysfs-class-infiniband

為選定的 VF/埠在 VF 上啟用 QP0。預設情況下，沒有 VF 啟用 QP0 操作。

smi_enabled	(RO)	指示指定的 VF/埠當前是否已啟用 SMI
enable_smi_admin	(RW)	由管理員用於請求為指定的 VF/埠啟用或停用 SMI 功能。0 = 停用，1 = 啟用。

請求的啟用將在 VF 下次復位時發生（例如，擁有 VF 的 VM 上的驅動程式重啟）。

適用於 Chelsio T4/T5 RDMA 驅動程式 (cxgb4) 的 sysfs 介面

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

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

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

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

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

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

定義於檔案 sysfs-class-infiniband

sysfs iov 目錄用於管理和檢查埠 P_Key 和 GUID 半虛擬化。此目錄僅為主機新增——從機沒有。

在 iov/ports 下，管理員可以檢查裝置中存在的 GID 和 P_Key 表（以及 SM 呈現的“網路檢視”中看到的）。

“pkeys”和“gids”子目錄分別包含埠 P_Key 或 GID 表中每個條目的一個檔案。例如，ports/1/pkeys/10 包含埠 1 的 P_Key 表中索引 10 處的值。

gids/<n>	(RO) 物理埠 GID，n = 0..127
admin_guids/<n>	(RW) 允許檢查或更改給定 GUID 的管理狀態，n = 0..127
pkeys/<n>	(RO) 顯示物理金鑰表的內容，n = 0..126
mcgs/	(RO) 多播組表
<m>/gid_idx/0	(RO) 顯示 GID 對映，m = 1..2
<m>/pkey_idx/<n>	(RW) 可寫，但 RoCE pkey 除外。m = 1..2, n = 0..126 在 iov/<pci 插槽號> 目錄下，管理員可以將物理表中的索引號（如 iov/ports 下所示）對映到客戶機看到的半虛擬化索引號。例如，如果管理員在客戶機 2 上將埠 1 的物理 Pkey 索引 10 對映到虛擬索引 1，則該客戶機無論何時使用其 Pkey 索引 1，實際上都將使用真實的 Pkey 索引 10。

/sys/class/infiniband/mlx5_X/hw_rev

/sys/class/infiniband/mlx5_X/hca_type

/sys/class/infiniband/mlx5_X/reg_pages

/sys/class/infiniband/mlx5_X/fw_pages

定義於檔案 sysfs-class-infiniband

[待文件化]

適用於 Cisco VIC (usNIC) Verbs 驅動程式的 sysfs 介面

/sys/class/infiniband/mthcaX/hw_rev

/sys/class/infiniband/mthcaX/hca_type

/sys/class/infiniband/mthcaX/board_id

定義於檔案 sysfs-class-infiniband

hw_rev	(RO) 硬體版本號
hca_type	(RO) 主機通道介面卡型別：MT23108、MT25208 (MT23108 相容模式)、MT25208 或 MT25204
board_id	(RO) 製造板 ID

適用於 Mellanox ConnectX HCA IB 驅動程式 (mlx4) 的 sysfs 介面

/sys/class/infiniband/ocrdmaX/hca_type

定義於檔案 sysfs-class-infiniband

hca_type: (RO) 顯示韌體版本

適用於 Intel Omni-Path 驅動程式 (HFI1) 的 sysfs 介面

/sys/class/infiniband/ocrdmaX/hw_rev

定義於檔案 sysfs-class-infiniband

hw_rev: (RO) 硬體版本號

/sys/class/infiniband/qedrX/hw_rev

/sys/class/infiniband/qedrX/hca_type

定義於檔案 sysfs-class-infiniband

hw_rev	(RO)	硬體版本號
hca_type	(RO)	顯示 HCA 型別

適用於 VMware 半虛擬化 RDMA 驅動程式的 sysfs 介面

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

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

定義於檔案 sysfs-class-infiniband

每埠擁塞控制。兩者都是二進位制屬性。

cc_table_bin	(RO) 擁塞控制表大小，後跟表條目。
cc_settings_bin	(RO) 擁塞設定：埠控制、控制對映和擁塞條目的 16 個條目陣列 - 增加、計時器、事件日誌觸發閾值和最小注入速率延遲。

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

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

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

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

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

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

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

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

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

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

定義於檔案 sysfs-class-infiniband

[待文件化]

適用於 Mellanox Connect-IB HCA 驅動程式 mlx5 的 sysfs 介面

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

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

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

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

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

定義於檔案 sysfs-class-infiniband

[待文件化]

loopback	(WO)
led_override	(WO)
hrtbt_enable	(RW)
status	(RO)
status_str	(RO) 顯示有關鏈路狀態、可能的電纜/交換機問題和硬體錯誤的資訊。可能的狀態包括：“Initted”（已初始化）、“Present”（存在）、“IB_link_up”（IB 鏈路已啟動）、“IB_configured”（IB 已配置）或“Fatal_Hardware_Error”（致命硬體錯誤）。

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

定義於檔案 sysfs-class-infiniband

(RO) 該目錄包含 16 個檔案（編號 0-15），用於指定服務級別 (SL)。列出 SL 檔案將返回由 SL 程式設計的虛擬通道 (VL)。

/sys/class/infiniband/qibX/version

/sys/class/infiniband/qibX/hw_rev

/sys/class/infiniband/qibX/hca_type

/sys/class/infiniband/qibX/board_id

/sys/class/infiniband/qibX/boardversion

/sys/class/infiniband/qibX/nctxts

/sys/class/infiniband/qibX/localbus_info

/sys/class/infiniband/qibX/tempsense

/sys/class/infiniband/qibX/serial

/sys/class/infiniband/qibX/nfreectxts

/sys/class/infiniband/qibX/chip_reset

定義於檔案 sysfs-class-infiniband

version	(RO) 顯示已安裝軟體和驅動程式的版本資訊。
hw_rev	(RO) 硬體版本號
hca_type	(RO) 主機通道介面卡型別
board_id	(RO) 製造板 ID
boardversion	(RO) 晶片架構的當前版本
nctxts	(RO) 返回可用使用者埠（上下文）的數量
localbus_info	(RO) 人類可讀的本地匯流排資訊
tempsense	(RO) 以十進位制顯示溫度感測器暫存器
serial	(RO) HCA 的序列號
nfreectxts	(RO) 可用的空閒使用者埠（上下文）數量。
chip_reset	(WO) 如果可能，透過將“reset”寫入此檔案來複位晶片。僅當沒有使用晶片資源的使用者上下文開啟時才允許。

/sys/class/infiniband/usnic_X/board_id

/sys/class/infiniband/usnic_X/config

/sys/class/infiniband/usnic_X/qp_per_vf

/sys/class/infiniband/usnic_X/max_vf

/sys/class/infiniband/usnic_X/cq_per_vf

/sys/class/infiniband/usnic_X/iface

定義於檔案 sysfs-class-infiniband

board_id	(RO) 製造板 ID
config	(RO) 報告此 PF 的配置
qp_per_vf	（只讀）每個虛擬功能的佇列對。
max_vf	（只讀）最大虛擬功能數量
cq_per_vf	（只讀）每個虛擬功能的完成佇列
iface	（只讀）顯示此 usNIC 條目關聯的網路介面（可透過 ifconfig 檢視）。

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

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

定義於檔案 sysfs-class-infiniband

[待文件化]

Emulex RoCE HCA 驅動程式的 sysfs 介面

/sys/class/infiniband/vmw_pvrdmaX/hw_rev

/sys/class/infiniband/vmw_pvrdmaX/hca_type

/sys/class/infiniband/vmw_pvrdmaX/board_id

定義於檔案 sysfs-class-infiniband

hw_rev	(RO)	硬體版本號
hca_type	(RO)	主機通道介面卡型別
board_id	(RO)	顯示 PVRDMA 製造商板 ID

Broadcom NetXtreme-E RoCE 驅動程式的 sysfs 介面

/sys/class/infiniband_mad/abi_version

定義於檔案 sysfs-class-infiniband

（只讀）如果進行任何破壞 umad 和 issm 裝置的使用者空間 ABI 相容性的更改，則該值會遞增。

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

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

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

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

定義於檔案 sysfs-class-infiniband

每個 InfiniBand 裝置的每個埠都附加了一個“umad”裝置和一個“issm”裝置。例如，一個雙埠 HCA 將有兩個 umad 裝置和兩個 issm 裝置，而一個交換機將有一個每種型別的裝置（用於交換機埠 0）。

ibdev	（只讀）顯示 InfiniBand (IB) 裝置名稱
port	（只讀）顯示埠號

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

定義於檔案 sysfs-driver-ib_srp

用於使 ib_srp 連線到新目標的介面。可以透過向此 sysfs 屬性寫入逗號分隔的登入引數列表來請求 ib_srp 連線到新目標。支援的引數有：

id_ext，一個 16 位十六進位制數，指定 16 位元組 SRP 目標埠識別符號中的八位元組識別符號擴充套件。ib_srp 在 SRP_LOGIN_REQ 請求中將目標埠識別符號傳送給目標。
ioc_guid，一個 16 位十六進位制數，指定 16 位元組目標埠識別符號中的八位元組 I/O 控制器 GUID 部分。
dgid，一個 32 位十六進位制數，指定目標 GID。
pkey，一個四位十六進位制數，指定 InfiniBand 分割槽金鑰。
service_id，一個 16 位十六進位制數，指定用於與 SRP 目標建立通訊的 InfiniBand 服務 ID。如何查詢服務 ID 的值在 SRP 目標的文件中指定。
max_sect，一個十進位制數，指定透過單個 SCSI 命令傳輸的最大 512 位元組扇區數。
max_cmd_per_lun，一個十進位制數，指定單個 LUN 的最大未完成命令數。
io_class，一個十六進位制數，指定 SRP I/O 類。必須是 0xff00 (rev 10) 或 0x0100 (rev 16a)。I/O 類定義 SRP 發起方和目標埠識別符號的格式。
initiator_ext，一個 16 位十六進位制數，指定 SRP 發起方埠識別符號的識別符號擴充套件部分。此資料由發起方在 SRP_LOGIN_REQ 請求中傳送給目標。
cmd_sg_entries，一個介於 1..255 之間的數字，指定儲存在 SRP_CMD 資訊單元本身中的最大資料緩衝區描述符數量。當 allow_ext_sg=0 時，引數 cmd_sg_entries 定義單個 SRP_CMD 的最大 S/G 列表長度，並且 S/G 列表摺疊後長度超過此限制的命令將失敗。
allow_ext_sg，是否允許 ib_srp 在 SRP_CMD 中包含部分記憶體描述符列表而不是整個列表。如果 SRP_CMD 中包含部分記憶體描述符列表，則剩餘的記憶體描述符透過額外的 RDMA 傳輸從發起方傳達給目標。將 allow_ext_sg 設定為 1 會增加發起方和目標之間透過單個 SCSI 命令可傳輸的最大資料量。由於並非所有 SRP 目標實現都支援部分記憶體描述符列表，因此此選項的預設值為 0。
sg_tablesize，一個介於 1..2048 之間的數字，指定 SCSI 層允許傳遞給 ib_srp 的最大 S/G 列表長度。指定超過 cmd_sg_entries 的值僅在啟用部分記憶體描述符列表支援 (allow_ext_sg=1) 的情況下才安全。
comp_vector，一個介於 0..n-1 之間的數字，指定第一個 RDMA 通道的 MSI-X 完成向量。某些 HCA 為每個 HCA 埠分配多個 (n) MSI-X 向量。如果這些中斷的 IRQ 親和性掩碼已配置為使每個 MSI-X 中斷由不同的 CPU 處理，則可以使用 comp_vector 引數將 SRP 完成工作負載分散到多個 CPU 上。
tl_retry_count，一個介於 2..7 之間的數字，指定 IB RC 重試計數。
queue_size，發起方允許每個 SCSI 主機排隊的最大命令數。此引數的預設值為 62。支援的最低值為 2。
max_it_iu_size，一個十進位制數，指定發起方到目標資訊單元的最大長度。

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

定義於檔案 sysfs-driver-ib_srp

HCA 名稱（<hca>）。

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

定義於檔案 sysfs-driver-ib_srp

HCA 埠號（<port_number>）。

/sys/class/infiniband_verbs/abi_version

定義於檔案 sysfs-class-infiniband

（只讀）如果進行任何破壞 uverbs 裝置的使用者空間 ABI 相容性的更改，則該值會遞增。

Mellanox IB HCA 低階驅動程式 (mthca) 的 sysfs 介面

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

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

定義於檔案 sysfs-class-infiniband

ibdev	（只讀）顯示 InfiniBand (IB) 裝置名稱
abi_version	（只讀）顯示 IB 裝置特定介面的 ABI 版本。

/sys/class/rfkill

定義於檔案 sysfs-class-rfkill

rfkill 類子系統資料夾。每個已註冊的 rfkill 驅動程式由一個 rfkillX 子資料夾表示（X 是一個大於等於 0 的整數）。

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

定義於檔案 sysfs-class-rfkill

當前硬鎖定狀態。此檔案只讀。值：一個數值。

0: 非活動
發射器（可能）處於活動狀態。

1: 活動
發射器被驅動程式無法控制的外部因素強制關閉。

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

定義於檔案 sysfs-class-rfkill

驅動程式分配給此金鑰的名稱（介面或驅動程式名稱）。值：任意字串。

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

定義於檔案 sysfs-class-rfkill

軟阻塞狀態是否在啟動時從非易失性儲存初始化。值：一個數值

0: 否

1: 是

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

定義於檔案 sysfs-class-rfkill

當前軟阻塞狀態。此檔案可讀寫。值：一個數值。

0: 非活動
發射器（可能）處於活動狀態。

1: 活動
發射器被軟體關閉。

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

定義於檔案 sysfs-class-rfkill

發射器當前狀態。此檔案原定於 2014 年移除，但由於其使用者數量眾多，將再保留一段時間。儘管它被標記為穩定，但應優先使用較新的“hard”和“soft”介面，因為透過此介面無法表達 rfkill 驅動程式的“軟硬阻塞”狀態。未來可能會再次嘗試移除它。值：一個數值。

0: RFKILL_STATE_SOFT_BLOCKED
發射器被軟體關閉

1: RFKILL_STATE_UNBLOCKED
發射器（可能）處於活動狀態

2: RFKILL_STATE_HARD_BLOCKED
發射器被驅動程式無法控制的外部因素強制關閉。

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

定義於檔案 sysfs-class-rfkill

驅動程式型別字串（“wlan”、“bluetooth”等）。值：參見 include/linux/rfkill.h。

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

定義於檔案 sysfs-driver-ib_srp

ib_srp 在與 SRP 目標通訊時是否允許在 SRP_CMD 中包含部分記憶體描述符列表。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標通訊的 RDMA 通道數。

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

定義於檔案 sysfs-driver-ib_srp

可在單個 SRP_CMD 請求中傳送給目標的最大資料緩衝區描述符數。

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

定義於檔案 sysfs-driver-ib_srp

用於第一個 RDMA 通道的完成向量。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標通訊的 InfiniBand 目標 GID。如果發生埠重定向，則與 orig_dgid 不同。

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

定義於檔案 sysfs-driver-ib_srp

16 位元組目標埠識別符號的八位元組識別符號擴充套件部分。

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

定義於檔案 sysfs-driver-ib_srp

16 位元組目標埠識別符號的八位元組 I/O 控制器 GUID 部分。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標通訊的 InfiniBand HCA 名稱。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標通訊的 HCA 埠號。

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

定義於檔案 sysfs-driver-ib_srp

在寫入 add_target sysfs 屬性的引數中指定的 InfiniBand 目標 GID。

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

定義於檔案 sysfs-driver-ib_srp

一個 16 位數字，表示用於與 SRP 目標通訊的 InfiniBand 分割槽金鑰。

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

定義於檔案 sysfs-driver-ib_srp

在必須等待更多信用之前，ib_srp 可以傳送給目標的請求數。有關更多資訊，另請參閱 SRP 規範中的 SRP 信用演算法。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標建立通訊的 InfiniBand 服務 ID。

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

定義於檔案 sysfs-driver-ib_srp

用於與 SRP 目標通訊的源埠的 InfiniBand GID。

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

定義於檔案 sysfs-driver-ib_srp

發起方因信用不足而不得不等待才能向目標傳送請求的次數。有關更多資訊，另請參閱 SRP 規範中的 SRP 信用演算法。

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

定義於檔案 sysfs-transport-srp

指示 SRP 發起方斷開與目標的連線並移除從該目標匯入的所有 LUN。

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

定義於檔案 sysfs-transport-srp

在觀察到傳輸層錯誤後，SCSI 層將等待的秒數，然後移除目標埠。零表示立即移除。將此屬性設定為“off”將停用 dev_loss 計時器。

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

定義於檔案 sysfs-transport-srp

在觀察到傳輸層錯誤後，SCSI 層將等待的秒數，然後使 I/O 失敗。零表示立即使 I/O 失敗。將此屬性設定為“off”將停用 fast_io_fail 計時器。

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

定義於檔案 sysfs-transport-srp

16 位元組本地 SRP 埠識別符號，十六進位制格式。示例：4c:49:4e:55:58:20:56:49:4f:00:00:00:00:00:00:00。

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

定義於檔案 sysfs-transport-srp

在重新連線嘗試失敗後，SCSI 層將等待的秒數，然後重試。將此屬性設定為“off”將停用基於時間的重新連線。

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

定義於檔案 sysfs-transport-srp

遠端埠的角色。“SRP Initiator”或“SRP Target”。

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

定義於檔案 sysfs-transport-srp

用於與遠端埠通訊的傳輸層狀態。“running”表示傳輸層正常執行；“blocked”表示已遇到傳輸層錯誤但 fast_io_fail_tmo 計時器尚未觸發；“fail-fast”表示 fast_io_fail_tmo 計時器已觸發且“dev_loss_tmo”計時器尚未觸發；“lost”表示“dev_loss_tmo”計時器已觸發且埠最終被移除之前。

/sys/class/tpm/tpmX/device/

定義於檔案 sysfs-class-tpm

特定 TPM 例項下的 device/ 目錄公開了該 TPM 晶片的屬性

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

定義於檔案 sysfs-class-tpm

如果 TPM 晶片接受命令，“active”屬性將列印“1”。非活動的 TPM 晶片仍然包含活動晶片的所有狀態（儲存根金鑰、NVRAM 等），並且可以對作業系統可見，但只接受受限制的命令集。有關可用命令的更多資訊，請參見 TPM 主規範第 2 部分，結構，第 17 節。

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

定義於檔案 sysfs-class-tpm

“cancel”屬性允許您取消當前掛起的 TPM 命令。向 cancel 寫入任何值都將呼叫 TPM 供應商特定的取消操作。

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

定義於檔案 sysfs-class-tpm

“caps”屬性包含 TPM 製造商和版本資訊。

示例輸出

Manufacturer: 0x53544d20
TCG version: 1.2
Firmware version: 8.16

製造商是 TPM 中 4 字節制造商資訊空間的十六進位制轉儲。TCG 版本顯示晶片支援的 TCG TPM 規範級別。韌體版本是晶片的韌體版本，並且是製造商特定的。

/sys/class/tpm/tpmX/device/durations

定義於檔案 sysfs-class-tpm

“durations”屬性顯示用於等待短、中、長 TPM 命令的 3 個供應商特定值。所有 TPM 命令在執行時間上都被歸類為短、中或長，以便驅動程式不必等待超過必要的時間即可開始輪詢結果。

示例輸出

3015000 4508000 180995000 [original]

此處短、中、長持續時間以微秒顯示。“[original]”表示這些值未修改地從晶片中查詢時顯示。在錯誤晶片以毫秒而非微秒報告它們且需要進行縮放以微秒顯示的情況下，可以修改持續時間。在這種情況下，“[adjusted]”將取代“[original]”。

/sys/class/tpm/tpmX/device/enabled

定義於檔案 sysfs-class-tpm

如果 TPM 晶片已啟用，即它應該對作業系統可見，“enabled”屬性將列印“1”。此屬性可能可見但在停用 TPM 的某些操作後產生“0”。

/sys/class/tpm/tpmX/device/owned

定義於檔案 sysfs-class-tpm

如果 TPM_TakeOwnership 序數在晶片中成功執行，“owned”屬性將產生“1”。“0”表示尚未取得所有權。

/sys/class/tpm/tpmX/device/pcrs

定義於檔案 sysfs-class-tpm

“pcrs”屬性將轉儲 TPM 中所有平臺配置暫存器的當前值。請注意，由於這些值可能不斷變化，因此輸出僅在特定時間點有效。

示例輸出

PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
...

PCR 的數量和表示 PCR 值所需的十六進位制位元組數將因 TPM 晶片版本而異。對於 TPM 1.1 和 1.2 晶片，PCR 表示 SHA-1 雜湊，長度為 20 位元組。使用“caps”屬性確定 TPM 版本。

/sys/class/tpm/tpmX/device/pubek

定義於檔案 sysfs-class-tpm

“pubek”屬性如果可能，將返回 TPM 的公共背書金鑰。如果 TPM 已建立所有權且版本為 1.2，則未經所有者授權，將無法獲取 pubek。由於 TPM 驅動程式不儲存任何秘密，因此它無法授權其自身對 pubek 的請求，使其無法訪問。公共背書金鑰在 TPM 製造時生成，並存在於晶片的整個生命週期。

示例輸出

Algorithm: 00 00 00 01
Encscheme: 00 03
Sigscheme: 00 01
Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
Modulus length: 256
Modulus:
B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B

可能的值

Algorithm:    TPM_ALG_RSA                     (1)
Encscheme:    TPM_ES_RSAESPKCSv15             (2)
              TPM_ES_RSAESOAEP_SHA1_MGF1      (3)
Sigscheme:    TPM_SS_NONE                     (1)
Parameters, a byte string of 3 u32 values:
      Key Length (bits):      00 00 08 00     (2048)
      Num primes:             00 00 00 02     (2)
      Exponent Size:          00 00 00 00     (0 means the
                                               default exp)
Modulus Length: 256 (bytes)
Modulus:      The 256 byte Endorsement Key modulus

/sys/class/tpm/tpmX/device/temp_deactivated

定義於檔案 sysfs-class-tpm

如果晶片已暫時停用（通常直到下一個電源週期），“temp_deactivated”屬性將返回“1”。熱啟動（重啟）是否會清除 TPM 晶片的 temp_deactivated 狀態取決於平臺。

/sys/class/tpm/tpmX/device/timeouts

定義於檔案 sysfs-class-tpm

“timeouts”屬性顯示 TPM 介面規範超時的 4 個供應商特定值。這些超時的使用由晶片遵循的 TPM 介面規範定義。

示例輸出

750000 750000 750000 750000 [original]

四個超時值以微秒顯示，末尾帶有“[original]”或“[adjusted]”，具體取決於這些值是否由驅動程式從毫秒縮放以微秒報告。

/sys/class/tpm/tpmX/pcr-<H>/<N>

定義於檔案 sysfs-class-tpm

以緊湊的十六進位制表示法輸出雜湊庫 H 中 PCR 號 N 的值。N 是 PCR 號的數值，H 是雜湊的加密字串表示。

示例輸出

cat /sys/class/tpm/tpm0/pcr-sha256/7
2ED93F199692DC6788EFA6A1FE74514AB9760B2A6CEEAEF6C808C13E4ABB0D42

/sys/class/tpm/tpmX/tpm_version_major

定義於檔案 sysfs-class-tpm

“tpm_version_major”屬性顯示 TPM 裝置實現的 TCG 規範主要版本。

示例輸出

/sys/class/ubi/

定義於檔案 sysfs-class-ubi

ubi/ 類子目錄屬於 UBI 子系統，提供通用的 UBI 資訊、每個 UBI 裝置的資訊和每個 UBI 卷的資訊。

/sys/class/ubi/ubiX/avail_eraseblocks

定義於檔案 sysfs-class-ubi

可用邏輯擦除塊的數量。例如，可以建立一個具有此數量邏輯擦除塊的新 UBI 卷。

/sys/class/ubi/ubiX/bad_peb_count

定義於檔案 sysfs-class-ubi

底層 MTD 裝置上的壞物理擦除塊計數。

/sys/class/ubi/ubiX/bgt_enabled

定義於檔案 sysfs-class-ubi

如果 UBI 後臺執行緒被停用，則包含 ASCII“0n”，如果啟用，則包含 ASCII“1n”。

/sys/class/ubi/ubiX/dev

定義於檔案 sysfs-class-ubi

此 UBI 裝置對應的字元裝置的主次號（以 <major>:<minor> 格式）。

/sys/class/ubi/ubiX/eraseblock_size

定義於檔案 sysfs-class-ubi

此 UBI 裝置可能提供的最大邏輯擦除塊大小。由於對齊，UBI 卷可能具有較小的邏輯擦除塊大小。

/sys/class/ubi/ubiX/max_ec

定義於檔案 sysfs-class-ubi

最大物理擦除塊擦除計數器值。

/sys/class/ubi/ubiX/max_vol_count

定義於檔案 sysfs-class-ubi

此 UBI 裝置可以擁有的最大卷數。

/sys/class/ubi/ubiX/min_io_size

定義於檔案 sysfs-class-ubi

最小輸入/輸出單元大小。所有 I/O 只能以包含數字的分數完成。

/sys/class/ubi/ubiX/mtd_num

定義於檔案 sysfs-class-ubi

底層 MTD 裝置的編號。

/sys/class/ubi/ubiX/reserved_for_bad

定義於檔案 sysfs-class-ubi

為壞塊處理保留的物理擦除塊數量。

/sys/class/ubi/ubiX/ro_mode

定義於檔案 sysfs-class-ubi

如果此裝置上設定了只讀標誌，則包含 ASCII“1n”，如果清除，則包含“0n”。當檢測到不可恢復的錯誤時，UBI 裝置會將自身標記為只讀。

/sys/class/ubi/ubiX/total_eraseblocks

定義於檔案 sysfs-class-ubi

底層 MTD 裝置上好（未標記為壞）物理擦除塊的總數。

/sys/class/ubi/ubiX/ubiX_Y/

定義於檔案 sysfs-class-ubi

/sys/class/ubi/ubiX/ubiX_0/、/sys/class/ubi/ubiX/ubiX_1/ 等目錄描述了 UBI 裝置 X 上的 UBI 卷（卷 0、1 等）。

/sys/class/ubi/ubiX/ubiX_Y/alignment

定義於檔案 sysfs-class-ubi

卷對齊 - 此卷的邏輯擦除塊大小必須對齊的值。例如，2048 意味著邏輯擦除塊大小是 2048 的倍數。換句話說，卷邏輯擦除塊大小是 UBI 裝置邏輯擦除塊大小對齊到對齊值。

/sys/class/ubi/ubiX/ubiX_Y/corrupted

定義於檔案 sysfs-class-ubi

如果 UBI 卷正常，則包含 ASCII“0n”，如果損壞（例如，由於卷更新中斷），則包含 ASCII“1n”。

/sys/class/ubi/ubiX/ubiX_Y/data_bytes

定義於檔案 sysfs-class-ubi

此捲包含的資料量。此值僅對靜態卷有意義，對於動態卷，它等同於以位元組為單位的總卷大小。

/sys/class/ubi/ubiX/ubiX_Y/dev

定義於檔案 sysfs-class-ubi

此 UBI 卷對應的字元裝置的主次號（以 <major>:<minor> 格式）。

/sys/class/ubi/ubiX/ubiX_Y/name

定義於檔案 sysfs-class-ubi

卷名稱。

/sys/class/ubi/ubiX/ubiX_Y/reserved_ebs

定義於檔案 sysfs-class-ubi

為該卷保留的物理擦除塊計數。等同於邏輯擦除塊中的卷大小。

/sys/class/ubi/ubiX/ubiX_Y/type

定義於檔案 sysfs-class-ubi

卷型別。動態捲包含 ASCII“dynamicn”，靜態捲包含“staticn”。

/sys/class/ubi/ubiX/ubiX_Y/upd_marker

定義於檔案 sysfs-class-ubi

如果未為此卷設定更新標記，則包含 ASCII“0n”，如果已設定，則包含“1n”。更新標記在卷更新開始時設定，在結束時清除。因此，更新標記的存在表示該卷在更新中斷時正在更新。後者可以使用“corrupted”sysfs 檔案檢查。

/sys/class/ubi/ubiX/ubiX_Y/usable_eb_size

定義於檔案 sysfs-class-ubi

此卷的邏輯擦除塊大小。等同於裝置邏輯擦除塊大小對齊到卷對齊值。

/sys/class/ubi/ubiX/volumes_count

定義於檔案 sysfs-class-ubi

此 UBI 裝置上的卷數。

/sys/class/ubi/version

定義於檔案 sysfs-class-ubi

此檔案包含最新支援的 UBI 媒體上格式的版本。目前是 1，沒有計劃更改。但是，如果未來 UBI 需要無法以相容方式完成的快閃記憶體上格式更改，則將新增新的格式版本。因此，這是一種可能在未來實現向後相容（但向前不相容）改進的機制。

/sys/class/ubiX/

定義於檔案 sysfs-class-ubi

/sys/class/ubi0、/sys/class/ubi1 等目錄描述 UBI 裝置（UBI 裝置 0、1 等）。它們包含通用的 UBI 裝置資訊和每個 UBI 卷的資訊（每個 UBI 裝置可以有許多 UBI 卷）

/sys/class/udc/<udc>/a_alt_hnp_support

定義於檔案 sysfs-class-udc

指示 OTG A-Host 是否支援在備用埠進行 HNP。

/sys/class/udc/<udc>/a_hnp_support

定義於檔案 sysfs-class-udc

指示 OTG A-Host 是否支援在此埠進行 HNP。

/sys/class/udc/<udc>/b_hnp_enable

定義於檔案 sysfs-class-udc

指示 OTG A-Host 是否啟用了 HNP 支援。

/sys/class/udc/<udc>/current_speed

定義於檔案 sysfs-class-udc

指示此埠當前的協商速度。

/sys/class/udc/<udc>/function

定義於檔案 sysfs-class-udc

列印當前執行的 USB Gadget 驅動程式的名稱。

/sys/class/udc/<udc>/is_a_peripheral

定義於檔案 sysfs-class-udc

指示此埠是 OTG 會話上的預設主機，但使用了 HNP 來切換角色。

/sys/class/udc/<udc>/is_otg

定義於檔案 sysfs-class-udc

指示此埠支援 OTG。

/sys/class/udc/<udc>/maximum_speed

定義於檔案 sysfs-class-udc

指示此埠支援的最大 USB 速度。

/sys/class/udc/<udc>/soft_connect

定義於檔案 sysfs-class-udc

允許使用者斷開資料上拉電阻，從而導致與 USB 主機的邏輯斷開。

/sys/class/udc/<udc>/srp

定義於檔案 sysfs-class-udc

允許使用者手動啟動會話請求協議。

/sys/class/udc/<udc>/state

定義於檔案 sysfs-class-udc

指示 USB 裝置控制器當前狀態。有效狀態為：“not-attached”、“attached”、“powered”、“reconnecting”、“unauthenticated”、“default”、“addressed”、“configured”和“suspended”；但並非所有 USB 裝置控制器都支援報告所有狀態。

/sys/devices 下的符號¶

/sys/devices/*/dev

定義於檔案 sysfs-devices

裝置對應字元裝置的主次號（以 <major>:<minor> 格式）。

/sys/devices/*/devspec

定義於檔案 sysfs-devices

如果 CONFIG_OF 啟用，則此檔案存在。讀取時，它返回裝置節點的完整名稱。

/sys/devices/*/obppath

定義於檔案 sysfs-devices

如果 CONFIG_OF 啟用，則此檔案存在。讀取時，它返回裝置節點的完整名稱。

/sys/devices/*/of_node

定義於檔案 sysfs-devices

任何與裝置樹節點關聯的裝置都將有一個 of_path 符號連結，指向 /sys/firmware/devicetree/ 中對應的裝置節點

/sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/keep_cfg

定義於檔案 sysfs-driver-misc-cp500

標誌，指示 FPGA 在復位時應保持還是重新載入配置位元流。正常的 FPGA 行為和預設設定是保持配置位元流，並且只復位已配置的邏輯。

復位時重新載入配置可以透過簡單的重新啟動更新配置位元流。否則，需要對裝置進行電源迴圈才能重新載入新的配置位元流。

此檔案可讀寫。值如下：1 = 復位時保持配置位元流，預設 0 = 復位時重新載入配置位元流

使用者: KEBA

/sys/devices/pciXXXX:XX/0000:XX:XX.X/0000:XX:XX.X/version

定義於檔案 sysfs-driver-misc-cp500

FPGA 配置位元流的版本，作為可列印字串。此檔案只讀。

使用者: KEBA

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/cap

定義於檔案 sysfs-driver-dma-ioatdma

DMA 支援的功能。目前有 DMA_PQ、DMA_PQ_VAL、DMA_XOR、DMA_XOR_VAL、DMA_INTERRUPT。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/intr_coalesce

定義於檔案 sysfs-driver-dma-ioatdma

可調的每個通道中斷延遲值。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_active

定義於檔案 sysfs-driver-dma-ioatdma

環中活動的描述符數量。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/ring_size

定義於檔案 sysfs-driver-dma-ioatdma

描述符環大小，可用的描述符總數。

/sys/devices/pciXXXX:XX/0000:XX:XX.X/dma/dma<n>chan<n>/quickdata/version

定義於檔案 sysfs-driver-dma-ioatdma

ioatdma 裝置版本。

/sys/devices/platform/firmware\:zynqmp-firmware/feature_config_id

定義於檔案 sysfs-driver-firmware-zynqmp

此 sysfs 介面允許使用者在執行時配置功能。使用者可以啟用或停用在韌體中執行的功能，並且使用者可以在執行時配置功能的引數。支援的功能是過溫和外部看門狗。此處，外部看門狗與 /dev/watchdog 完全不同，因為外部看門狗在韌體中執行，用於監控韌體而不是 APU（Linux）的健康狀況。此外，外部看門狗介面位於 zynqmp soc 之外。

支援的功能配置 ID 如下： 1. PM_FEATURE_OVERTEMP_STATUS = 1，使用者可以啟用或停用過溫功能。 2. PM_FEATURE_OVERTEMP_VALUE = 2，使用者可以配置過溫限制，單位為攝氏度。 3. PM_FEATURE_EXTWDT_STATUS = 3，使用者可以啟用或停用外部看門狗功能。 4. PM_FEATURE_EXTWDT_VALUE = 4，使用者可以配置外部看門狗功能。

用法

選擇過溫配置 ID 以啟用/停用功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

檢查是否選擇了過溫配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 預期結果為 1。

選擇過溫配置 ID 以配置 OT 限制 # echo 2 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

檢查是否選擇了過溫配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 預期結果為 2。

選擇外部看門狗配置 ID 以啟用/停用功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

檢查是否選擇了外部看門狗配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 預期結果為 3。

選擇外部看門狗配置 ID 以配置時間間隔 # echo 4 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id

檢查是否選擇了外部看門狗配置 ID # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id 預期結果為 4。

使用者: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/feature_config_value

定義於檔案 sysfs-driver-firmware-zynqmp

此 sysfs 介面允許在執行時配置功能。使用者可以啟用或停用在韌體中執行的功能。此外，使用者可以在執行時配置功能的引數。支援的功能是過溫和外部看門狗。此處，外部看門狗與 /dev/watchdog 完全不同，因為外部看門狗在韌體中執行，用於監控韌體而不是 APU（Linux）的健康狀況。此外，外部看門狗介面位於 zynqmp soc 之外。

預設情況下，韌體中的功能是停用的。使用者可以透過查詢相應的功能配置 ID 來啟用功能。

過溫的預設限制是 90 攝氏度。外部看門狗的預設定時器間隔是 570 毫秒。

支援的功能配置 ID 如下： 1. PM_FEATURE_OVERTEMP_STATUS = 1，使用者可以啟用或停用過溫功能。 2. PM_FEATURE_OVERTEMP_VALUE = 2，使用者可以配置過溫限制，單位為攝氏度。 3. PM_FEATURE_EXTWDT_STATUS = 3，使用者可以啟用或停用外部看門狗功能。 4. PM_FEATURE_EXTWDT_VALUE = 4，使用者可以配置外部看門狗功能。

用法

啟用過溫功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查過溫功能是否已啟用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 1。

停用過溫功能 # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 0 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查過溫功能是否已停用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 0。

將過溫限制配置為 50 攝氏度 # echo 2 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 50 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查過溫限制是否已配置 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 50。

啟用外部看門狗功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 1 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查外部看門狗功能是否已啟用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 1。

停用外部看門狗功能 # echo 3 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 0 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查外部看門狗功能是否已停用 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 0。

配置外部看門狗定時器間隔為 500 毫秒 # echo 4 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_id # echo 500 > /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value

檢查外部看門狗定時器間隔是否已配置 # cat /sys/devices/platform/firmware:zynqmp-firmware/feature_config_value 預期結果為 500。

使用者: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/ggs*

定義於檔案 sysfs-driver-firmware-zynqmp

讀/寫 PMU 全域性通用儲存器暫存器值，GLOBAL_GEN_STORAGE{0:3}。全域性通用儲存器暫存器可用於系統在主裝置之間傳遞資訊。

該暫存器在系統或上電覆位期間復位。FSBL 和其他 Xilinx 軟體產品使用了三個暫存器：GLOBAL_GEN_STORAGE{4:6}。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/ggs0
# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/ggs0

使用者: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/health_status

定義於檔案 sysfs-driver-firmware-zynqmp

此 sysfs 介面允許設定健康狀態。如果 PMUFW 使用 CHECK_HEALTHY_BOOT 編譯，它將在 FPD WDT 過期時檢查健康位。如果健康位由 Linux 中執行的使用者應用程式設定，PMUFW 將只進行 APU 重啟。如果在 FPD WDT 過期期間健康位未設定，PMUFW 將進行系統重啟。

用法

設定健康位

# echo 1 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status

清除健康位

# echo 0 > /sys/devices/platform/firmware\:zynqmp-firmware/health_status

使用者: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/pggs*

定義於檔案 sysfs-driver-firmware-zynqmp

讀/寫 PMU 持久全域性通用儲存器暫存器值，PERS_GLOB_GEN_STORAGE{0:3}。持久全域性通用儲存器暫存器可用於系統在主裝置之間傳遞資訊。

此暫存器僅在上電覆位時復位，並透過系統復位保持其值。FSBL 和其他 Xilinx 軟體產品使用了四個暫存器：PERS_GLOB_GEN_STORAGE{4:7}。該暫存器僅由 POR 復位。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
# echo <value> > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/pggs0
# echo 0x1234ABCD > /sys/devices/platform/firmware\:zynqmp-firmware/pggs0

使用者: Xilinx

/sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

定義於檔案 sysfs-driver-firmware-zynqmp

此 sysfs 介面允許設定下一次關機請求的關機範圍。當執行下一次關機時，PSCI-system_off 的平臺特定部分可以使用所選的關機範圍。

以下是可用的關機範圍（子型別）

subsystem: 只有 APU 及其所有未被其他處理單元使用的外設將被關閉。這可能導致 FPD 電源域被關閉，前提是沒有其他處理單元使用 FPD 外設或 DRAM。
ps_only: 完整的 PS 將被關閉，包括 RPU、PMU 等。只有 PL 域（FPGA）保持不變。
system: 整個系統/裝置被關閉。

用法

# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
# echo <scope> > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

示例

# cat /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope
# echo "subsystem" > /sys/devices/platform/firmware\:zynqmp-firmware/shutdown_scope

使用者: Xilinx

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/boot_progress

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示資料處理單元板的啟動進度狀態。有效狀態為：- 4 : 作業系統正在啟動。- 5 : 作業系統正在執行。- 6 : 低功耗待機。

該檔案只讀。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/dpu_id

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示資料處理單元板的硬體 ID。

該檔案只讀。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/perst_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/phy_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/tpm_rst

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/usbphy_rst

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許重置資料處理單元板的硬體元件。分別是 PCI、乙太網 PHY、TPM 和 USB PHY 的重置。所有屬性的預設值都是 1。寫入 0 將導致相關元件重置。

這些檔案可讀寫。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_aux_pwr_or_reload

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_dpu_thermal

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/reset_from_main_board

定義於檔案 sysfs-driver-mlxreg-io

這些檔案公開了資料處理單元（DPU）板最近一次重置的原因。可能的原因有：- 輔助電源中斷或電源重新載入。- 熱關機。- 主機板發出的重置請求。檔案中值為 1 表示這是重置原因，0 表示其他原因。同一時間只能有一個上述原因值為 1，表示最近一次的重置原因。

這些檔案是隻讀的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/*-00**/mlxreg-io.*/hwmon/hwmon*/ufm_upgrade

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示統一網路管理器升級狀態。0 - 表示升級完成，1 - 表示其他狀態。

該檔案只讀。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/agb_spi_burn_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_spi_burn_en

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許燒錄齒輪箱和 FPGA SPI 快閃記憶體。屬性設定為 1 啟用燒錄，0 停用燒錄。如果系統處於鎖定模式，則不允許寫入這些檔案。這些檔案的目的是在生產流程中允許燒錄線卡齒輪箱和 FPGA。

該檔案可讀寫。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_pn

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld1_version_min

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示線卡上 CPLD 裝置已燒錄的 CPLD 主次版本和部件號。

這些檔案是隻讀的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/cpld_upgrade_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga_upgrade_en

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許 CPLD 和 FPGA 燒錄。檔案中值為 1 表示燒錄已啟用，0 表示其他情況。如果系統處於鎖定模式，則不允許寫入這些檔案。這些檔案的目的是允許透過 JTAG 菊花鏈升級線卡 CPLD 和 FPGA。

這些檔案可讀寫。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_pn

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/fpga1_version_min

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示線卡上 FPGA 裝置已燒錄的 FPGA 主次版本和部件號。

這些檔案是隻讀的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/max_power

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/config

定義於檔案 sysfs-driver-mlxreg-io

這些檔案提供了線卡供電所需的最大功率和線卡配置 ID。

這些檔案是隻讀的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/qsfp_pwr_en

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/pwr_en

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許開啟/關閉所有 QSFP 埠和整個線卡的電源。屬性設定為 1 表示開機，0 表示關機。

這些檔案可讀寫。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_aux_pwr_or_ref

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_dc_dc_pwr_fail

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_fpga_not_done

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_from_chassis

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_line_card

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/reset_pwr_off_from_chassis

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示線路復位原因，如下所示：輔助電源中斷或電源重新整理、DC-DC 電源故障、FPGA 復位失敗、線卡復位失敗、機箱斷電。檔案中值為 1 表示這是復位原因，0 表示其他原因。同一時間只能有一個上述原因值為 1，表示最近一次的復位原因。

這些檔案是隻讀的。

/sys/devices/platform/mlxplat/i2c_mlxcpld.*/i2c-*/i2c-*/i2c-*/*-0032/mlxreg-io.*/hwmon/hwmon*/vpd_wp

定義於檔案 sysfs-driver-mlxreg-io

此檔案允許覆蓋線卡 VPD 硬體防寫模式。當屬性設定為 1 時，防寫被停用；當設定為 0 時，防寫被啟用。預設值為 0。如果系統處於鎖定模式，則不允許寫入此檔案。此檔案的目的是在生產流程中允許線卡 VPD 燒錄。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示第二個 ASIC 的健康狀態。可能的值為：0 - 健康失敗，2 - 健康正常，3 - ASIC 處於啟動狀態。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示 ASIC 健康狀態。可能的值為：0 - 健康失敗，2 - 健康正常，3 - ASIC 處於啟動狀態。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示 ASIC 功率正常狀態。檔案中值為 1 表示 ASIC 功率正常失敗，0 表示其他情況。

該檔案只讀。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許透過寫入 1 來重置每個 ASIC。

這些檔案只寫。

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案表示 BIOS 狀態

bios_active_image: 當前活動 BIOS 影像的位置：0: 頂部，1: 底部。報告的值應與在 BIOS 安全模式為 0 的情況下作業系統期望的值相對應。此位與 Intel 雙 BIOS 在同一快閃記憶體上的頂部交換功能相關。

bios_auth_fail: BIOS 升級失敗，因為提供的 BIOS 影像未正確簽名。

bios_upgrade_fail: BIOS 升級因其他原因失敗，而非身份驗證原因。例如，由於物理 SPI 快閃記憶體問題。

這些檔案是隻讀的。

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案與系統中的時鐘板狀態相關。- clk_brd1_boot_fail: 關於第一個時鐘板從 CI 啟動失敗的警告。- clk_brd2_boot_fail: 關於第二個時鐘板從 CI 啟動失敗的警告。- clk_brd_fail: 關於公共時鐘板啟動失敗的錯誤。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案啟用時鐘板的程式設計。預設值為 0（程式設計停用）。如果系統處於鎖定模式，則不允許寫入此檔案。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案用於向遠端端（例如 BMC）指示系統主機 CPU 已準備好向遠端端傳送遙測資料。為指示，應將檔案寫入 1。

該檔案只寫。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統靜態拓撲標識，例如系統的靜態 I2C 拓撲、系統內 FPGA 裝置的數量和型別等。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案指示 COME 模組硬體配置。該值透過 GPIO 引腳由硬體推送。目的是暴露同一系統 SKU 的一些細微 BOM 更改。

該檔案只讀。

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

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

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統上配備的 CPLD 裝置已燒錄的 CPLD 部件號和次要版本。

這些檔案是隻讀的。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示已燒錄到載板和交換機板上的 CPLD 版本。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示已燒錄到 LED 或齒輪箱板上的 CPLD 版本。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示已燒錄到 LED 板上的 CPLD 版本。

這些檔案是隻讀的。

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統上配備的第 5 個 CPLD 裝置已燒錄的 CPLD 部件號、版本和次要版本。

這些檔案是隻讀的。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案旨在監控外部信任根（EROT）處理器嚮應用處理器（AP）發出的 RESET 輸出狀態。透過讀取此檔案，可以確定 EROT 是否已使 AP 韌體失效或撤銷，此時它將使 AP 保持 RESET 狀態，直到載入有效的韌體。這可以保護 AP 免受執行未經授權的韌體的影響。在正常流程中，AP 復位應在 EROT 驗證韌體完整性後釋放，並且應儘快完成，以便 AP 在 CPU 開始與每個 ASIC 通訊之前啟動。

這些檔案是隻讀的。

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案旨在在 EROT 裝置故障後執行外部信任根（EROT）恢復序列。這些 EROT 裝置保護 ASIC 免受未經授權的訪問，在正常流程中，其復位應隨系統電源一起釋放——最早的通電階段，以便 EROT 可以在 CPU 開始與 ASIC 通訊之前開始啟動和認證過程。在斷言恢復訊號的同時向 EROT 發出復位將導致 EROT 應用處理器進入恢復模式，以便可以更新/恢復 EROT 韌體。對於復位/恢復，相關檔案應透過 1/0 進行切換。

這些檔案可讀寫。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許在 EROT 裝置故障後訪問外部信任根 (EROT) 進行復位和恢復序列。預設值為 0（程式設計停用）。如果系統處於鎖定模式，則不允許寫入此檔案。

這些檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示系統風扇方向：正向 - 相關位設定為 0；反向 - 相關位設定為 1。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

當此檔案寫入 1 時，會啟用允許訪問防寫快閃記憶體的請求。此類請求只能由配備 BMC（板管理控制器）的系統執行，BMC 可以授予對受保護快閃記憶體的訪問許可權。如果 BMC 允許訪問，它將透過“global_wp_response”響應。BMC 決定授予訪問的時間視窗。授予視窗到期後，BMC 將值改回 0。預設值為 0。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

當此檔案設定為 1 時，表示 BMC 已授予主機 CPU 對受保護快閃記憶體的訪問許可權。預設值為 0。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案指示透過 JTAG 鏈更新 CPLD/FPGA 裝置場可用方法

b00 - 透過 LPC 匯流排暫存器記憶體空間進行現場更新。b01 - 保留。b10 - 保留。b11 - 透過 CPU GPIOs 位操作進行現場更新。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案啟用和停用對 JTAG 域的訪問。預設情況下，對 JTAG 域的訪問是停用的。

該檔案可讀寫。

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

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

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許線卡啟用狀態控制。預期行為：當 lc{n}_enable 寫入 1 時，相關線卡從復位狀態釋放；當寫入 0 時，線卡保持復位狀態。

這些檔案可讀寫。

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

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

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案控制線卡的電源開關。預期行為：當 lc{n}_pwr 寫入 1 時，相關線卡通電；當寫入 0 時，線卡斷電。

這些檔案可讀寫。

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

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

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案清除由 ASIC 強制執行的線卡復位位，當 ASIC 由於某些異常行為而設定此位時。預期行為：當 lc{n}_rst_mask 寫入 1 時，相關線卡復位位被清除；當寫入 0 時，沒有效果。

這些檔案只寫。

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

定義於檔案 sysfs-driver-mlxreg-io

1 - 表示系統蓋已開啟，否則為 0。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

當屬性設定為 0 時，此檔案允許重置 ASIC MT52132，原因是一些異常的 ASIC 行為。預期行為：當 mac_reset 寫入 1 時，ASIC MT52132 從復位狀態釋放；當寫入 0 時，保持復位狀態。

這些檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

當此檔案寫入 1 時，它向可程式設計裝置指示作業系統正在接管控制。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

當屬性設定為 1 時，此檔案允許在 PCIe 根複合體重置期間保持 ASIC 執行。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

當屬性設定為 0 時，此檔案允許重置 PHY 88E1548，原因是一些異常的 PHY 行為。預期行為：當 phy_reset 寫入 1 時，所有 PHY 88E1548 從復位狀態釋放；當寫入 0 時，保持復位狀態。

這些檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案分配電源管理控制所有權。當電源管理控制由硬體提供時，如果系統電源預算不足，硬體將自動關閉一個或多個先前已通電的線卡。這可能是當某些電源單元失去功率正常狀態時發生的情況。當 pm_mgmt_en 寫入 1 時，軟體的電源管理控制被啟用；當寫入 0 時，硬體的電源管理控制。請注意，無論 pm_mgmt_en 屬性如何設定，如果系統電源預算不足，硬體將不允許任何新的線卡通電。同樣，如果軟體嘗試同時開啟多個線卡電源，硬體將在系統有足夠電源預算的情況下為線卡供電。預設值為 0。

該檔案可讀寫。

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案允許斷言系統電源迴圈，開關電源單元以及系統主電源域關機。預期行為：當 pwr_cycle 寫入 1 時：輔助電源域將下降，並在短時間（約 1 秒）後上升。當 psu1_on 或 psu2_on 寫入 1 時，相關單元將從電源斷開；當寫入 0 時，連線。如果兩者都寫入 1，電源的主電源域將下降。當 pwr_down 寫入 1 時，系統主電源域將下降。

這些檔案只寫。

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案控制電源單元的開關。預期行為：當 psu3_on 或 psu4_on 寫入 1 時，相關單元將斷開與電源的連線；當寫入 0 時，連線。

這些檔案只寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案啟用電源轉換器的程式設計。預設值為 0（程式設計停用）。如果系統處於鎖定模式，則不允許寫入此檔案。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示 QSFP 埠電源狀態。當任何 QSFP 埠插入時，值為 0。當沒有 QSFP 埠插入時，值為 1。可能的值為：0 - 電源正常，1 - 電源不正常。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示因交流電源故障導致的系統復位原因。檔案中值為 1 表示這是復位原因，0 表示其他原因。

該檔案只讀。

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統復位原因，如下所示：交流電源故障導致的復位、透過 CPLD 斷言復位訊號由軟體呼叫的復位、由 SOC 透過 ACPI 暫存器斷言訊號導致的復位、透過 CPLD 斷言斷電訊號由軟體呼叫的復位。

這些檔案是隻讀的。

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

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

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

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統復位原因，如下所示：輔助電源中斷或電源重新整理、ASIC 熱關機、暫停、熱插拔、看門狗、韌體復位、長按電源按鈕、短按電源按鈕、軟體復位。檔案中值為 1 表示這是復位原因，0 表示其他原因。同一時間只能有一個上述原因值為 1，表示最近一次的復位原因。

這些檔案是隻讀的。

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統復位原因，如下所示：ComEx 電源故障、ComEx 發出的復位、系統平臺復位、電壓監測裝置升級失敗導致的復位。檔案中值為 1 表示這是復位原因，0 表示其他原因。同一時間只能有一個位值為 1，表示最近一次的復位原因。

這些檔案是隻讀的。

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

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

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

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

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

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

定義於檔案 sysfs-driver-mlxreg-io

這些檔案顯示系統復位原因，如下所示：COMEX 熱關機；看門狗斷電或復位由以下元件之一引發：COMEX、交換機板或小型化夾層卡；ASIC 請求的復位；BIOS 重新載入導致的復位。檔案中值為 1 表示這是復位原因，0 表示其他原因。同一時間只能有一個上述原因值為 1，表示最近一次的復位原因。

這些檔案是隻讀的。

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

定義於檔案 sysfs-driver-mlxreg-io

如果此檔案設定為 1，表示系統因長按電源按鈕而復位。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案顯示因電源轉換器裝置故障導致的系統復位原因。檔案中值為 1 表示這是復位原因，0 表示其他原因。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

如果系統因交換板上配備的任何 DC-DC 電源轉換器裝置故障而發生復位，此檔案將顯示 1。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案允許 iio 裝置選擇。

屬性 select_iio 可以寫入 0 或 1。它選擇可以訪問的 iio 裝置中的哪一個。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案允許在熱關機事件後解鎖 ASIC。當 ASIC 強制系統熱關機時，ASIC 會被鎖定，系統啟動後將無法使用。軟體可以透過將此屬性設定為 1，然後透過將 pwr_cycle 屬性設定為 1（主電源域的電源迴圈）來執行系統電源迴圈來決定解鎖它。在將 shutdown_unlock 設定為 1 之前，建議驗證系統重啟原因是 reset_asic_thermal 或 reset_thermal_spc_or_pciesw。如果未將 shutdown_unlock 設定為 1，則從鎖定狀態釋放 ASIC 的唯一方法是透過外部電源分配單元進行完整的系統電源迴圈。預設值為 1。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

當 ASIC 過熱時，系統保護硬體機制會強制系統重啟。系統重啟後，ASIC 會處於鎖定狀態。要解鎖 ASIC，應將此檔案寫入 1。預設值為 0。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案允許選擇 SPI 晶片以進行外部信任根 (EROT) 裝置的帶外恢復。檔案可以寫入 0 或 1。它選擇可以透過 SPI 裝置訪問的哪個 EROT。

該檔案可讀寫。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案公開了可燒錄電壓調節器裝置的韌體版本。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

此檔案公開了可燒錄電壓調節器裝置的配置更新狀態。狀態值如下：0 - 正常；1 - CRC 故障；2 - I2C 故障；3 - 進行中。

該檔案只讀。

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

定義於檔案 sysfs-driver-mlxreg-io

當屬性設定為 1 時，此檔案允許覆蓋系統 VPD 硬體防寫。

該檔案可讀寫。

/sys/devices/system/cpu/cpuX/topology/book_id

定義於檔案 sysfs-devices-system-cpu

cpuX 的 book ID。通常它是硬體平臺的識別符號（而不是核心的）。實際值取決於架構和平臺。它僅在 s390 上使用。值：整數

/sys/devices/system/cpu/cpuX/topology/book_siblings

定義於檔案 sysfs-devices-system-cpu

cpuX 在同一 book_id 內的硬體執行緒的內部核心對映。它僅在 s390 上使用。值：十六進位制位掩碼。

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

定義於檔案 sysfs-devices-system-cpu

cpuX 在同一 book_id 內的硬體執行緒的可讀列表。格式類似於 0-3, 8-11, 14,17。它僅在 s390 上使用。值：十進位制列表。

/sys/devices/system/cpu/cpuX/topology/cluster_cpus

定義於檔案 sysfs-devices-system-cpu

同一叢集內 CPU 的內部核心對映。值：十六進位制位掩碼。

/sys/devices/system/cpu/cpuX/topology/cluster_cpus_list

定義於檔案 sysfs-devices-system-cpu

同一叢集內 CPU 的可讀列表。格式類似於 0-3, 8-11, 14,17。值：十進位制列表。

/sys/devices/system/cpu/cpuX/topology/cluster_id

定義於檔案 sysfs-devices-system-cpu

cpuX 的叢集 ID。通常它是硬體平臺的識別符號（而不是核心的）。實際值取決於架構和平臺。值：整數

/sys/devices/system/cpu/cpuX/topology/core_cpus

定義於檔案 sysfs-devices-system-cpu

同一核心內 CPU 的內部核心對映。（已棄用名稱：“thread_siblings”）值：十六進位制位掩碼。

/sys/devices/system/cpu/cpuX/topology/core_cpus_list

定義於檔案 sysfs-devices-system-cpu

同一核心內 CPU 的可讀列表。格式類似於 0-3, 8-11, 14,17。（已棄用名稱：“thread_siblings_list”）。值：十進位制列表。

/sys/devices/system/cpu/cpuX/topology/core_id

定義於檔案 sysfs-devices-system-cpu

cpuX 的 CPU 核心 ID。通常它是硬體平臺的識別符號（而不是核心的）。實際值取決於架構和平臺。值：整數

/sys/devices/system/cpu/cpuX/topology/die_cpus

定義於檔案 sysfs-devices-system-cpu

同一晶片內 CPU 的內部核心對映。值：十六進位制位掩碼。

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

定義於檔案 sysfs-devices-system-cpu

同一晶片內 CPU 的可讀列表。格式類似於 0-3, 8-11, 14,17。值：十進位制列表。

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

定義於檔案 sysfs-devices-system-cpu

cpuX 的 CPU 晶片 ID。通常它是硬體平臺的識別符號（而不是核心的）。實際值取決於架構和平臺。值：整數

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

定義於檔案 sysfs-devices-system-cpu

cpuX 的抽屜 ID。通常它是硬體平臺的識別符號（而不是核心的）。實際值取決於架構和平臺。它僅在 s390 上使用。值：整數

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

定義於檔案 sysfs-devices-system-cpu

cpuX 在同一 drawer_id 內的硬體執行緒的內部核心對映。它僅在 s390 上使用。值：十六進位制位掩碼。

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

定義於檔案 sysfs-devices-system-cpu

cpuX 在同一 drawer_id 內的硬體執行緒的可讀列表。格式類似於 0-3, 8-11, 14,17。它僅在 s390 上使用。值：十進位制列表。

/sys/devices/system/cpu/cpuX/topology/package_cpus

定義於檔案 sysfs-devices-system-cpu

共享同一 physical_package_id 的 CPU 的內部核心對映。（已棄用名稱：“core_siblings”）。值：十六進位制位掩碼。

/sys/devices/system/cpu/cpuX/topology/package_cpus_list

定義於檔案 sysfs-devices-system-cpu

共享同一 physical_package_id 的 CPU 的可讀列表。格式類似於 0-3, 8-11, 14,17。（已棄用名稱：“core_siblings_list”）值：十進位制列表。

/sys/devices/system/cpu/cpu[0-9]+/dscr

定義於檔案 sysfs-devices-system-cpu

CPU 上資料流控制暫存器 (DSCR) 的預設值。當核心執行時以及任何尚未自行設定 DSCR 的程序都會使用此預設值。如果一個程序曾設定 DSCR（透過直接訪問 SPR），那麼該值將為該程序保留，並在其執行的任何 CPU 上使用（覆蓋此處描述的值）。如果由程序設定，該值將被子程序繼承。值：64 位無符號整數（位欄位）

/sys/devices/system/cpu/dscr_default

定義於檔案 sysfs-devices-system-cpu

寫入等同於向所有 CPU 上的 /sys/devices/system/cpu/cpuN/dscr 寫入。讀取返回最後寫入的值或 0。此值不是全域性預設值：它是一種同時設定所有每 CPU 預設值的方式。值：64 位無符號整數（位欄位）

/sys/devices/system/node/has_cpu

在檔案 sysfs-devices-node 中定義

具有一個或多個 CPU 的節點。

/sys/devices/system/node/has_high_memory

在檔案 sysfs-devices-node 中定義

具有常規記憶體或高記憶體的節點。取決於 CONFIG_HIGHMEM。

/sys/devices/system/node/has_normal_memory

在檔案 sysfs-devices-node 中定義

具有常規記憶體的節點。

/sys/devices/system/node/nodeX

在檔案 sysfs-devices-node 中定義

當 CONFIG_NUMA 啟用時，這是一個目錄，包含節點 X 的資訊，例如哪些 CPU 是該節點的本地 CPU。每個檔案將在下文詳細說明。

/sys/devices/system/node/nodeX/accessY/

在檔案 sysfs-devices-node 中定義

該節點與訪問類別“Y”的其他節點的關係。

/sys/devices/system/node/nodeX/accessY/initiators/

在檔案 sysfs-devices-node 中定義

包含指向記憶體發起節點（對該目標節點的記憶體具有“Y”類別訪問許可權）的符號連結的目錄。不在列表中的節點中的 CPU 和其他記憶體發起者訪問此節點的記憶體時，效能可能會有所不同。

/sys/devices/system/node/nodeX/accessY/initiators/read_bandwidth

在檔案 sysfs-devices-node 中定義

從該訪問類別中的連結發起節點訪問時，此節點的讀取頻寬（MB/s）。

/sys/devices/system/node/nodeX/accessY/initiators/read_latency

在檔案 sysfs-devices-node 中定義

從該訪問類別中的連結發起節點訪問時，此節點的讀取延遲（納秒）。

/sys/devices/system/node/nodeX/accessY/initiators/write_bandwidth

在檔案 sysfs-devices-node 中定義

從該訪問類別中的連結發起節點訪問時，此節點的寫入頻寬（MB/s）。

/sys/devices/system/node/nodeX/accessY/initiators/write_latency

在檔案 sysfs-devices-node 中定義

從該類別中的連結發起節點訪問時，此節點的寫入延遲（納秒）。

/sys/devices/system/node/nodeX/accessY/targets/

在檔案 sysfs-devices-node 中定義

包含指向記憶體目標（此發起節點具有“Y”類別訪問許可權）的符號連結的目錄。

/sys/devices/system/node/nodeX/compact

在檔案 sysfs-devices-node 中定義

當此檔案被寫入時，該節點內的所有記憶體將被壓縮。完成後，記憶體將被釋放為儘可能多連續頁面的塊。

/sys/devices/system/node/nodeX/cpulist

在檔案 sysfs-devices-node 中定義

與該節點關聯的 CPU。

/sys/devices/system/node/nodeX/cpumap

在檔案 sysfs-devices-node 中定義

該節點的 CPU 對映。

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

在檔案 sysfs-devices-node 中定義

該節點與系統中所有其他節點之間的距離。

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

在檔案 sysfs-devices-node 中定義

該節點的巨頁大小控制/查詢屬性。參見巨頁 (HugeTLB Pages)

/sys/devices/system/node/nodeX/meminfo

在檔案 sysfs-devices-node 中定義

提供有關節點分佈和記憶體利用率的資訊。類似於 /proc/meminfo，參見 /proc 檔案系統

/sys/devices/system/node/nodeX/memory_failure/delayed

在檔案 sysfs-devices-node 中定義

在一個 NUMA 節點上的原始中毒頁面中，有多少頁面被記憶體錯誤恢復嘗試延遲。延遲的中毒頁面通常會由核心重試。

/sys/devices/system/node/nodeX/memory_failure/failed

在檔案 sysfs-devices-node 中定義

在一個 NUMA 節點上的原始中毒頁面中，有多少頁面被記憶體錯誤恢復嘗試失敗。這通常意味著關鍵恢復操作失敗。

/sys/devices/system/node/nodeX/memory_failure/ignored

在檔案 sysfs-devices-node 中定義

在一個 NUMA 節點上的原始中毒頁面中，有多少頁面被記憶體錯誤恢復嘗試忽略，通常是因為不支援此類頁面，核心放棄了恢復。

/sys/devices/system/node/nodeX/memory_failure/recovered

在檔案 sysfs-devices-node 中定義

在一個 NUMA 節點上的原始中毒頁面中，有多少頁面被記憶體錯誤恢復嘗試恢復。

/sys/devices/system/node/nodeX/memory_failure/total

在檔案 sysfs-devices-node 中定義

NUMA 節點上原始中毒頁面（因記憶體錯誤導致資料損壞的頁面）的總數。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/

在檔案 sysfs-devices-node 中定義

包含記憶體側快取級別“Y”的屬性的目錄。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/address_mode

在檔案 sysfs-devices-node 中定義

地址模式：0 表示保留，1 表示擴充套件線性。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/indexing

在檔案 sysfs-devices-node 中定義

快取的關聯性索引：0 表示直接對映，非零表示已索引。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/line_size

在檔案 sysfs-devices-node 中定義

快取未命中時從下一快取級別訪問的位元組數。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/size

在檔案 sysfs-devices-node 中定義

此記憶體側快取的大小（位元組）。

/sys/devices/system/node/nodeX/memory_side_cache/indexY/write_policy

在檔案 sysfs-devices-node 中定義

快取寫入策略：0 表示寫回，1 表示直寫，其他或未知。

/sys/devices/system/node/nodeX/numastat

在檔案 sysfs-devices-node 中定義

節點的命中/未命中統計資訊，單位為頁面。參見 Numa 策略命中/未命中統計

/sys/devices/system/node/nodeX/vmstat

在檔案 sysfs-devices-node 中定義

節點的區域化虛擬記憶體統計資訊。這是 numastat 的超集。

/sys/devices/system/node/nodeX/x86/sgx_total_bytes

在檔案 sysfs-devices-node 中定義

SGX 物理記憶體的總大小（位元組）。

/sys/devices/system/node/online

在檔案 sysfs-devices-node 中定義

線上節點。

/sys/devices/system/node/possible

在檔案 sysfs-devices-node 中定義

可能在某個時間點上線（online）的節點。

/sys/devices/system/xen_memory/xen_memory0/info/current_kb

在檔案 sysfs-devices-system-xen_memory 中定義

此域記憶體預留的當前大小（KiB）。

/sys/devices/system/xen_memory/xen_memory0/info/high_kb

在檔案 sysfs-devices-system-xen_memory 中定義

氣球（balloon）中的高記憶體量（KiB）。

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

在檔案 sysfs-devices-system-xen_memory 中定義

氣球（balloon）中的低（或常規）記憶體量（KiB）。

/sys/devices/system/xen_memory/xen_memory0/max_retry_count

在檔案 sysfs-devices-system-xen_memory 中定義

氣球驅動程式在放棄之前嘗試增加氣球的最大次數。另請參見下面的“retry_count”。值為零表示永遠重試，這是預設值。

/sys/devices/system/xen_memory/xen_memory0/max_schedule_delay

在檔案 sysfs-devices-system-xen_memory 中定義

“schedule_delay”（見下文）將增加到的限制。預設值為 32 秒。

/sys/devices/system/xen_memory/xen_memory0/retry_count

在檔案 sysfs-devices-system-xen_memory 中定義

氣球驅動程式嘗試增加氣球大小的當前次數。預設值為 1。如果 max_retry_count 為零（無限制），這意味著驅動程式將嘗試以“schedule_delay”延遲重試。

/sys/devices/system/xen_memory/xen_memory0/schedule_delay

在檔案 sysfs-devices-system-xen_memory 中定義

兩次嘗試增加氣球之間等待的時間（秒）。每次無法增加氣球時，“schedule_delay”都會增加（直到達到“max_schedule_delay”，此時將使用最大值）。

/sys/devices/system/xen_memory/xen_memory0/scrub_pages

在檔案 sysfs-devices-system-xen_memory 中定義

控制在將頁面返回給 Xen 供其他域使用之前對其進行擦洗。可以透過 xen_scrub_pages 命令列引數設定。預設值由 CONFIG_XEN_SCRUB_PAGES_DEFAULT 控制。

/sys/devices/system/xen_memory/xen_memory0/target

在檔案 sysfs-devices-system-xen_memory 中定義

調整此域記憶體預留的目標頁面數。

/sys/devices/system/xen_memory/xen_memory0/target_kb

在檔案 sysfs-devices-system-xen_memory 中定義

與上面的 target 相同，但值以 KiB 為單位。

/sys/firmware 下的符號¶

/sys/firmware/acpi/pm_profile

在檔案 sysfs-acpi-pmprofile 中定義

ACPI pm_profile sysfs 介面公開了平臺在 ACPI FADT Preferred_PM_Profile 欄位中提供的首選電源管理（和效能）配置檔案。

整數值直接從 FADT 中檢索並傳遞。

值：有關可能的值，請參閱 ACPI 規範第 5.2.9 節“固定 ACPI 描述表 (FADT)”中表 5.9“FADT 格式”中的 Preferred_PM_Profile 欄位定義。

ACPI 規範第 5.2.9 節“固定 ACPI 描述表 (FADT)”中表 5.9“FADT 格式”中的 Preferred_PM_Profile 欄位定義。

截至 ACPI 6.5，定義了以下值

0	未指定
1	桌面
2	移動
3	工作站
4	企業伺服器
5	SOHO 伺服器
6	一體機電腦
7	高效能伺服器
8	平板電腦
>8	保留

/sys/firmware/opal/dump

在檔案 sysfs-firmware-opal-dump 中定義

此目錄公開了透過 OPAL 韌體介面與 FSP 和平臺轉儲互動的介面。

這僅適用於 powerpc/powernv 平臺。

initiate_dump	當寫入“1”時，我們將啟動一次轉儲。讀取此檔案以獲取支援的命令。
0xXX-0xYYYY	型別為 0xXX 且 ID 為 0xYYYY（十六進位制）的轉儲目錄。不應依賴此目錄的名稱採用此格式，只需確保它在所有轉儲中是唯一的。要確定轉儲的型別和 ID，請使用 id 和 type 檔案。不要依賴任何特定大小的轉儲型別或轉儲 ID。

每個轉儲都有以下檔案

id	轉儲 ID 的十六進位制 ASCII 表示形式（例如“0x01”）
type	轉儲型別的 ASCII 表示形式，格式為“0x%x %s”，其中 ID 為十六進位制，後跟轉儲型別的描述（或“unknown”）。當無法從韌體獲取型別時，使用型別“0xffffffff unknown”。例如：“0x02 System/Platform Dump”
dump	包含轉儲的二進位制檔案。轉儲的大小即為此檔案的大小。
acknowledge	當寫入“ack”時，我們將確認已向服務處理器檢索到轉儲。然後它將刪除轉儲，使其無法訪問。讀取此檔案將獲得支援的操作列表。

/sys/firmware/opal/elog

在檔案 sysfs-firmware-opal-elog 中定義

此目錄公開了透過 OPAL 韌體介面檢索到的錯誤日誌條目。

每個錯誤日誌都由唯一的 ID 標識，並將一直存在，直到明確向韌體確認。

每個日誌條目在 /sys/firmware/opal/elog 中都有一個目錄。

如果日誌條目空間不足，服務處理器可能會在韌體檢索之前或 Linux 檢索/確認之前清除日誌條目。

如果 Linux 已檢索日誌條目但未明確向韌體確認，並且服務處理器需要更多日誌條目空間，則日誌訊息的唯一剩餘副本可能存在於 Linux 中。

通常，使用者空間守護程式會監視新條目，將其讀出並確認。

服務處理器可能能夠儲存比韌體更多的日誌條目，因此在您從 Linux 確認事件後，您可能會立即從佇列中獲得另一個在過去某個時間生成的事件。

原始日誌格式是二進位制格式。我們目前在核心中完全不解析它，留給使用者空間解決此問題。將來，我們可能會在核心中進行更多解析，並新增更多檔案，以便簡單的使用者空間程序更容易提取更多資訊。

對於每個日誌條目（目錄），有以下檔案

id	錯誤日誌 ID 的十六進位制 ASCII 表示形式 - 例如“0x01”。
type	錯誤日誌型別 ID 和型別描述的 ASCII 表示形式。目前僅為“0x00 PEL” - 平臺錯誤日誌。將來可能會有其他型別。
raw	一個只讀二進位制檔案，可讀取以獲取原始日誌條目。這些檔案小於 16KB，通常只有數百位元組，平均約為 2KB。
acknowledge	向此檔案寫入“ack”將向韌體確認錯誤日誌（如果適用，也會向服務處理器確認）。確認後不久，日誌條目將從 sysfs 中刪除。讀取此檔案將列出支援的操作（目前僅限確認）。

/sys/fs 下的符號¶

/sys/fs/o2cb/

在檔案 o2cb 中定義

Ocfs2-tools 檢視“interface-revision”以獲取版本資訊。每個 logmask/ 檔案控制一組除錯列印，並可以寫入字串“allow”、“deny”或“off”。讀取檔案返回當前狀態。

使用者: ocfs2-tools。建議的更改足以傳送到 ocfs2-devel@lists.linux.dev。

/sys/fs/orangefs/acache/*

在檔案 sysfs-fs-orangefs 中定義

屬性快取可配置設定。

/sys/fs/orangefs/capcache/*

在檔案 sysfs-fs-orangefs 中定義

能力快取可配置設定。

/sys/fs/orangefs/ccache/*

在檔案 sysfs-fs-orangefs 中定義

憑證快取可配置設定。

/sys/fs/orangefs/ncache/*

在檔案 sysfs-fs-orangefs 中定義

名稱快取可配置設定。

/sys/fs/orangefs/op_timeout_secs

在檔案 sysfs-fs-orangefs 中定義

服務操作超時時間（秒）。

/sys/fs/orangefs/perf_counter_reset

在檔案 sysfs-fs-orangefs 中定義

向 perf_counter_reset 寫入 0 或 1，以重置 /sys/fs/orangefs/perf_counters 中除設定了 PINT_PERF_PRESERVE 的計數器之外的所有計數器。

/sys/fs/orangefs/perf_counters/*

在檔案 sysfs-fs-orangefs 中定義

各種快取的計數器和設定。只讀。

/sys/fs/orangefs/perf_history_size

在檔案 sysfs-fs-orangefs 中定義

perf_counters 快取統計資訊有 N 個樣本，或 perf_history_size 個樣本。預設值為 1。

每隔 perf_time_interval_secs 就會重置（第一個）樣本。

如果 N 大於 1，則重置“當前”樣本集，並且其他 N-1 個間隔的樣本仍然可用。

/sys/fs/orangefs/perf_time_interval_secs

在檔案 sysfs-fs-orangefs 中定義

效能計數器間隔的長度（秒）。

/sys/fs/orangefs/slot_timeout_secs

在檔案 sysfs-fs-orangefs 中定義

“插槽”超時時間（秒）。“插槽”是共享記憶體段中用於核心模組和使用者空間之間通訊的索引緩衝區。插槽被請求和等待，等待時間在 slot_timeout_secs 後超時。

/sys/hypervisor 下的符號¶

/sys/hypervisor/compilation/compile_date

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：包含 Xen 虛擬機器管理程式的構建時間戳。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“<denied>”。

/sys/hypervisor/compilation/compiled_by

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：包含構建 Xen 虛擬機器管理程式的人員資訊。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“<denied>”。

/sys/hypervisor/compilation/compiler

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：用於構建 Xen 虛擬機器管理程式的編譯器。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“<denied>”。

/sys/hypervisor/properties/capabilities

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：受支援的訪客系統型別列表，以空格分隔。每種型別格式為：<class>-<major>.<minor>-<arch>，其中

<class>

“xen” -- x86：半虛擬化，arm：標準 “hvm” -- 僅限 x86：全虛擬化

<major>

主要訪客介面版本

<minor>

次要訪客介面版本

<arch>

架構，例如：“x86_32”：32 位 x86 訪客，無 PAE “x86_32p”：32 位 x86 訪客，帶 PAE “x86_64”：64 位 x86 訪客 “armv7l”：32 位 arm 訪客 “aarch64”：64 位 arm 訪客

/sys/hypervisor/properties/changeset

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：虛擬機器管理程式的變更集 (Git 提交)。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“<denied>”。

/sys/hypervisor/properties/features

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：Xen 虛擬機器管理程式為訪客支援的功能，在 include/xen/interface/features.h 中定義，以十六進位制值列印。

/sys/hypervisor/properties/pagesize

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：虛擬機器管理程式的預設頁面大小，以十六進位制值列印。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“0”。

/sys/hypervisor/properties/virtual_start

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：虛擬機器管理程式的虛擬地址，以十六進位制值表示。

/sys/hypervisor/start_flags/*

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：Xen 啟動標誌中的所有位都表示為布林檔案，如果設定則返回“1”，否則返回“0”。這取代了已廢棄的 /proc/xen/capabilities，後者在 dom0 上包含“control_d”，否則為空。現在此標誌除了“privileged”標誌外，還以“initdomain”形式公開；所有其他可能的標誌都可作為“unknownXX”訪問。

/sys/hypervisor/type

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：虛擬機器管理程式型別：“xen”：Xen 虛擬機器管理程式

/sys/hypervisor/uuid

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行： Xen 虛擬機器管理程式已知的訪客 UUID。

/sys/hypervisor/version/extra

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：Xen 版本格式為 <major>.<minor><extra>。這是 <extra> 部分。在虛擬機器管理程式中存在特殊安全設定的情況下，可能會返回“<denied>”。

/sys/hypervisor/version/major

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：Xen 版本格式為 <major>.<minor><extra>。這是 <major> 部分。

/sys/hypervisor/version/minor

在檔案 sysfs-hypervisor-xen 中定義

如果在 Xen 下執行：Xen 版本格式為 <major>.<minor><extra>。這是 <minor> 部分。

/sys/kernel 下的符號¶

/sys/kernel/notes

在檔案 sysfs-kernel-notes 中定義

/sys/kernel/notes 檔案包含執行中的 vmlinux 的 .notes 段的二進位制表示。

/sys/module 下的符號¶

/sys/module/<MODULENAME>

在檔案 sysfs-module 中定義

位於核心中的模組名稱。如果模組作為動態模組載入，此模組名稱將始終顯示。如果模組直接內置於核心中，則僅當它具有版本或至少一個引數時才會顯示。

注意：內建模組的建立條件並非設計如此，將來可能會移除。

/sys/module/<MODULENAME>/parameters

在檔案 sysfs-module 中定義

此目錄包含可執行時更改的模組的各個引數的單獨檔案。有關這些引數的內容及其作用，請參閱各個模組的文件。

注意：單個引數名稱和值不被視為穩定，只有它們將放置在 sysfs 中的此位置這一事實是穩定的。有關不同引數穩定性的詳細資訊，請參閱各個驅動程式文件。

/sys/module/<MODULENAME>/refcnt

在檔案 sysfs-module 中定義

如果模組可以從核心解除安裝，此檔案將包含模組的當前引用計數。

注意：如果模組內置於核心中，或者如果 CONFIG_MODULE_UNLOAD 核心配置值未啟用，則此檔案將不存在。

/sys/module/<MODULENAME>/srcversion

在檔案 sysfs-module 中定義

如果模組源具有 MODULE_VERSION，此檔案將包含原始碼的校驗和。

/sys/module/<MODULENAME>/version

在檔案 sysfs-module 中定義

如果模組源具有 MODULE_VERSION，此檔案將包含原始碼的版本。

審計登入會話 ID¶

在檔案 procfs-audit_loginuid 中定義

讀取 /proc/$pid/sessionid 偽檔案以獲取程序 $pid 的審計登入會話 ID，形式為十進位制無符號整數（%u, u32）。它會自動設定，每個新登入都會按序列分配。

使用者: 審計和登入應用程式

審計登入 UID¶

在檔案 procfs-audit_loginuid 中定義

寫入 /proc/$pid/loginuid 偽檔案以設定，讀取以獲取程序 $pid 的審計登入 UID，形式為十進位制無符號整數（%u, u32）。如果未設定，則無需許可權即可設定。如果已設定，訪問者必須在初始使用者名稱空間中具有 CAP_AUDIT_CONTROL 才能寫入。如果 AUDIT_FEATURE_LOGINUID_IMMUTABLE 啟用，則不能再次寫入。如果 AUDIT_FEATURE_ONLY_UNSET_LOGINUID 啟用，則不能取消設定。

使用者: 審計和登入應用程式

核心系統呼叫介面¶

核心系統呼叫介面

在檔案 syscalls 中定義

此介面與 POSIX 介面大部分匹配，並基於 POSIX 和其他基於 Unix 的介面。它將只隨著時間推移而增加，而不會移除內容。

請注意，此介面對於 Linux 支援的每個架構都不同。有關每個系統呼叫要對映的系統呼叫號的詳細資訊，請參閱特定於架構的文件。

vDSO¶

vDSO

在檔案 vdso 中定義

在某些架構上，當核心載入任何使用者空間程式時，它會將一個 ELF DSO 對映到該程式的地址空間中。此 DSO 稱為 vDSO，它通常包含有用且高度最佳化的實際系統呼叫替代方案。

這些函式根據您平臺的 ABI 呼叫。在許多平臺上，它們的呼叫方式與普通 C 函式相同。在其他平臺（例如：powerpc）上，它們的呼叫約定與系統呼叫相同，這與普通 C 函式不同。請在合理的上下文（sensible context）中呼叫它們。（例如，如果您在 x86 上將 CS 設定為奇怪的值，vDSO 函式有權崩潰。）此外，如果您向 vDSO 函式傳遞一個壞指標，您可能會得到 SIGSEGV 而不是 -EFAULT。

要找到 DSO，請解析傳遞給程式入口點的輔助向量。AT_SYSINFO_EHDR 條目將指向 vDSO。

vDSO 使用符號版本控制；每當您從 vDSO 請求符號時，請指定您期望的版本。

動態連結到 glibc 的程式將自動使用 vDSO。否則，您可以使用 tools/testing/selftests/vDSO/parse_vdso.c 中的參考解析器。

除非另有說明，否則任何給定版本的符號集以及這些符號的 ABI 都被認為是穩定的。不過，它們可能因架構而異。

注意: 截至本文撰寫之時，此 ABI 文件已針對 x86_64 進行了確認。其他使用 vDSO 的架構的維護者應確認其架構是否正確。

Linux 核心

目錄

本頁

ABI 穩定符號¶

/dev/fw 下的符號¶

/sys/accessibility 下的符號¶

/sys/block 下的符號¶

/sys/bus 下的符號¶

Symbols under /sys/class¶

/sys/devices 下的符號¶

/sys/firmware 下的符號¶

/sys/fs 下的符號¶

/sys/hypervisor 下的符號¶

/sys/kernel 下的符號¶

/sys/module 下的符號¶

核心系統呼叫介面¶

vDSO¶

<class>	“xen” -- x86：半虛擬化，arm：標準 “hvm” -- 僅限 x86：全虛擬化
<major>	主要訪客介面版本
<minor>	次要訪客介面版本
<arch>	架構，例如：“x86_32”：32 位 x86 訪客，無 PAE “x86_32p”：32 位 x86 訪客，帶 PAE “x86_64”：64 位 x86 訪客 “armv7l”：32 位 arm 訪客 “aarch64”：64 位 arm 訪客

ABI 穩定符號¶

/dev/fw 下的符號¶

/sys/accessibility 下的符號¶

/sys/block 下的符號¶

/sys/bus 下的符號¶

Symbols under /sys/class¶

/sys/devices 下的符號¶

/sys/firmware 下的符號¶

/sys/fs 下的符號¶

/sys/hypervisor 下的符號¶

/sys/kernel 下的符號¶

/sys/module 下的符號¶

熱相關事件的通知機制¶

審計登入會話 ID¶

審計登入 UID¶

核心系統呼叫介面¶

vDSO¶