Skip to content

Commit a31b20b

Browse files
committed
doc/iso_boot.md: document CorePlus/TinyCore display limitation and Layer 1 check
- Add subsection explaining the DRM/KMS display driver check in Layer 1 - Document that CorePlus/TinyCore relies on vesafb (needs VESA BIOS, absent on coreboot without CSM) and has no KMS driver - Note that all major distros (Debian, Ubuntu, Fedora, etc.) ship DRM/KMS drivers and pass the display check
1 parent bc8529e commit a31b20b

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

doc/iso_boot.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -164,3 +164,31 @@ kexec-tools to properly convey the framebuffer state across kexec.
164164
**TPM Disk Unlock Key** works around this for encrypted disks by
165165
injecting the LUKS key before kexec — the initramfs never prompts for
166166
a passphrase on a blank display. Serial console is unaffected.
167+
168+
#### Layer 1 display driver check
169+
170+
Before showing boot options, Heads inspects each initrd for DRM/KMS
171+
kernel modules (i915, nouveau, amdgpu, bochs, virtio-gpu, etc.).
172+
These drivers reinitialize the display after kexec and make the booted
173+
OS visible regardless of efifb availability.
174+
175+
Entries where at least one such driver is found get `[OK]` markers.
176+
Where none is found and the initrd has other loadable modules, a warning
177+
dialog is shown before the boot menu.
178+
179+
#### ISOs without display drivers (CorePlus/TinyCore)
180+
181+
CorePlus and TinyCore ship a minimal kernel that uses `vesafb.ko`
182+
(VESA framebuffer) as its only display driver. `vesafb` requires
183+
VESA BIOS, which is unavailable under coreboot without a
184+
Compatibility Support Module (CSM).
185+
186+
The ISO's userspace extensions (`Xvesa.tcz`, window managers, etc.)
187+
are loaded by TinyCore's init after boot and do not provide kernel
188+
display drivers. After kexec, the target kernel has no KMS or
189+
framebuffer driver for any GPU — the display stays blank even though
190+
the OS boots and runs normally.
191+
192+
All other distributions tested (Debian, Ubuntu, Fedora, PureOS,
193+
NixOS, Tails) ship at least one DRM/KMS driver in their initrd and
194+
pass the display check.

0 commit comments

Comments
 (0)