Page MenuHomeFreeBSD

Document the UEFI boot loading process
ClosedPublic

Authored by imp on Apr 25 2019, 2:37 PM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Mar 7, 3:50 PM
Unknown Object (File)
Jan 16 2024, 1:21 AM
Unknown Object (File)
Dec 20 2023, 1:10 AM
Unknown Object (File)
Nov 25 2023, 6:48 PM
Unknown Object (File)
Jul 22 2023, 4:06 PM
Unknown Object (File)
Jun 16 2023, 7:09 PM
Unknown Object (File)
Apr 25 2023, 6:50 PM
Unknown Object (File)
Apr 8 2023, 12:24 AM

Details

Summary

boot1.efi.8:
Document this rudamentary chain loader, and note it's deprecated.
loader.efi.8:
Document the boot sequence when loader.efi is used. Document what is
searched, when and how. Document the variables it provides, and the
unique variables used by it.

Test Plan

Note: loader.efi.8 is super lean at the moment.

Diff Detail

Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 23898
Build 22823: arc lint + arc unit

Event Timeline

imp added reviewers: rpokala, bcran, tsoome, manu, kevans.
stand/man/boot1.efi.8
53

Missing period (to be consistent with previous sentences).

This revision is now accepted and ready to land.Apr 25 2019, 2:48 PM
andrew added inline comments.
stand/man/loader.efi.8
39

Should this mention the XXX should be replaced with an architecture specific name?

43

It might be useful to add the caveat that some firmware is unable to set a non-default boot location (at least via the runtime services). Many arm/arm64 boards with only one storage media are unable to set the needed variable to change the boot path.

Note that there is a description of boot1's logic in uefi.8

boot1.efi.8 needs to mention where boot1.efi lives on disk. (/efi/boot/boot${ARCH}.efi, right?)

boot1.efi.8 needs to mention where boot1.efi lives on disk. (/efi/boot/boot${ARCH}.efi, right?)

I'm unsure. I likely need a FILES section that list these.

stand/man/boot1.efi.8
53

OK.

stand/man/loader.efi.8
39

This manual is likely going to be completely rewritten.

43

Right. That's in flux, so I'm not going to document it yet. This is mostly a place holder, I may opt not to commit it.