Page MenuHomeFreeBSD

Document the UEFI boot loading process
AcceptedPublic

Authored by imp on Apr 25 2019, 2:37 PM.

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 OK
Unit
No Unit Test Coverage
Build Status
Buildable 23898
Build 22823: arc lint + arc unit

Event Timeline

imp created this revision.Apr 25 2019, 2:37 PM
imp edited the test plan for this revision. (Show Details)Apr 25 2019, 2:39 PM
imp added reviewers: rpokala, bcran, tsoome, manu, kevans.
bcran added inline comments.Apr 25 2019, 2:48 PM
stand/man/boot1.efi.8
53

Missing period (to be consistent with previous sentences).

bcran accepted this revision.Apr 25 2019, 2:48 PM
This revision is now accepted and ready to land.Apr 25 2019, 2:48 PM
andrew added a subscriber: andrew.Apr 25 2019, 2:49 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.

emaste added a subscriber: emaste.Apr 25 2019, 2:55 PM

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?)

imp added a comment.Apr 25 2019, 11:55 PM

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.

imp added a comment.Apr 25 2019, 11:55 PM

ok thanks