2022: author Warner Losh <i...@freebsd.org> 2022-09-01 16:34:30 +0000 committer Warner Losh <i...@freebsd.org> 2022-09-01 16:34:30 +0000 commit 75a91c70f8d12825ded5a6d14841bf3065ba6595 (patch) tree 6a7f7b85f596d2b5067194450b80df96f4ba40fc /stand/man/loader.efi.8 parent b1819983e70f5b8890404b7e07d17888d0cccfb6 (diff)
stand: Document EFI consoles Document how EFI consoles work, at least on x86. There's a number of weird quirks and limitations that are generally known, but not documented until now. Include information on how EFI decides what the defualt console is, how to set it and how to cope with common situations. Note limitations and mismatch between ACPI (which uses UID to identify a device) and our console code (which uses a raw address) and explain why we can't translate between them in the loader. Sponsored by: Netflix Reviewed by: manu, kevans, rpokala, pauamma Differential Revision: https://reviews.freebsd.org/D36286 vs. the 2023: Commit message (Expand) Author Age Files Lines * stand: libefi: avoid a null pointer deref in eficom Kyle Evans 2023-05-28 1 -2/+2 * stand/efi/eficom: Free comc_port if we can't find the serial port Warner Losh 2023-05-25 1 -0/+10 * stand/efi/eficom: Make aarch64 compat code probe correctly Warner Losh 2023-05-25 1 -2/+5 * stand/efi/eficom: Don't allow this for !HYPERV machines Warner Losh 2023-05-25 1 -0/+17 * stand/efi/eficom: better handling of absent device Warner Losh 2023-05-25 1 -5/+16 * stand: eficom: Only set baudrate when it changes Warner Losh 2023-05-11 1 -17/+22 * stand: eficom: Don't preemtively assume flow control Warner Losh 2023-05-11 1 -9/+5 * stand: eficom : remove unused ignore_cd Warner Losh 2023-05-11 1 -2/+0 * stand: Move eficom to libefi Warner Losh 2023-05-11 6 -6/+1 * stand: efi create eficom console device. Warner Losh 2023-05-11 3 -72/+39 Those stand updates show up in main and releng/14.0 (but not in stable/13). They did not include a "main 8 loader.efi" update. Is man 8 loader.efi going to stop referencing comconsole as what to use (vs. eficom) at some point? Similarly for all of: # man -K comconsole /usr/share/man/man8/loader.8.gz: console variable, or set it to serial console (“comconsole”) if the /usr/share/man/man8/loader.efi.8.gz: work) and “comconsole” for the serial on COM1 at the default baud rate. /usr/share/man/man8/loader.efi.8.gz: “comconsole”. The default port is COM1 with an I/O address of 0x3f8. /usr/share/man/man8/loader.efi.8.gz: comconsole_port is used to set this to a different port address. /usr/share/man/man8/loader.efi.8.gz: comconsole_speed is used to set the of the serial port (the default is /usr/share/man/man8/loader.efi.8.gz: 9600). If you have console set to “efi,comconsole” you will get output /usr/share/man/man8/loader_4th.8.gz: console variable, or set it to serial console (“comconsole”) if the /usr/share/man/man8/loader_lua.8.gz: console variable, or sets it to serial console (“comconsole”) if the /usr/share/man/man8/loader_simp.8.gz: console variable, or set it to serial console (“comconsole”) if the /usr/share/man/man5/loader.conf.5.gz: console (“vidconsole”) “comconsole” selects serial console, vs. the lack of any reference to eficom: # man -K eficom # === Mark Millard marklmi at yahoo.com
