ABI 已移除的符號¶
/sys/bus 下的符號¶
/sys/bus/nd/devices/regionX/nfit/ecc_unit_size |
在檔案 sysfs-bus-nfit 中定義
(只讀) 對 DIMM 的寫入請求大小,不會在記憶體控制器處導致讀-修改-寫迴圈。
當 nfit 驅動程式初始化時,它會在每個 pmem 範圍內執行 ARS (地址範圍擦洗) 操作。該過程的一部分涉及確定給定地址範圍的 ARS 能力。報告的能力之一是“清除不可糾正錯誤範圍長度單位大小”(參見:ACPI 6.2 第 9.20.7.4 節 函式索引 1 - 查詢 ARS 能力)。此屬性指示 NVDIMM 可能需要執行讀-修改-寫迴圈以維護 ECC (錯誤糾正碼) 塊的邊界。
/sys/class 下的符號¶
/sys/class/cxl/<afu>/afu_err_buf |
在檔案 sysfs-class-cxl 中定義
只讀 AFU 錯誤緩衝區內容。此檔案內容與應用程式相關,並取決於所使用的 AFU。與 AFU 互動的應用程式可以使用此屬性瞭解當前的錯誤情況並採取適當的操作,例如記錄事件等。
/sys/class/cxl/<afu>/api_version |
在檔案 sysfs-class-cxl 中定義
只讀 核心/使用者 API 當前版本的十進位制值。
/sys/class/cxl/<afu>/api_version_compatible |
在檔案 sysfs-class-cxl 中定義
只讀 此核心支援的使用者空間 API 的最低版本的十進位制值。
- 使用者
https://github.com/ibm-capi/libcxl
AFU 配置記錄(例如 /sys/class/cxl/afu0.0/cr0)
AFU 可以選擇匯出一個或多個類似 PCIe 的配置記錄,稱為 AFU 配置記錄,這些記錄將在此處顯示(如果存在)。
/sys/class/cxl/<afu>/cr<config num>/class |
在檔案 sysfs-class-cxl 中定義
只讀 此 AFU 配置記錄中找到的類程式碼的十六進位制值。
/sys/class/cxl/<afu>/cr<config num>/config |
在檔案 sysfs-class-cxl 中定義
只讀 此二進位制檔案提供對 AFU 配置記錄的原始訪問。其格式預計與 PCIe 規範定義的標準或擴充套件配置空間相匹配。
- 使用者
https://github.com/ibm-capi/libcxl
主上下文(例如 /sys/class/cxl/afu0.0m)
/sys/class/cxl/<afu>/cr<config num>/device |
在檔案 sysfs-class-cxl 中定義
只讀 此 AFU 配置記錄中找到的裝置 ID 的十六進位制值。
/sys/class/cxl/<afu>/cr<config num>/vendor |
在檔案 sysfs-class-cxl 中定義
只讀 此 AFU 配置記錄中找到的供應商 ID 的十六進位制值。
/sys/class/cxl/<afu>/irqs_max |
在檔案 sysfs-class-cxl 中定義
讀/寫 使用者空間可請求的最大中斷數的十進位制值。探測時的預設值是硬體支援的最大值(例如 2037)。寫入的值將把使用者空間應用程式限制為該數量的使用者空間中斷。必須 >= irqs_min。
/sys/class/cxl/<afu>/irqs_min |
在檔案 sysfs-class-cxl 中定義
只讀 使用者空間在 CXL_START_WORK ioctl 上必須請求的最小中斷數的十進位制值。使用者空間可以省略 START_WORK IOCTL 中的 num_interrupts 欄位以自動獲取此最小值。
/sys/class/cxl/<afu>/mmio_size |
在檔案 sysfs-class-cxl 中定義
只讀 使用者空間可 mmap 的 MMIO 空間大小的十進位制值。
/sys/class/cxl/<afu>/mode |
在檔案 sysfs-class-cxl 中定義
讀/寫 AFU 當前使用的模式。將是 modes_supported 中給出的模式之一。在沒有使用者上下文附加的情況下,寫入將改變模式。
/sys/class/cxl/<afu>/modes_supported |
在檔案 sysfs-class-cxl 中定義
只讀 此 AFU 支援的模式列表。每行一個。有效條目為:“dedicated_process” 和 “afu_directed”
/sys/class/cxl/<afu>/prefault_mode |
在檔案 sysfs-class-cxl 中定義
讀/寫 在執行 START_WORK ioctl 時,將段預故障模式設定為段表中的模式。僅適用於在雜湊頁表 MMU 下執行時。可能的值
無 |
不預故障(預設) |
工作元素描述符 |
將工作元素描述符視為有效地址並預故障其指向的內容。 |
所有 |
所有呼叫 START_WORK 的程序對映的段。 |
/sys/class/cxl/<afu>/reset |
在檔案 sysfs-class-cxl 中定義
只寫 在此處寫入 1 將重置 AFU,前提是沒有上下文在 AFU 上處於活動狀態。
/sys/class/cxl/<afu>m/mmio_size |
在檔案 sysfs-class-cxl 中定義
只讀 使用者空間可 mmap 的 MMIO 空間大小的十進位制值。這也包括所有從屬上下文空間。
/sys/class/cxl/<afu>m/pp_mmio_len |
在檔案 sysfs-class-cxl 中定義
只讀 每程序 MMIO 空間長度的十進位制值。
/sys/class/cxl/<afu>m/pp_mmio_off |
在檔案 sysfs-class-cxl 中定義
只讀 (非訪客模式下) 每程序 MMIO 空間偏移量的十進位制值。
- 使用者
https://github.com/ibm-capi/libcxl
卡資訊(例如 /sys/class/cxl/card0)
/sys/class/cxl/<card>/base_image |
在檔案 sysfs-class-cxl 中定義
只讀 (非訪客模式下) 標識支援可載入 PSL 的裝置的基本映像修訂級別。對於 FPGA,此欄位標識介面卡上快閃記憶體中包含的映像,該映像在初始程式載入期間載入。
/sys/class/cxl/<card>/caia_version |
在檔案 sysfs-class-cxl 中定義
只讀 標識卡實現的 CAIA 版本。
/sys/class/cxl/<card>/image_loaded |
在檔案 sysfs-class-cxl 中定義
只讀 (非訪客模式下) 根據載入到卡上的映像,將返回“user”或“factory”。
/sys/class/cxl/<card>/load_image_on_perst |
在檔案 sysfs-class-cxl 中定義
讀/寫 (非訪客模式下) 有效條目為“none”、“user”和“factory”。“none”表示 PERST 不會導致映像載入到卡中。載入映像需要電源迴圈。“none”可能對除錯有用,因為跟蹤陣列會保留。
“user”和“factory”表示 PERST 將導致載入使用者或工廠映像。預設是在 PERST 時重新載入卡已載入的任何映像。
/sys/class/cxl/<card>/perst_reloads_same_image |
在檔案 sysfs-class-cxl 中定義
讀/寫 (非訪客模式下) 信任透過 PERST 重新載入映像時,它不會發生變化。
0 |
不信任,映像可能不同(預設) |
1 |
信任映像不會改變。 |
/sys/class/cxl/<card>/psl_revision |
在檔案 sysfs-class-cxl 中定義
只讀 標識 PSL 的修訂級別。
/sys/class/cxl/<card>/psl_timebase_synced |
在檔案 sysfs-class-cxl 中定義
只讀 如果 psl 時間基準暫存器與核心時間基準暫存器同步,則返回 1,否則返回 0。
/sys/class/cxl/<card>/reset |
在檔案 sysfs-class-cxl 中定義
只寫 寫入 1 將向卡發出 PERST,前提是卡的任何 AFU 上都沒有活動的上下文。這可能會根據 load_image_on_perst 導致卡重新載入 FPGA。寫入 -1 將強制 PERST,無論卡 AFU 上是否有任何活動上下文。
/sys/class/cxl/<card>/tunneled_ops_supported |
在檔案 sysfs-class-cxl 中定義
只讀 如果在 capi 模式下支援隧道操作,則返回 1,否則返回 0。
/sys/class/rfkill/rfkill[0-9]+/claim |
在檔案 sysfs-class-rfkill 中定義
此檔案已棄用,因為它不再提供僅控制單個 rfkill 例項的方法。此檔案原定於 2012 年移除,並於 2016 年移除。值:0:核心處理事件
/sys/devices 下的符號¶
/sys/devices/system/machinecheck/machinecheckX/tolerant |
在檔案 sysfs-mce 中定義
在可恢復的機器檢查(參見下面最後一句)出現後,此功能已未使用且過時,而這些功能自 2010 年(Nehalem)以來就已存在。
原始描述
這些條目為每個 CPU 顯示,但它們實際上在所有 CPU 之間共享。
容忍級別。當非糾正的機器檢查發生機器檢查異常時,核心可以採取不同的操作。
由於機器檢查異常隨時可能發生,核心有時殺死程序是危險的,因為它違背了正常的核心鎖定規則。容忍級別配置了核心嘗試恢復的努力程度,即使存在死鎖的風險。較高的容忍值可能會以崩潰甚至資料損壞的風險(對於容忍度 >= 3)換取潛在的更好執行時間。
0 |
始終在未糾正錯誤時恐慌,記錄已糾正錯誤 |
1 |
在未糾正錯誤時恐慌或 SIGBUS,記錄已糾正錯誤 |
2 |
SIGBUS 或記錄未糾正錯誤,記錄已糾正錯誤 |
3 |
從不恐慌或 SIGBUS,記錄所有錯誤(僅用於測試) |
預設值: 1
請注意,這僅在 CPU 允許從機器檢查異常中恢復時才有效。當前的 x86 CPU 通常不支援。
/sys/firmware 下的符號¶
/sys/firmware/efi/vars |
在檔案 sysfs-firmware-efi-vars 中定義
此目錄公開了與 EFI 變數互動的介面。有關 EFI 變數的更多資訊,請參閱 UEFI 規範中的“變數服務”(規範版本 2.3 Errata D 的 7.2 節)。
‘efivars’ sysfs 介面已於 2023 年 3 月移除,此前不遲於 2020 年 9 月已被視為棄用。其功能已由 ‘efivarfs’ 檔案系統取代。
/sys/fs 下的符號¶
/sys/fs/selinux/checkreqprot |
在檔案 sysfs-selinux-checkreqprot 中定義
移除更新:SELinux checkreqprot 功能已於 2023 年 3 月移除,原始棄用通知如下所示。
selinuxfs 的“checkreqprot”節點允許將 SELinux 配置為檢查使用者空間為 mmap/mprotect 呼叫請求的保護,而不是核心實際應用的保護。這是用於傳統使用者空間和 READ_IMPLIES_EXEC 個性化標誌的相容性機制。但是,如果設定為 1,它會削弱安全性,因為它允許在未經策略授權的情況下使對映可執行。從 Linux v4.4 開始,checkreqprot 的預設啟動值已更改為 0(即檢查實際保護),並且 Android 和 Linux 發行版在初始化期間已明確將“0”寫入 /sys/fs/selinux/checkreqprot 一段時間。對將 checkreqprot 設定為 1 的支援最快將於 2021 年 6 月移除,屆時核心將始終停止在內部使用 checkreqprot,並將始終檢查 mmap/mprotect 呼叫時實際應用的保護。checkreqprot selinuxfs 節點將保留以實現向後相容性,但在移除此機制時,將丟棄寫入“0”值的操作,並拒絕寫入“1”值的操作。
/sys/fs/selinux/disable |
在檔案 sysfs-selinux-disable 中定義
移除更新:SELinux 執行時停用功能已於 2023 年 3 月移除,原始棄用通知如下所示。
selinuxfs 的“disable”節點允許在策略載入到核心之前在執行時停用 SELinux。如果透過此機制停用,SELinux 將保持停用狀態,直到系統重新啟動。
停用 SELinux 的首選方法是透過“selinux=0”引導引數,但建立 selinuxfs 的“disable”節點是為了方便那些無法輕鬆修改核心命令列引數的原始引導載入程式系統。不幸的是,允許在執行時停用 SELinux 使得使用“__ro_after_init”功能保護核心的 LSM 鉤子變得困難。
幸運的是,對 SELinux 執行時停用的需求似乎已不復存在,預設的 Kconfig 配置停用了此 selinuxfs 節點,並且只有主要發行版之一的 Fedora 支援在執行時停用 SELinux。Fedora 正在移除 selinuxfs 的“disable”節點,一旦完成,我們將開始緩慢地從核心中移除此程式碼。
有關 /sys/fs/selinux/disable 的更多資訊,請參見 CONFIG_SECURITY_SELINUX_DISABLE Kconfig 選項。
/sys/kernel 下的符號¶
/sys/kernel/fadump_release_opalcore |
在檔案 sysfs-kernel-fadump_release_opalcore 中定義
只寫 此 sysfs 檔案在系統啟動以在基於 OPAL 的機器上收集轉儲時可用。它曾用於釋放用於收集 opalcore 的記憶體。
/sys/kernel/uids/<uid>/cpu_shares |
在檔案 sysfs-kernel-uids 中定義
/sys/kernel/uids/<uid>/cpu_shares 可調引數用於設定使用者被允許的 CPU 頻寬。這是一個比例值。這意味著如果有兩個使用者登入,並且每個使用者擁有相同數量的份額,那麼他們將獲得相等的 CPU 頻寬。另一個例子是,如果使用者 A 的份額為 1024,使用者 B 的份額為 2048,那麼使用者 B 將獲得使用者 A 兩倍的 CPU 頻寬。更多詳情請參考 CFS 排程器
/sys/o2cb 下的符號¶
/sys/o2cb 符號連結 |
在檔案 o2cb 中定義
這是一個符號連結:/sys/o2cb 指向 /sys/fs/o2cb。當新的 ocfs2-tools 版本(知道在 /sys/fs/o2cb 中查詢)足夠普及時,此符號連結將被移除。不要編寫新軟體在此處查詢,而應嘗試 /sys/fs/o2cb。
- 使用者
ocfs2-tools。將提議的更改傳送到 ocfs2-devel@lists.linux.dev 即可。
devfs¶
devfs |
在檔案 devfs 中定義
devfs 已多年未維護,存在無法修復的競爭條件,包含與 LSB 衝突的核心內部命名策略,並且可以使用 udev 替換。
檔案 fs/devfs/、include/linux/devfs_fs*.h 以及核心樹中各種 devfs 函式呼叫均已移除。
dv1394 下的符號¶
dv1394(又稱 FireWire 的“OHCI-DV I/O 支援”) |
在檔案 dv1394 中定義
/dev/dv1394/* 是字元裝置檔案,每個 FireWire 控制器以及 NTSC 和 PAL 各有一個,可以從中透過 read() 接收 DV 資料或透過 write() 傳輸 DV 資料。一些 ioctl() 允許有限的控制。此專用介面已被 libraw1394 + libiec61883 取代,後者功能等效,支援 HDV,並且可以透明地在較新的 FireWire 核心驅動程式之上工作。
- 使用者
ffmpeg/libavformat(如果配置為支援 DV1394)
ip_queue¶
ip_queue |
在檔案 ip_queue 中定義
ip_queue 已被 nfnetlink_queue 取代,後者為使用者空間提供了更高階的佇列機制。ip_queue 模組多年前就已宣佈棄用。
raw1394 下的符號¶
raw1394(又稱 FireWire 的“原始 IEEE1394 I/O 支援”) |
在檔案 raw1394 中定義
/dev/raw1394 是一個字元裝置檔案,允許對 FireWire 匯流排進行低階訪問。其主要缺點是無法實現合理的裝置安全策略,以及其抽象級別過低,要求使用者空間客戶端複製核心的 ieee1394 核心功能的很大一部分。
已由 /dev/fw* 取代,即 firewire-core 的 <linux/firewire-cdev.h> ABI。
- 使用者
libraw1394(也適用於 firewire-cdev,對庫 ABI 使用者透明)
tcp_dma_copybreak sysctl¶
tcp_dma_copybreak sysctl |
在檔案 net_dma 中定義
以前是以位元組為單位的套接字讀取大小的下限,這些讀取將解除安裝到 DMA 複製引擎。由於 CPU 在 DMA 傳輸過程中可能觸及緩衝區的記憶體一致性問題而被移除。
video1394(又稱 FireWire 的“OHCI-1394 影片支援”)¶
video1394(又稱 FireWire 的“OHCI-1394 影片支援”) |
在檔案 video1394 中定義
/dev/video1394/* 是字元裝置檔案,每個 FireWire 控制器一個,用於等時 I/O。它是作為 raw1394 等時 I/O 功能的替代品而新增的,後者在第一代中存在效能問題。任何 video1394 使用者都必須同時使用 raw1394 + libraw1394,因為 video1394 不提供用於裝置發現和配置的非同步 I/O。
已由 /dev/fw* 取代,即 firewire-core 的 <linux/firewire-cdev.h> ABI。
- 使用者
libdc1394(也適用於 firewire-cdev,對庫 ABI 使用者透明)