steamos-bootdebug 命令

常用示例

说明

steamos-bootdebug is a small administration script that ships with SteamOS 3+ on the Steam Deck. It surfaces controls for the SteamOS chainloader — the small bootloader stub that decides which of the two A/B system images to load — and for the kernel command line baked into each image. The chainloader runs before GRUB and normally boots the active slot silently. steamos-bootdebug menu flips it into interactive mode so the user can edit GRUB entries (useful for adding systemd.unit=rescue.target, alternate root= parameters, and so on). verbose and quiet toggle whether chainloader log lines go to the console or are suppressed; log enable/disable/show capture those lines to a file in the EFI System Partition for post-mortem inspection. The kernel-debug/kernel-quiet family edits the kernel command line of one or both A/B images: enabling kernel debug removes the quiet parameter, enables verbose printk output, and is invaluable for diagnosing display, GPU, or storage init issues. kernel-debug-once is the safest option — it self-reverts after a single boot, so you cannot accidentally leave the system in a noisy state.

参数

menu

Enable the chainloader boot menu, allowing GRUB editing and A/B slot selection at boot.

verbose

Send chainloader log output to the system console.

quiet

Disable both the menu and verbose console output.

log enable

Persist chainloader logs to a file on the EFI System Partition (/esp).

log disable

Stop persisting chainloader logs to the filesystem.

log show

Print the contents of the chainloader log file.

kernel-debug _image_

Enable kernel debug output (no quiet parameter, debug messages on console) for the named slot _image_, or both if omitted.

kernel-debug-once _image_

Enable kernel debug for only the next boot, then automatically revert.

kernel-quiet _image_

Restore the standard silent kernel boot.

status

Print the current debug configuration of both slots.