stand: Document EFI consoles
authorWarner Losh <imp@FreeBSD.org>
Thu, 1 Sep 2022 16:34:30 +0000 (10:34 -0600)
committerWarner Losh <imp@FreeBSD.org>
Thu, 1 Sep 2022 16:34:30 +0000 (10:34 -0600)
commit75a91c70f8d12825ded5a6d14841bf3065ba6595
tree6a7f7b85f596d2b5067194450b80df96f4ba40fc
parentb1819983e70f5b8890404b7e07d17888d0cccfb6
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
stand/man/loader.efi.8