diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst index fab3f2f07503e416c2011e340fdb98e5b4696cf8..1f0dd4dcc4ea229c0b2047efe058d69e8e623979 100644 --- a/source/chapter2-uefi.rst +++ b/source/chapter2-uefi.rst @@ -47,7 +47,7 @@ rely on information provided by early platform bootstages [FWU]_. The acceptance status of each FW image is provisionally displayed in the LastAttemptedStatus field [#provisional]_ in the ESRT image entry. A value of 0x3fff implies that the image has not been accepted. The OS must -explicitly accept the image by installing an acceptance capsule as described in `OS directed capsule acceptance`_. +explicitly accept the image by installing an acceptance capsule as described in `OS directed FW image acceptance`_. .. [#provisional] Presenting the image acceptance status in the LastAttemptedStatus field is a provisional arrangement. A more permanet solution is under discussion. @@ -74,6 +74,7 @@ When UEFI receives the capsule above, UEFI will change the FWU metadata active_i #. Set the active_index field in the FWU Metadata [FWU]_ if the flash store is owned by the Normal World. #. Restore EFI variables to their previous state, if changed during the firmware upgrade. +.. _OS directed FW image acceptance: OS directed FW image acceptance ------------------------------- @@ -85,8 +86,8 @@ The OS can inform the UEFI implementation of all the FW images that the OS inten The OS can set the EFI_CAPSULE_HEADER.flags[15] to 1 indicating that it will explicitly accept all the FW images contained in this capsule. The OS must be able to accept all images that it registers to accept. Any other images should be implicitly accepted by the UEFI implementation. -OS directed FW image acceptance -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +FW image acceptance +^^^^^^^^^^^^^^^^^^^ The OS must accept each image, that has an acceptance pending, by using a capsule composed of an EFI_CAPSULE_HEADER concatenated with the image UUID: