tl;dr: Yea, I likely still need to update the docs to represent the current state of play.
Warner On Sat, Jun 7, 2025 at 1:55 AM Mark Millard <mark...@yahoo.com> wrote: > > 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 > >
