所有機器通用的選項
aslr.disable=<bool>
預設值:false
如果設定這個選項,系統就不會使用位址空間配置隨機載入。
aslr.entropy_bits=<uint8_t>
預設值:0x1e
對於使用 ASLR 的位址空間,這項設定會控制隨機化中的熵位元數。熵值越高,位址空間越稀疏,分頁表使用的記憶體也越多。有效值範圍為 0 到 36。
kernel.cprng-reseed-require.hw-rng=<bool>
預設值:false
啟用後,如果 HW RNG 無法重新播種,CPRNG 就會發生恐慌。
kernel.cprng-reseed-require.jitterentropy=<bool>
預設值:false
啟用後,如果 jitterentropy 無法重新播種,CPRNG 就會發生恐慌。
kernel.cprng-seed-require.hw-rng=<bool>
預設值:false
啟用後,如果 HW RNG 在初始植入時失敗,CPRNG 會發生恐慌。
kernel.cprng-disable.jitterentropy=<bool>
預設值:false
決定是否要將 jitterentropy 做為熵來源 (用於測試)
kernel.cprng-disable.hw-rng=<bool>
預設值:false
決定是否要將 HW RNG 做為熵來源 (用於測試)
kernel.cprng-seed-require.jitterentropy=<bool>
預設值:false
啟用後,如果 jitterentropy 無法進行初始植入,CPRNG 就會發生恐慌。
kernel.cprng-seed-require.cmdline=<bool>
預設值:false
啟用後,如果您未從核心指令列提供熵輸入,CPRNG 就會發生恐慌。
kernel.entropy-mixin=<hexadecimal>
提供要混入核心 CPRNG 的熵。值必須是小寫十六進位數字字串。
原始值會盡快從記憶體中清除,並從所有診斷輸出內容中遮蓋。
kernel.jitterentropy.bs=<uint32_t>
預設值:0x40
設定 jitterentropy 的「記憶體區塊大小」參數。當 jitterentropy 執行記憶體作業 (增加 CPU 計時的變化) 時,系統會以這個大小的區塊存取記憶體。
一般不建議使用這些預設值,請務必按照 go/fuchsia-per-device:jitter 說明,針對各個 CPU 進行調整。
kernel.jitterentropy.bc=<uint32_t>
預設值:0x200
設定 jitterentropy 的「記憶體區塊數量」參數。當 jitterentropy 執行記憶體作業 (增加 CPU 作業時間變化) 時,這會控制存取的區塊數量 (大小為 kernel.jitterentropy.bs)。
一般不建議使用這些預設值,請務必按照 go/fuchsia-per-device:jitter 說明,針對各個 CPU 進行調整。
kernel.jitterentropy.ml=<uint32_t>
預設值:0x20
設定 jitterentropy 的「記憶體迴圈」參數。當 jitterentropy 執行記憶體作業 (增加 CPU 作業時間變化) 時,這項設定會控制記憶體存取常式重複執行的次數。只有在 kernel.jitterentropy.raw 為 true 時,才會使用這項參數。如果這個參數的值為 0,或 kernel.jitterentropy.raw 為 false,則 jitterentropy 會以隨機方式選擇迴圈數量。
一般不建議使用這些預設值,請務必按照 go/fuchsia-per-device:jitter 說明,針對各個 CPU 進行調整。
kernel.jitterentropy.ll=<uint32_t>
預設值:0x1
設定 jitterentropy 的「LFSR 迴圈」參數。當 jitterentropy 執行 CPU 密集型 LFSR 作業 (以增加 CPU 計時的變化) 時,這會控制 LFSR 常式重複的次數。只有在 kernel.jitterentropy.raw 為 true 時,才會使用這項參數。如果這個參數的值為 0,或 kernel.jitterentropy.raw 為 false,則 jitterentropy 會以隨機方式選擇迴圈數量。
一般不建議使用這些預設值,請務必按照 go/fuchsia-per-device:jitter 說明,針對各個 CPU 進行調整。
kernel.jitterentropy.raw=<bool>
預設值:true
如果設為 true,jitterentropy 熵收集器會傳回未經處理的原始樣本。如果設為 false,原始樣本會由 jitterentropy 處理,產生更接近均勻隨機的輸出資料。請注意,即使設為 false,CPRNG 也會重新處理樣本,因此 jitterentropy 內部的處理作業有些多餘。
kernel.jitterentropy.entropy_per_1000_bytes=<uint32_t>
預設值:0x32
設定 jitterentropy 的「每 1000 個位元組的熵」參數。這是指收集器每輸出 1000 個位元組,預估會收集多少位元的熵。
使用預設參數 (bs=64、bc=512、ml=32、ll=1、raw=true) 時,每個位元組的資料在 astro 上會產生約 0.5 位元的熵。如果安全係數為 0.1,則 1000 個位元組的資料會產生 0.5 * 0.1 * 1000 = 50 位元的熵。
一般不建議使用這些預設值,請務必按照 go/fuchsia-per-device:jitter 說明,針對各個 CPU 進行調整。
kernel.lockup-detector.critical-section-threshold-ms=<uint64_t>
預設值:0xbb8
如果 CPU 停留在指定重要區段的時間超過這個門檻,系統就會發出 KERNEL OOPS。
另請參閱 k lockup status 和鎖定偵測工具。
如果設為 0,系統會停用重要區段鎖定偵測功能。
如果 kernel.lockup-detector.heartbeat-period-ms 為 0,系統會停用重要區段鎖定偵測功能。
kernel.lockup-detector.critical-section-fatal-threshold-ms=<uint64_t>
預設值:0x2710
當 CPU 停留在指定重要區段的時間超過這個門檻,系統就會產生當機記錄並重新啟動,並指出重新啟動的原因為 SOFTWARE_WATCHDOG。
另請參閱 k lockup status 和鎖定偵測工具。
如果設為 0,系統就不會產生重要區段的當機記錄,也不會重新啟動。
如果 kernel.lockup-detector.heartbeat-period-ms 為 0,系統會停用重要區段鎖定偵測功能。
kernel.lockup-detector.heartbeat-period-ms=<uint64_t>
預設值:0x3e8
次要 CPU 應多久透過核心計時器發出一次心跳訊號。這個值應夠大,以免影響系統效能,但應小於心跳訊號存在時間門檻。1000 是合理的值。
另請參閱鎖定偵測工具。
如果設為 0,則會停用心跳偵測功能。
kernel.lockup-detector.heartbeat-age-threshold-ms=<uint64_t>
預設值:0xbb8
次要 CPU 的上次活動訊號最長存在時間,超過這個時間就會被視為鎖定。這個值應大於心跳訊號週期,但要夠小,以免錯過短暫的鎖定事件。3000 是合理的值。
另請參閱鎖定偵測工具。
如果設為 0,則會停用心跳偵測功能。
kernel.lockup-detector.heartbeat-age-fatal-threshold-ms=<uint64_t>
預設值:0x2710
CPU 最後一次活動訊號的最長存在時間,超過這個時間就會被視為鎖定,觸發產生當機記錄,指出重新啟動原因為 SOFTWARE_WATCHDOG,然後重新啟動。
另請參閱鎖定偵測工具。
如果設為 0,系統就不會產生心跳訊號當機記錄,也不會重新啟動。
kernel.lockup-detector.diagnostic-query-timeout-ms=<uint64_t>
預設值:0x64
嘗試從無回應的 CPU 取得診斷資料的時間上限,超過這個時間就會放棄。
如果設為 0,則無法查詢診斷資料。
kernel.oom.behavior=[reboot | jobkill]
預設值:reboot
這個選項可用來設定核心在遇到記憶體不足 (OOM) 情況時的行為。有效值為 jobkill 和 reboot。
如果設為 jobkill,核心遇到 OOM 時,會嘗試終止已設定 ZX_PROP_JOB_KILL_ON_OOM 位元的工作,以復原記憶體。
如果設為 reboot,核心遇到 OOM 時會發出記憶體不足事件信號 (請參閱 zx_system_get_event()),等待一段時間後重新啟動系統。等待時間長度由 kernel.oom.reboot-timeout-ms 啟動選項設定,預期在這段等待期間,使用者空間會在收到 OOM 信號時觸發關機。
kernel.oom.reboot-timeout-ms=<uint32_t>
預設值:0xc350
這個選項會設定核心在發出記憶體不足 (OOM) 事件信號後,等待多久才會重新啟動系統。只有在 kernel.oom.behavior 設為 reboot 時,這個選項才有效。
kernel.oom.enable=<bool>
預設值:true
這個選項會開啟核心中的記憶體不足 (OOM) 監控功能,當 PMM 的可用記憶體少於 kernel.oom.outofmemory-mb,且無法回收任何記憶體時,系統會根據 kernel.oom.behavior 採取行動。
您可以使用 k mem oom 指令手動觸發 OOM,這會導致可用記憶體低於 kernel.oom.outofmemory-mb 門檻。分配率可透過 k mem oom <rate> 提供,其中 <rate> 的單位為 MB。這會導致系統每秒分配指定數量的記憶體,有助於觀察記憶體壓力狀態轉換。
如要進一步瞭解記憶體壓力狀態轉換,請參閱 kernel.oom.outofmemory-mb、kernel.oom.critical-mb、kernel.oom.warning-mb 和 zx_system_get_event()。
您可以使用 k mem dump 指令查詢目前的記憶體可用狀態。
kernel.oom.outofmemory-mb=<uint64_t>
預設值:0x32
這個選項會指定可用記憶體門檻,當可用記憶體低於這個門檻,且沒有可回收的記憶體可釋出時,核心就會發出記憶體不足事件信號,並採取 kernel.oom.behavior 指定的動作。
kernel.oom.critical-mb=<uint64_t>
預設值:0x96
這個選項會指定可用記憶體門檻,核心會在達到這個門檻時發出「重大」記憶體壓力事件,表示程序應釋出記憶體。
kernel.oom.warning-mb=<uint64_t>
預設值:0x12c
這個選項會指定可用記憶體門檻,核心會在達到這個門檻時發出警告記憶體壓力事件,表示程序應減緩記憶體配置速度。
kernel.oom.debounce-mb=<uint64_t>
預設值:0x1
這個選項會指定記憶體去抖動值,用於根據可用記憶體門檻 (kernel.oom.outofmemory-mb、kernel.oom.critical-mb 和 kernel.oom.warning-mb) 計算記憶體壓力狀態。記憶體可用狀態之間的轉換會去抖動,直到可用記憶體量至少比該狀態高出 kernel.oom.debounce-mb,才會離開該狀態。
舉例來說,假設 kernel.oom.critical-mb 設為 100 MB,kernel.oom.debounce-mb 設為 5 MB。如果系統目前有 90 MB 的可用記憶體 (即處於「嚴重」狀態),可用記憶體必須增加到至少 105 MB (100 MB + 5 MB),狀態才會從「嚴重」變更為「警告」。
kernel.oom.evict-at-warning=<bool>
預設值:false
如果設為 true,這個選項會在記憶體壓力狀態為「警告」時,觸發核心收回可回收記憶體。如果設為 false,則會在記憶體壓力達到「重大」狀態時觸發。
kernel.oom.evict-continuous=<bool>
預設值:false
這個選項會設定核心逐出作業在背景持續執行,嘗試讓系統不受記憶體壓力影響,而不是只在記憶體壓力狀態轉換時觸發一次性逐出作業。
kernel.oom.eviction-delay-ms=<uint64_t>
預設值:0x1388
這個選項會指定核心在記憶體壓力狀態變更而需要執行淘汰作業時,延遲淘汰作業的時間長度 (以毫秒為單位)。這項延遲可讓回應記憶體壓力的使用者空間元件先回收記憶體,避免因干擾核心淘汰而造成顛簸。
kernel.oom.evict-with-min-target=<bool>
預設值:true
這個選項會指定核心是否也應在嘗試達到目標可用記憶體目標時,清除最少量的記憶體。如果使用者空間也釋出記憶體來因應記憶體壓力,這可確保核心收回分擔負載,達到一定程度的公平性。
kernel.oom.eviction-delta-at-oom-mb=<uint64_t>
預設值:0xa
這個選項會指定核心嘗試同步清除記憶體的精細程度 (以 MB 為單位),避免進入記憶體不足狀態。請注意,這個值與 kernel.oom.evict-with-min-target 無關,兩者不會互相影響。
kernel.oom.hysteresis-seconds=<uint64_t>
預設值:0xa
這個選項會指定記憶體壓力狀態轉換之間的遲滯間隔 (以秒為單位)。請注意,遲滯現象僅適用於從可用記憶體較少的狀態轉換為可用記憶體較多的狀態;反向轉換則不會延遲。
kernel.oom.imminent-oom-delta-mb=<uint64_t>
預設值:0xa
這個選項會指定高於記憶體不足門檻的差異 (以 MB 為單位),超過這個門檻就會發出記憶體即將不足事件信號。這個信號旨在擷取接近 OOM 的診斷記憶體資訊,因為可能無法在 OOM 時擷取狀態。
舉例來說,如果 kernel.oom.outofmemory-mb 設為 50,kernel.oom.imminent-oom-delta-mb 設為 20,則可用記憶體為 70 MB (即 50 MB + 20 MB) 時,系統會發出記憶體即將用盡事件信號,而可用記憶體為 50 MB 時,系統會發出記憶體用盡信號。
將這個值設為 0,即可停用記憶體即將用盡事件。
kernel.oom.trigger-on-alloc-failure=<bool>
預設值:true
這個選項可控管是否要觸發 OOM 回應,以因應記憶體不足導致使用者可能看見的 PMM 分配失敗。
kernel.phys.verbose=<bool>
預設值:true
這項設定可控制核心提早啟動階段中,序列控制台的記錄程度;如果設為 false,則只會記錄錯誤相關資訊。
這個選項的其中一個用途是基準測試:同步、單一執行緒 UART 寫入作業在 physboot 耗費的總時間中,可能相對昂貴 (10 個字元/毫秒),因此建議從整體時間測量中排除這類工作。
kernel.phys.backtrace-max=<uint32_t>
預設值:0x40
如果核心在提早啟動階段當機,可以在序列控制台上輸出回溯追蹤。系統會輸出以框架指標為基礎的回溯追蹤,如果建構時使用影子呼叫堆疊,也會輸出以影子呼叫堆疊為基礎的平行回溯追蹤。每個回溯列印的影格數不會超過這個數量。(大多數回溯追蹤會在達到限制前,以外層框架結束)。如果將限制設為零,系統會列印無限個影格,這可能會導致影格指標回溯進入無限迴圈,並出現一些錯誤。
kernel.phys.print-stack-max=<uint32_t>
預設值:0x400
如果核心在提早啟動階段當機,可以在序列控制台上輸出堆疊內容。這是要傾印的堆疊記憶體大小上限 (以位元組為單位);實際傾印量取決於堆疊深度。每 16 個位元組的堆疊會列印在一行,最多使用 75 個字元。
kernel.ppb.borrow-on-mru=<bool>
預設值:false
這項設定可控制當非借用頁面移至 MRU 佇列時,是否要將非借用頁面替換為借用頁面 (如有任何借用頁面)。在正常情況下,這項移動作業會延遲執行,但隨著 OOM 接近,系統會逐出頁面,並將應位於 MRU 佇列中的任何頁面移至 MRU 佇列。
kernel.ppb.loan=<bool>
預設值:false
這項設定可控管是否要在連續 VMO 上啟用 ZX_VMO_OP_DECOMMIT。如果為 true,則可對連續 VMO 執行取消修訂,並傳回 ZX_OK。這些頁面會借給系統的其他部分,供潛在借用。如果為 false,取消提交會傳回 ZX_ERR_NOT_SUPPORTED。
<bool>
預設值:false
這項設定可控管借出的頁面重新提交至原始連續 VMO 時,系統會執行的動作。如果為 false,系統會從借用頁面的位置逐出頁面,並要求將內容重新載入。如果為 true,系統會將內容複製到新頁面,並將新頁面換入,取代借出的頁面。
kernel.render-dlog-to-crashlog=<bool>
預設值:false
如果設為 true,核心錯誤期間,系統會將盡可能多的近期核心偵錯記錄附加至產生的當機記錄,協助偵錯。
kernel.serial=[none | legacy | qemu | <type>,<base>,<irq>]
預設:來自 ZBI 項目
這會控制要使用的序列埠。核心偵錯序列埠是預留資源,不得在核心外部使用。
如果設為 none,核心偵錯序列埠會停用且不會保留,允許在核心外部使用預設序列埠。
如果未明確設定這個選項,系統會從 ZBI_TYPE_KERNEL_DRIVER 類型的最後一個 ZBI 項目 (具有其中一個 ZBI_KERNEL_DRIVER_*_UART 子類型,無論是原始 ZBI 中提供的子類型,還是由開機載入器 (或開機 shim) 附加的子類型) 衍生出等效值。明確的啟動選項一律會覆寫 ZBI 項目,即使是 none 也不例外。(ZBI_TYPE_CMDLINE 項目與 ZBI_TYPE_KERNEL_DRIVER 項目的順序並不重要)。
設定字串格式如下:
* MMIO UART:
- kernel.serial=UART_MODEL,MMIO_ADDR,IRQ,FLAGS
* PIO UART:
- kernel.serial=UART_MODEL,IOPORT,IRQ
* 這個架構上常見 QEMU 虛擬機器使用的預設值:
- qemu
* x86 上的傳統 COM1 設定:
- legacy
kernel.vdso.always_use_next=<bool>
預設值:false
如果設定這個選項,核心會為使用者空間提供「下一個」vDSO,而非「穩定」vDSO 做為預設 vDSO。
vdso.ticks_get_force_syscall=<bool>
預設值:false
如果設定這個選項,即使硬體週期計數器暫存器可從使用者模式存取,系統也會強制將 zx_ticks_get vDSO 呼叫設為真正的系統呼叫。
vdso.clock_get_force_syscall=<bool>
預設值:false
如果設定這個選項,系統會強制將 zx_clock_get_monotonic 和 zx_clock_get_boot vDSO 呼叫設為真正的系統呼叫,而不是只在使用者模式中轉換 tick 計數器。
kernel.userpager.overtime_wait_seconds=<uint64_t>
預設值:0x14
這個選項可設定使用者分頁錯誤在被視為逾時前,可封鎖的時間長度,並將資訊訊息輸出至偵錯記錄,然後繼續等待。如果值為 0,表示等待時間一律不視為超時。
kernel.userpager.overtime_timeout_seconds=<uint64_t>
預設值:0x12c
這個選項可設定使用者分頁錯誤在中止前,可封鎖的時間長度。如果是硬體網頁錯誤,錯誤執行緒會終止,並顯示嚴重網頁錯誤例外狀況。如果軟體網頁錯誤是由系統呼叫觸發,系統呼叫會失敗並顯示 ZX_ERR_TIMED_OUT。如果值為 0,表示網頁錯誤一律不會因逾時而取消。
kernel.userpager.overtime_printout_limit=<uint32_t>
預設值:0x4
這個選項可設定回報超時狀況時,要傳送至 debuglog 的未完成要求數量上限。如果未完成的要求數量過多,所有要求的詳細資料可能不實用,且會導致偵錯記錄超載。
kernel.heap.enable-virtual=<bool>
預設值:false
如果設為 true,就會啟用虛擬管理的核心堆積,而非直接從 physmap 管理。虛擬堆積可能會產生一些效能和記憶體用量負擔,但不會因分割而耗盡。
kernel.heap.max-size-mb=<uint64_t>
預設值:0x800
這個選項可設定堆積的大小上限。只有在核心已編譯為使用虛擬堆積時,才會生效。
kernel.heap.alloc-fill-threshold=<uint64_t>
預設值:0x0
設定後,核心堆積會將低於這個大小 (以位元組為單位) 的分配填入零。
kernel.bufferchain.reserve-pages=<uint64_t>
預設值:0x20
指定每個 CPU 要保留多少頁面,用於緩衝區鏈結分配 (管道訊息)。設定較高的值能減少系統負載時 PMM 的爭用情形,但系統閒置時會使用更多記憶體。
TODO(https://fxbug.dev/42147481): Determine an upper bound for this value to prevent consuming too much memory.
kernel.bypass-debuglog=<bool>
預設值:false
啟用後,系統會強制將輸出內容傳送至控制台,而非緩衝處理。之所以同時提供編譯切換和 cmdline 參數,是為了在 cmdline 剖析並強制傳送至控制台之前,方便在核心中列印。如果同時存在編譯切換設定和 cmdline 參數,前者會覆寫後者。請注意,編譯切換和 cmdline 參數都會產生停用 irq 驅動 uart Tx 的副作用。
kernel.debug_uart_poll=<bool>
預設值:false
如果設為 true,系統會定期輪詢 UART,並將內容轉送至控制台。
kernel.enable-debugging-syscalls=<bool>
預設值:false
停用後,某些與偵錯相關的系統呼叫會失敗,並顯示 ZX_ERR_NOT_SUPPORTED。這兩種網址格式分別如下:
zx_debug_send_command()zx_ktrace_control()zx_ktrace_init()zx_ktrace_read()zx_mtrace_control()- 使用
ZX_PROP_PROCESS_HW_TRACE_CONTEXT_ID的zx_object_get_property() zx_process_write_memory()zx_thread_write_state()(使用ZX_THREAD_STATE_DEBUG_REGS類型時)。- 使用
ZX_VMO_OP_CACHE_INVALIDATE的zx_vmo_op_range()
kernel.enable-serial-syscalls=[false | true | output-only]
預設值:false
當 false 時,zx_debug_read() 和 zx_debug_write() 都會失敗,並顯示 ZX_ERR_NOT_SUPPORTED。
output-only 時,zx_debug_read() 會失敗並顯示 ZX_ERR_NOT_SUPPORTED,但 zx_debug_write() 會正常運作。
true時,兩者都會正常運作。
kernel.entropy-test.src=[hw_rng | jitterentropy]
預設值:hw_rng
執行熵收集器品質測試時,請使用提供的熵來源。除非核心是以 ENABLE_ENTROPY_COLLECTOR_TEST=1 建構,否則系統會忽略這個選項。
kernel.entropy-test.len=<uint64_t>
預設值:0x100000
執行熵收集器品質測試時,請收集提供的位元組數。
只要將 ENTROPY_COLLECTOR_TEST_MAXLEN 定義為該值,即可提高最大值。
kernel.force-watchdog-disabled=<bool>
預設值:false
設定後,系統會盡可能在啟動序列中,嘗試停用系統啟動載入程式啟動並傳遞的任何硬體看門狗計時器,前提是系統啟動載入程式提供足夠的資訊,讓系統知道如何停用 WDT。
kernel.halt-on-panic=<bool>
預設值:false
如果設定這個選項,系統會在核心錯誤時停止運作,而不是重新啟動。如要啟用 halt-on-panic,請傳遞核心指令列引數 kernel.halt-on-panic=true。
如果核心在使用者模式暫停核心對偵錯序列埠的存取權時發生核心錯誤 (請參閱 zx_debug_suspend),系統會忽略這個選項 (即系統會重新啟動),因為恐慌殼層無法連線。
啟用 GPU 時,核心無法可靠地繪製到影格緩衝區,因此如果核心當機或發生核心錯誤,系統預設會重新啟動。
如果核心當機且系統重新啟動,核心錯誤的記錄會顯示在 /boot/log/last-panic.txt,方便您查看、下載等。
請將
last-panic.txt和vmzircon檔案附加到您提交的任何核心恐慌錯誤。
如果出現 last-panic.txt,表示這是核心錯誤發生後首次成功啟動。
這項資訊並非「固定不變」,如果重新啟動,資訊就會消失,如果再次當機,資訊就會遭到取代。
ktrace.bufsize=<uint32_t>
預設值:0x20
這個選項會指定分配給 ktrace 記錄的 MB 數。
ktrace.grpmask=<uint32_t>
預設值:0x0
這個選項會指定要發出哪些 ktrace 記錄。這個值是 zircon/ktrace.h 中 KTRACE_GRP_* 值的位元遮罩。 十六進位值可指定為 0xnnn。
<bool>
預設值:true
這個選項會啟用記憶體限制程式庫的詳細記錄功能。
kernel.memory-limit-mb=<uint64_t>
預設值:0x0
這個選項會設定系統記憶體的上限 (以 MB 為單位)。如果設為零,則表示未設定上限。
舉例來說,如果選擇夠低的值,使用者就能模擬實體記憶體比實際少的系統。
kernel.page-scanner.enable-eviction=<bool>
預設值:true
設定後,核心可以透過多種方式釋出可回收的記憶體,包括:移除檔案頁面和未鎖定的可捨棄 VMO,或執行頁面壓縮。回收作業可減少記憶體用量,並防止記憶體不足,但會降低系統行為的時間可預測性。
kernel.page-scanner.page-table-eviction-policy=[always | never | on_request]
預設值:always
設定未存取的使用者頁面表格回收政策。
如果設為 on_request,則只會在收到要求時執行淘汰作業,例如因應記憶體不足的情況。
當 never 時,系統一律不會移除頁面表格。
如果 always,系統會定期淘汰未使用的頁面資料表。這段期間可由 kernel.page-scanner.page-table-eviction-period 控制。
kernel.page-scanner.page-table-eviction-period-ms=<uint32_t>
預設值:0x2710
設定掃描頁面表格的頻率 (以毫秒為單位)。在兩次連續掃描之間未使用的任何分頁表,都可能遭到淘汰。
只有在 kernel.page-scanner.page-table-eviction-policy=always 時,這個選項才會生效。
kernel.page-scanner.min-aging-interval-ms=<uint32_t>
預設值:0x7d0
設定連續老化事件之間的最短時間 (以毫秒為單位)。這裡的值越高,活動集就越穩定,發生類似顛簸行為的機率越低,收集頁面存取資訊的時間也越短。值越小,有效集就越小,回收機會也越多。
這個值應小於或等於 kernel.page-scanner.max-aging-interval-ms。
kernel.page-scanner.max-aging-interval-ms=<uint32_t>
預設值:0x3a98
設定連續老化事件之間的時間上限 (以毫秒為單位)。這個時間是頁面存在時間資訊可能的最差粗糙度,如果系統行為快速變化,較高的值可能會導致沒有足夠的存在時間資訊來執行回收。如果值較低,頁面會累積在最舊的值區中,導致頁面遺失擬真度資訊,進而增加回收時選擇次佳頁面的機率。
這個值應大於或等於 kernel.page-scanner.min-aging-interval-ms。
kernel.page-scanner.accessed-scan-interval-ms=<uint32_t>
預設值:0xbb8
設定收集網頁存取資訊的時間間隔 (以毫秒為單位)。值越低,年齡保真度越高,頁面回收選擇的準確度也會提高,但 CPU 作業時間會增加。
將這個值設為低於 kernel.page-scanner.min-aging-interval-ms 並沒有任何好處。
kernel.page-scanner.active-ratio-multiplier=<uint32_t>
預設值:0x2
控管觸發老化前,有效頁面與無效頁面的允許比例。這個比率會以乘數表示,以簡化核心演算法 should_age = active_page_count * active_ratio_multiplier > inactive_page_count。乘數越高,老化事件發生的頻率就越高,因此有效組合中的頁面數量會減少。如果乘數為 0,系統會根據有效頁面比率停用老化。
只有在 kernel.page-scanner.min-aging-interval-ms 和 kernel.page-scanner.max-aging-interval-ms 之間的期間,活動比率才會觸發老化,因此如果間隔相等,就不會有任何影響。
kernel.page-scanner.start-at-boot=<bool>
預設值:true
這個選項會讓核心主動記憶體掃描器在啟動時預設啟用。您也可以使用核心控制台啟用及停用這項功能。如果停用掃描器,系統會移除以時間為依據和背景記憶體回收,因此可提高系統可預測性。
掃描器執行的每項動作都可以個別設定和停用。如果所有動作都已停用,啟用掃描器就不會有任何作用。
kernel.page-scanner.zero-page-scans-per-second=<uint64_t>
預設值:0x4e20
這個選項會設定零頁掃描器每秒考慮的候選頁面數量上限。
如果設為零,就不會掃描零頁。這可為基準測試或其他工作負載提供額外的系統可預測性。
必須執行網頁掃描器,這個選項才會生效。您可以使用 kernel.page-scanner.start-at-boot 選項,在啟動時啟用這項功能。
選擇這個值是為了在最壞的情況下,在低階 ARM 裝置上消耗 5% 的 CPU。個別設定可能需要視情況調高 (或調低) 這個值。
kernel.page-scanner.lru-action=[none | evict_only | compress_only | evict_and_compress]
預設值:none
設定要對 LRU 佇列中的舊頁面執行的回收動作。無論記憶體壓力如何,系統都會執行這些動作。如果指定 none 動作,系統就不會僅因頁面過舊而回收。
支援的動作如下:
- none
- evict_only
- compress_only
- evict_and_compress
kernel.compression.random-debug-compress=<bool>
預設值:false
啟用測試選項,讓 VM 立即隨機壓縮頁面,無論頁面存在多久。這項功能可協助測試壓縮路徑,不必等待頁面老化,並將系統置於低記憶體狀態。如果核心未啟用偵錯斷言,或未設定壓縮和儲存策略,啟用這個選項會發生錯誤。
kernel.compression.strategy=[none | lz4]
預設值:none
支援的壓縮策略如下:
- none
- lz4
這個選項會選取網頁需要壓縮時要使用的壓縮策略。如果 none 已設定,則 kernel.compression.storage-strategy 也必須為 none。選取 none 即可有效停用壓縮功能。
kernel.compression.storage-strategy=[none | slot]
預設值:none
支援的壓縮儲存策略如下:
- none
- slot
這個選項會選取所需的儲存策略,用於儲存已壓縮的資料。如果設定 none,則 kernel.compression.strategy 也必須設為 none。
kernel.compression.threshold=<uint32_t>
預設值:0x46
這個選項可控制壓縮頁面必須達到的壓縮門檻,才能儲存。未達這個門檻的頁面則會繼續以未壓縮的形式儲存。
這個選項是百分比,值為 100 表示頁面只需要壓縮到至少原始大小,值為 0 則表示頁面需要壓縮到零大小。
有效值應介於 1 至 100 之間 (含 1 和 100)。
kernel.compression.lz4.acceleration=<uint32_t>
預設值:0xb
這個選項可控制提供給 LZ4 壓縮實作的加速係數。請參閱目前的 LZ4 實作,瞭解如何解讀這個值。
kernel.compression.at_memory_pressure=<bool>
預設值:false
這個選項可控制是否要因應記憶體壓力執行頁面壓縮。
如要讓這個選項生效,必須啟用 kernel.page-scanner.enable-eviction,並設定 kernel.compression.strategy 和 kernel.compression.storage-strategy。
kernel.compression.reclaim_anonymous=<bool>
預設值:false
這個選項可控管是否要將匿名頁面放入可回收頁面佇列,並提供相關的年齡資訊。啟用這項功能會增加匿名頁面的年齡追蹤負擔,但必須啟用這項功能,"kernel.compression.at_memory_pressure" 等選項才會生效。
kernel.compression.reclaim_zero_forks=<bool>
預設值:false
這個選項與「kernel.compression.reclaim_anonymous」類似,但適用於匿名頁面的零分支。啟用後,「kernel.page-scanner.zero-page-scans-per-second」選項將失效。如未啟用「kernel.compression.reclaim_anonymous」,啟用此選項會發生錯誤。
kernel.pmm-checker.action=[oops | panic]
預設值:oops
這個選項會指定 PMM 檢查器偵測到損毀時要採取的動作。值必須為下列其中一項:
* oops
- 偵測到損毀時,系統會發出非致命核心 OOPS。
* panic
- 偵測到損毀時,會發生致命的核心錯誤。
kernel.pmm-checker.enable=[true | false | auto]
預設值:false
這項設定可控管是否啟用 PMM 的釋放後使用檢查工具。PMM 檢查器可能很昂貴,適用於偵錯和開發版本。值必須是下列其中一個:
* true
- 一律啟用檢查工具。
* false
- 一律不啟用檢查工具。
* auto
- 核心會根據環境和效能特性,決定是否啟用檢查器。在管理程序下執行是考量因素之一。另請參閱「k pmm checker」。
kernel.pmm-checker.fill-size=[auto | <uint64>]
預設值:auto
啟用 PMM 的釋放後使用檢查工具時,這個選項會指定每個可用頁面要填入或檢查多少位元組。有效值為 8 的倍數,介於 8 和 PAGE_SIZE 之間 (含頭尾)。預設值「auto」代表 PAGE_SIZE。
kernel.pmm.alloc-random-should-wait=<bool>
預設值:false
啟用測試選項,無論目前的記憶體層級為何,PMM 都會隨機失敗可等待的頁面分配,並顯示 ZX_ERR_SHOULD_WAIT。這項功能可讓您輕鬆測試等待路徑,不必將系統設為低記憶體狀態。如果核心在建構時未啟用偵錯斷言,啟用這個選項會發生錯誤。
kernel.stack.canary-percent-free=<uint64_t>
預設值:0x0
這項設定可控制 Canary 在核心堆疊上的偏移量。如果 Canary 損毀,表示堆疊在使用期間至少達到該深度,這可做為堆疊用量接近上限的早期警告。偏移量是以百分比定義,用來考量核心堆疊大小的變化。舉例來說,如果值為 0,Canary 會放在堆疊的最尾端,也就是說,Canary 會在堆疊溢位時同時損毀。
系統會在堆疊釋放 (即執行緒終止) 時執行 Canary 偵測,如果 Canary 損毀,則會產生核心 OOPS。
kernel.portobserver.reserve-pages=<uint64_t>
預設值:0x8
指定每個 CPU 要為通訊埠觀測器 (非同步等待) 分配保留的頁面數量。設定較高的值能減少系統負載時 PMM 的爭用情形,但系統閒置時會使用更多記憶體。
kernel.portpacket.reserve-pages=<uint64_t>
預設值:0x1
指定每個 CPU 要為通訊埠封包 (port_queue) 分配保留的頁面數量。設定較高的值能減少系統負載時 PMM 的爭用情形,但系統閒置時會使用更多記憶體。
kernel.root-job.behavior=[halt | reboot | bootloader | recovery | shutdown]
預設值:reboot
這個選項會指定核心在根工作終止,或沒有工作和程序時應採取的動作。
如果設為 halt,系統會停止運作。
reboot時,系統會重新啟動。
如果設為 bootloader,系統會重新啟動並進入系統啟動載入程式。
recovery 時,系統會重新啟動並進入復原分區。
shutdown時,系統會關機。
kernel.root-job.notice=<string>
這個選項可在根工作終止,或沒有工作和程序時,列印通知。
kernel.shell=<bool>
預設值:false
指示核心在核心控制台上啟動自己的殼層,而不是啟動使用者空間。
kernel.shell.script=<string>
指示核心執行 kernel.shell 指令的預設指令碼。如果同時指定 kernel.shell,核心殼層命令提示字元會在指令碼完成後顯示,除非指令碼關閉系統。由於核心指令列上的空白字元會分隔不同的啟動選項,因此指令碼中的 + 字元會替換為空格,以便允許含有引數的指令,而 ; 字元則可分隔指令碼中的指令。
kernel.smp.ht=<bool>
預設值:true
這個選項會指定是否要啟用超執行緒 (HT) 邏輯 CPU。
kernel.test.ram.reserve=<stdbind::optional>
指定要保留用於測試的實體 RAM 範圍。這應寫為 SIZE (整數位元組數量,應與頁面對齊),但核心在提早啟動時指派位址後,會讀回為 SIZE,ADDRESS。
kernel.port.max-observers=<uint64_t>
預設值:0xc350
指定單一通訊埠可擁有的觀察器數量上限。達到這項限制時,超過限制的程序會引發 Zircon 例外狀況。這個值應設得夠高,讓運作正常的程式不會達到上限,但也要夠低,以便在異常程式影響系統前將其終止。
kernel.select=<string>
預設值:zircon
核心套件的名稱,用於從 ZBI 中的 STORAGE_KERNEL 項目啟動。
kernel.select.userboot=<string>
預設值:userboot
在核心建立的第一個 (也是唯一一個) 使用者程序中執行的程式:kernel.select 選擇的套件中的 ELF 靜態 PIE 檔案。第一個使用者程序會先取得管道控制代碼,並透過該管道接收單一訊息,其中包含初始控制代碼,可保留初始程序本身和系統的所有特殊權限和基本功能。
kernel.scheduler.prefer-little-cpus=<bool>
預設值:false
搜尋要放置工作的 CPU 時,優先選擇小核心,而非大核心。啟用這個選項會降低效能,但可減少耗電量。
已淘汰 - 這個選項預計在日後推出的版本中移除。請勿對其產生任何重要依附關係。
kernel.scheduler.enable-new-wakeup-accounting=<bool>
預設值:false
這個選項會停用模擬先前的排程行為,讓新喚醒的執行緒不太可能搶占目前執行的執行緒。雖然與改良後的行為相比,先前的行為對新喚醒的執行緒較不公平,但模擬先前的行為可降低系統中某些類型的潛在競爭狀況造成問題的可能性。必須先修正這些競爭狀況,才能在所有產品上全面採用改良後的喚醒行為。
TODO(https://fxbug.dev/322207536):解決堆疊中較高層級的競爭問題後,請停止在解除封鎖時重設開始和結束時間。
kernel.scheduler.fair-demand-weighted-decay=<bool>
預設值:true
啟用後,系統會根據每個樣本的長度,按比例減少公平執行緒執行階段的每執行緒預估值,該值會提供排程器的變數頻寬需求。如果樣本在封鎖前因短暫執行而關閉 (例如 IPC 來回行程的一段),則預估值只會略微降低,而跨越整個時間段的樣本則會以完整速率衰減。預估值增加則不受影響。
停用時,無論長度為何,每個樣本都會以完整速率衰減預估值,因此交替執行和封鎖的執行緒可能會在幾毫秒內失去預估值。
TODO(https://fxbug.dev/448195120): Remove the option once the default has baked.
kernel.scheduler.variable-demand-placement=<bool>
預設值:false
啟用後,排程器在為喚醒或遷移執行緒選取 CPU 時,除了考量期限執行緒的宣告 (常數) 頻寬需求,也會考量公平執行緒的預估 (變數) 頻寬需求。如果候選 CPU 以最大處理速率仍無法滿足公平執行緒的預估需求,則會將該執行緒放在其他位置 (如有可行的候選 CPU)。
停用時,系統只會考量固定頻寬需求,公平放置功能會改用 kernel.scheduler.fair-placement-affinity (預設為 idle),在執行緒最後一個叢集中,優先選擇閒置 CPU,而非忙碌 CPU。
TODO(https://fxbug.dev/448195120): Enable by default once synchronous hand-offs and producer/consumer pairs on homogeneous cores keep their co-location (perfcompare regressions on x64 and VIM3 otherwise).
kernel.scheduler.variable-demand-migration=<bool>
預設值:false
啟用這項功能和 kernel.scheduler.variable-demand-placement 後,如果公平執行緒在容量飽和的 CPU 上持續耗盡時間段,系統會定期重新放置該執行緒,就像該執行緒的需求超過 CPU 最大處理速率所能供應的量一樣。如果另一個 CPU 的最大處理速率較高,可以容納該執行緒,執行緒就會遷移到該 CPU。這會將 CPU 繫結工作從異質系統的小核心移出,不需要設定相似性。
對單一電源網域的系統,或 kernel.scheduler.variable-demand-placement 停用時,不會產生任何影響。
TODO(https://fxbug.dev/448195120): Enable by default together with kernel.scheduler.variable-demand-placement.
kernel.scheduler.variable-demand-reservation=<bool>
預設值:false
啟用後,搭配 kernel.power.rppm,公平執行緒的預估 (變數) 頻寬需求會在封鎖後,保留在封鎖的 CPU 上一個公平週期,而不是立即撤回。因此,定期執行的執行緒在下一個工作開始時,會發現 CPU 的處理速率仍為其佈建,而不是在工作之間下降,並在喚醒後再次上升。當執行緒在同一個 CPU 上喚醒時,預留項目會撤回,並直接重新計算需求;留在不同 CPU 上的預留項目則會自行到期。
停用時,只要執行緒遭到封鎖,系統就會撤銷可變需求。
TODO(https://fxbug.dev/448195120): Enable by default once the reservation is retuned. 使用 kernel.scheduler.fair-demand-weighted-decay 時,預留的估計值會更大且更長,而在異質裝置上,預留量在每個閒置的中/大 CPU 上保留約 25 個單位的需求,在閒置時將處理速率要求提高約 13%。
kernel.scheduler.pi-target-eligibility=<bool>
預設值:true
啟用後,優先順序繼承會讓提升的執行緒 (目標,例如鎖定持有者) 符合執行資格:
由期限執行緒加入的期限目標至少會保留自己的剩餘時間段,並以合併期限和合併容量之前的時間為限。如果沒有這項機制,當目標消耗的容量超過較短繼承時間範圍允許的配額時,系統會發出零時間段,目標會立即耗盡,且在等待該目標的執行緒截止前,都無法使用。除了延遲保留允許的時間段外,系統還會額外授予保留的時間段 (最多為目標的舊剩餘時間段),並由 scheduler.pi.join-slice-preserved 計數器回報。
如果公平目標的開始時間在未來 (已用盡先前的啟用次數),則在獲得繼承權重時,會立即開始新的啟用,而不是在提升該目標的公平執行緒等待時,在剩餘期間內仍不符合資格。
如果目標因繼承的期限消失或基本設定檔變更而再次變得公平,就會立即啟動新的公平啟用,而不是執行過時的期限啟用。(成為期限目標後,一律會啟動新的期限,並沿用已耗用的公平時間段比例,不受這個選項限制)。
停用時,期限目標的時間段會嚴格依據延遲方程式組成,並限制為零,公平啟用則保持不變。
TODO(https://fxbug.dev/573204130): Remove the option once the default has baked.
kernel.scheduler.fair-placement-affinity=[cluster | idle | headroom | queue-time]
預設值:queue-time
當公平執行緒喚醒或遷移時,系統會根據次要政策,對能以大致相同的方式滿足其預估需求的候選 CPU 進行排序。這個選項會選取執行緒最後一個叢集 (快取親和性) 與目前可用 CPU 的權重:
cluster:優先選擇最後一個叢集,其次是閒置 CPU,最後是耗電量最低的 CPU。系統會優先選擇最後一個叢集中忙碌的 CPU,而非其他地方閒置的 CPU,這樣可以保留快取親和性,但會讓需求未知的執行緒在小型叢集中等待其他工作 (在異質裝置上測得約 20 毫秒的冷啟動迴歸)。idle(預設):優先選擇閒置的 CPU,其次是最後一個叢集,最後是耗電量最低的叢集。最後一個叢集中的任何閒置 CPU 都會優先於忙碌 CPU,包括較慢類別的閒置 CPU。在大型核心數量遠多於小型核心的裝置上,這會將喚醒執行緒分散到可用容量,代價是偶爾會在小型核心上執行執行緒;在只有一個頂級核心的裝置上,拒絕較慢的類別反而會更糟,因為這會讓工作在該核心上排隊。queue-time:依預估佇列時間 (可執行公平執行緒的預估執行階段,以 CPU 處理速率計算) 排序候選項目。在最後一個叢集中,負載最低的 CPU 會勝出,閒置的 CPU 沒有佇列時間;只有在執行緒原本要使用的 CPU 有超過 250us 的佇列時,才會選擇另一個叢集中的 CPU,且搜尋會在第一個佇列時間為 25us 或更短的 CPU 停止。這是採用共用位置前使用的排序方式;在異質裝置上測量時,將其替換為上述政策會導致大型訊息應用程式的冷啟動時間增加約 20 毫秒,而idle只能部分復原。headroom:優先選擇可用的 CPU,其次是最後一個叢集,接著是閒置的 CPU,最後是耗電量最低的 CPU。如果 CPU 處於閒置狀態,或執行緒的預計公平餘裕足以滿足執行緒的預估需求 (在需求未知時,至少為 CPU 的十分之一),則 CPU 可用。在異質裝置上測量時,這會將過多喚醒執行緒保留在叢集中的忙碌 CPU 上 (遷移至閒置 CPU 的次數減少約 20%),且無論是否知道執行緒的需求,冷啟動應用程式的時間都會比idle多約 17 毫秒。
其餘的平手決勝條件 (預計可用空間、權重、期限負載) 在 cluster、idle 和 headroom 下皆相同;queue-time 僅使用期限負載做為進一步的平手決勝條件。Deadline 執行緒不受影響。
TODO(https://fxbug.dev/448195120): Remove once a policy is chosen.
kernel.scheduler.deadline-wake-affinity=<bool>
預設值:false
啟用後,如果喚醒的期限執行緒可以進入最後一個 CPU,且該 CPU 沒有其他可執行的期限工作,則該執行緒會留在最後一個 CPU,即使其他 CPU 處於閒置狀態也一樣。期限執行緒會立即優先處理公平工作,因此將其從僅執行公平執行緒的 CPU 移至閒置 CPU,會以快取親和性和 IPI 換取不提前執行。
停用時,系統會優先使用閒置的 CPU。
TODO(https://fxbug.dev/448195120):預設啟用後即可移除。
kernel.ubsan.action=[oops | panic]
預設值:panic
如果核心使用 UndefinedBehaviorSanitizer 檢測,偵測到的問題會回報至序列控制台。這些錯誤可能是致命的,也可能不是。值必須是下列其中一項:
* oops
- 偵測到未定義的行為,導致非致命的核心 OOPS。
* panic
- 偵測到未定義的行為,導致嚴重的核心錯誤。
kernel.debug.boot-spin=<bool>
預設值:false
注意:這項功能僅適用於核心偵錯,不適用於正式版核心。如果核心編譯時未啟用斷言和其他偵錯功能,這個選項就不會生效。
設定後,核心適當位置中的部分第一個程式碼 (在 physboot 移交後) 會在特定全域變數為零時旋轉。必須透過附加至核心的偵錯工具 (例如透過 QEMU 的 -s) 設定變數,才能繼續啟動。這樣一來,虛擬啟動 CPU 就能輕鬆透過附加的偵錯工具執行開機載入器和提早啟動程式碼,然後在偵錯工具中以互動方式中斷旋轉,設定中斷點或逐步執行啟動程式碼。
僅適用於 arm64 機器的選項
kernel.arm64.disable_spec_mitigations=<bool>
預設值:false
如果設定,則會停用所有推測執行資訊外洩緩解措施。
如未設定,系統會使用各項緩解措施的預設值。
kernel.arm64.event-stream.enable=<bool>
預設值:true
啟用後,每個 ARM CPU 都會啟用事件串流產生器,以特定頻率設定每個 CPU 的隱藏事件標記。這會將 CPU 從可能處於的任何 WFE 狀態中踢出。
kernel.arm64.event-stream.freq-hz=<uint32_t>
預設值:0x2710
如果已啟用事件串流,請指定嘗試執行的頻率。解析度有限,因此驅動程式庫只能從 CPU 計時器計數器中,挑選最接近的 2 的冪。
kernel.arm64.debug.dap-rom-soc=<string>
如果設定,則會嘗試在特定晶片系統的硬式編碼位址初始化 dap 偵錯光圈。目前接受的值為 amlogic-t931g、amlogic-s905d2、amlogic-s905d3g 和 amlogic-a311d。
kernel.smp.maxcpus=<uint32_t>
預設值:0x10
這個選項會限制要初始化的 CPU 數量。不得大於特定架構的 SMP_MAX_CPUS。
kernel.phys.psci-reset=[disabled | shutdown | reboot | reboot-bootloader | reboot-recovery]
預設值:reboot
這個選項會決定提早啟動核心在需要發生核心異常和當機時,會使用哪種 PSCI 重設作業 (如有)。如果設為「disabled」,機器可能會在發生核心異常時進入無限迴圈。
kernel.arm64.phys.mmu=<bool>
預設值:true
這樣一來,核心就能在提早啟動階段使用 MMU 和快取。
kernel.arm64.enable-asid=<bool>
預設值:true
這樣就能使用 ASID。如果基礎硬體支援 16 位元 ASID,則預設為 True。
kernel.arm64.alternate-vbar=[none | auto | arch3 | arch1 | psci | smccc10]
預設值:auto
這會選取替代例外狀況向量實作,用於解決從 EL0 進入 EL1 時發生的 CPU 專屬問題。可能的值如下:
* none:未在早期 EL0 例外狀況路徑中執行緩解措施。
* auto (預設) - 根據韌體透過 SMCCC/PSCI 介面回報的可用性,選取 SMCCC 函式 ID。接著,每個 CPU 會查詢韌體,確認是否需要採用解決方法。如果韌體不是 SMCCC >= 1.1,且回報支援 SMCCC_ARCH_WORKAROUND_3 和/或 SMCCC_ARCH_WORKAROUND_1 函式 ID,則效果與 none 相同。如果韌體支援,則每個 CPU 會根據韌體在該 CPU 上所需的功能,使用或不使用韌體解決方法。無論是哪一種情況,系統都會停用替代的 Spectre 緩解措施,這些措施可能與韌體解決方法重複,或是在不需要韌體解決方法時也不需要。* arch3:一律在每個 CPU 上使用 SMCCC_ARCH_WORKAROUND_3。如果韌體不支援 SMCCC 1.1 或 SMCCC_ARCH_WORKAROUND_3,可能會產生無法預測的影響。如果韌體支援這項功能,每個 CPU 都會執行 auto 為韌體指定應使用的個別 CPU 所選取的動作。這也會停用與 SMCCC_ARCH_WORKAROUND_3 重複的其他 Spectre 緩解措施。* arch1:一律在每個 CPU 上使用 SMCCC_ARCH_WORKAROUND_1。如果韌體不支援 SMCCC 1.1 或 SMCCC_ARCH_WORKAROUND_1,可能會產生無法預測的影響。如果韌體支援「1」函式,但不支援「3」函式,則每個 CPU 都會執行 auto 為韌體指定應使用該函式的每個 CPU 所選取的動作。這也會停用與 SMCCC_ARCH_WORKAROUND_1 重複的其他 Spectre 緩解措施。* psci:一律在每個 CPU 上使用 PSCI_VERSION 搭配 SMCCC 1.1 呼叫慣例。如果韌體不支援 SMCCC 1.1,可能會產生無法預測的影響。目前 auto 不會為任何 CPU 選取這項行為。* smccc10:一律在每個 CPU 上使用 PSCI_VERSION 搭配 SMCCC 1.0 呼叫慣例。這在所有系統上都很安全,但負擔比 SMCCC 1.1 選項高,而且不一定所有 CPU 都需要。目前 auto 絕不會為任何 CPU 選取這項行為。如同具有異質核心的 SoC,每個 CPU 都應選取不同的值,且只有在測試時才能使用 auto 以外的值。
kernel.arm64.force-pct=<bool>
預設值:false
根據預設,核心會選取 ARM 虛擬計數器 (VCT),做為系統的時間參考。只有在收到實體計時器硬體的 IRQ,而非虛擬計時器硬體時,才會選擇實體計數器 (PCT)。設定 force-pct 選項後,核心會一律選擇使用 PCT 做為時間參考,即使 ZBI 中提供 VCT IRQ 也是如此。請注意,如果對未定義 PCT IRQ 的目標設定 force-pct,系統會在提早啟動期間發生核心異常。
kernel.arm64.pci=<bool>
預設值:true
啟用核心模式 PCI 支援和核心 PCI syscall。
kernel.arm64.smccc-qcom=<bool>
預設值:false
啟用符合 QCOM 通訊協定的核心輔助 Yielding SMCCC 呼叫。
核心會自動代表呼叫端,繼續執行遭先占的 SMCCC Yielding 呼叫。
kernel.arm-smmu-mode=<string>
預設值:disabled
這個選項會決定核心如何處理在開機時透過 ZBI 參數告知的 SMMU 執行個體。格式是以半形逗號分隔的清單,開頭為預設模式,後面接著零或多個 <base-address>=<mode> 區段,可用於覆寫特定 SMMU 執行個體的預設模式,由 SMMU 暫存器的基本實體位址識別。模式可使用三種有效值:
* disabled
- 忽略 SMMU 硬體。其暫存器區域未保留 (允許使用者模式宣告暫存器),且 SMMU 硬體的狀態會維持在透過系統啟動載入程式鏈結交給 Zircon 時的狀態。建立 ZX_IOMMU_TYPE_ARM_SMMU 類型 IOMMU 執行個體的要求,會改為替換 StubIommu 執行個體。洩漏 PMT 的頁面會照常隔離。* passthru
- 系統會宣告 SMMU 硬體,並保留暫存器區域。使用者模式無法存取這個硬體。BTI 必須提供有效的串流 ID,並用於設定相關聯串流 ID 的所有記憶體作業皆允許的內容。系統不會執行/強制執行位址轉譯和每頁權限。在 BTI 的情境遭到鎖定並拒絕存取後,外洩的 PMT 頁面會傳回主頁面集區。解除隔離後,BTI 的直通模式會恢復。* enforced
- 系統會宣告 SMMU 硬體,並保留暫存器區域。使用者模式無法存取這個硬體。BTI 必須提供有效的串流 ID,並用於為該 BTI 設定獨立的裝置位址空間。系統會執行位址轉譯,並強制執行固定記憶體的每頁權限。移除固定記憶體的 PTE 後,洩漏的 PMT 頁面會傳回主頁面集區,並撤銷 HW 對這些頁面的存取權。
僅適用於 riscv64 機器的選項
kernel.smp.maxcpus=<uint32_t>
預設值:0x10
這個選項會限制要初始化的 CPU 數量。不得大於特定架構的 SMP_MAX_CPUS。
kernel.riscv64.enable-asid=<bool>
預設值:true
這樣就能使用 ASID。如果基礎硬體支援 16 位元 ASID,則預設為 True。
kernel.riscv64.phys.mmu=<bool>
預設值:true
這樣一來,核心就能在提早啟動階段使用 MMU。
僅適用於 x86 機器的選項
kernel.x86.disable_spec_mitigations=<bool>
預設值:false
如果設定,則會停用所有推測執行資訊外洩緩解措施。
如未設定,系統會使用各項緩解措施的預設值。
kernel.x86.hwp=<bool>
預設值:true
這項設定可在支援的晶片上啟用 HWP (硬體 P 狀態)。這項功能可讓 Intel CPU 自動調整時脈速度。
kernel.x86.hwp_policy=[bios-specified | performance | balanced | power-save | stable-performance]
預設值:bios-specified
設定 CPU 的電源/效能權衡政策。支援 HWP (硬體 P 狀態) 的 x86 CPU 可設定為自動調整頻率,以利執行不同政策。
目前支援的政策包括:
bios-specified:使用韌體/BIOS 設定中指定的電源/效能權衡政策。如果沒有可用的政策,則會改用balanced。performance:爭取最高成效。balanced:平衡效能和省電效果。power-save:降低耗電量,但效能會降低。stable-performance:使用可維持系統效能穩定的設定。這項功能在基準測試時可能很有用,例如,當維持可預測的效能比最大化效能更重要時。
kernel.x86.md_clear_on_user_return=<bool>
預設值:true
MDS (微架構資料取樣) 是一系列推測執行資訊外洩錯誤,無論權限層級為何,惡意程式碼都能推斷最近載入或儲存的內容 (CVE-2019-11091、CVE-2018-12126、CVE-2018-12130、CVE-2018-12127)。舉例來說,這可能會讓使用者程式碼讀取最近的核心載入/儲存。
為避免這個錯誤,所有可能洩漏資料的微架構結構都必須在信任層級轉換時清除。此外,請務必避免在單一實體處理器核心上同時執行不同信任層級。
這個選項可控管是否要在核心至使用者結束路徑上清除微架構結構 (如果可能)。這可能會對效能造成負面影響。
- 如果設為 true (預設值),當處理器有安全漏洞時,系統會清除結構。
- 如果設為 False,則不會對結構執行清除作業。
kernel.x86.spec_store_bypass_disable=<bool>
預設值:false
Spec-store-bypass (Spectre V4) 是推測執行資訊外洩安全漏洞,會影響許多 Intel 和 AMD x86 CPU。這項技術會鎖定記憶體消除歧義硬體,推斷最近儲存的內容。這類攻擊只會影響相同權限等級的程序內資料。
這個指令列選項可控管是否啟用緩解措施。緩解措施會對效能造成負面影響。
- 如果設為 true,系統會在需要緩解措施的 CPU 上啟用緩解措施。
- 如果設為 false (預設值),則不會啟用緩解措施。
kernel.x86.turbo=<bool>
預設值:true
Turbo Boost 或 Core Performance Boost 是允許處理器在執行階段,根據可用的散熱和電力預算動態調整效能的機制。這可能會提升互動效能,但代價是效能會有所波動。停用 Turbo 可能會對某些工作負載有益;如果將這個指令列旗標設為 false,系統中所有 CPU 的 Turbo 都會停用。
kernel.x86.enable_pcid=<bool>
預設值:true
如果 CPU 支援充足,這個選項可控管是否要使用 PCID。如果啟用這個選項,但 CPU 支援不足,則這個選項不會生效。
kernel.smp.maxcpus=<uint32_t>
預設值:0x20
這個選項會限制要初始化的 CPU 數量。不得大於特定架構的 SMP_MAX_CPUS。
kernel.wallclock=[auto | tsc | pit | hpet]
預設值:auto
這個選項可用來強制選取電腦版本上的特定時鐘。