I've already pushed these out to GitHub, but posting to the mailing list for completeness.
Grant Likely (5): trivial: fix broken internal reference trivial: Put SPDX tag into all source files trivial: Fix reference to required runtime services section editorial: tighten up uefi runtime services language editorial: Drop value statement between ACPI & DT
source/appendix-a-uefi-features.rst | 3 +++ source/chapter1-about.rst | 4 ++-- source/chapter2-uefi.rst | 12 ++++++++---- source/chapter3-secureworld.rst | 2 ++ source/chapter4-firmware-media.rst | 2 ++ source/references.rst | 2 ++ 6 files changed, 19 insertions(+), 6 deletions(-)
Signed-off-by: Grant Likely grant.likely@arm.com --- source/chapter2-uefi.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst index a8bd71e..03a0c83 100644 --- a/source/chapter2-uefi.rst +++ b/source/chapter2-uefi.rst @@ -16,7 +16,8 @@ EBBR compliant platforms shall conform to the requirements in [UEFI]_ ยง 2.6, except where explicit exemptions are provided by this document.
EBBR compliant platforms shall also implement the UEFI services and -protocols that are listed in :ref:appendix-uefi-requirements of this document. +protocols that are listed in :ref:`appendix-uefi-requirements` of this +document.
Block device partitioning -------------------------
All .rst files should include the SPDX tag so that it stays with the file if taken into a different context.
Signed-off-by: Grant Likely grant.likely@arm.com --- source/appendix-a-uefi-features.rst | 1 + source/chapter1-about.rst | 2 ++ source/chapter2-uefi.rst | 2 ++ source/chapter3-secureworld.rst | 2 ++ source/chapter4-firmware-media.rst | 2 ++ source/references.rst | 2 ++ 6 files changed, 11 insertions(+)
diff --git a/source/appendix-a-uefi-features.rst b/source/appendix-a-uefi-features.rst index 709b929..a03f441 100644 --- a/source/appendix-a-uefi-features.rst +++ b/source/appendix-a-uefi-features.rst @@ -1,3 +1,4 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 .. _appendix-uefi-requirements:
############################################# diff --git a/source/chapter1-about.rst b/source/chapter1-about.rst index 1dafd39..34627aa 100644 --- a/source/chapter1-about.rst +++ b/source/chapter1-about.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + ******************* About This Document ******************* diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst index 03a0c83..493cc9c 100644 --- a/source/chapter2-uefi.rst +++ b/source/chapter2-uefi.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + **** UEFI **** diff --git a/source/chapter3-secureworld.rst b/source/chapter3-secureworld.rst index fc0833c..25d24f5 100644 --- a/source/chapter3-secureworld.rst +++ b/source/chapter3-secureworld.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + ****************************** Priviledged or Secure Firmware ****************************** diff --git a/source/chapter4-firmware-media.rst b/source/chapter4-firmware-media.rst index 39a1c03..d65830d 100644 --- a/source/chapter4-firmware-media.rst +++ b/source/chapter4-firmware-media.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + **************** Firmware Storage **************** diff --git a/source/references.rst b/source/references.rst index 6d40ecc..a12c1a2 100644 --- a/source/references.rst +++ b/source/references.rst @@ -1,3 +1,5 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + .. [ACPI] `Advanced Configuration and Power Interface specification v6.2A http://www.uefi.org/sites/default/files/resources/ACPI%206_2_A_Sept29.pdf`_, September 2017, `UEFI Forum http://www.uefi.org`_
Fix old artifact of conversion from .docx to .rst. There was a plain text reference to an appendix section that should have been converted to a reStructuredText :ref: tag. Fixed in this patch.
Signed-off-by: Grant Likely grant.likely@arm.com --- source/appendix-a-uefi-features.rst | 2 ++ source/chapter2-uefi.rst | 3 ++- 2 files changed, 4 insertions(+), 1 deletion(-)
diff --git a/source/appendix-a-uefi-features.rst b/source/appendix-a-uefi-features.rst index a03f441..8777edd 100644 --- a/source/appendix-a-uefi-features.rst +++ b/source/appendix-a-uefi-features.rst @@ -56,6 +56,8 @@ EFI_SET_MEM 7.5 EFI_CREATE_EVENT_EX 7.5 ========================================== ======
+.. _appendix-uefi-required-runtime: + Required Runtime Services *************************
diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst index 493cc9c..1c7f419 100644 --- a/source/chapter2-uefi.rst +++ b/source/chapter2-uefi.rst @@ -112,7 +112,8 @@ UEFI Runtime Services exist after the call to ExitBootServices() and are designed to provide a limited set of persistent services to the platform Operating System or hypervisor.
-The Runtime Services that are listed in Appendix B must be provided. +The Runtime Services that are listed in :ref:`appendix-uefi-required-runtime` +must be provided.
Runtime Exception Level -----------------------
Signed-off-by: Grant Likely grant.likely@arm.com --- source/chapter2-uefi.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst index 1c7f419..7b6843e 100644 --- a/source/chapter2-uefi.rst +++ b/source/chapter2-uefi.rst @@ -150,14 +150,14 @@ Runtime Device Mappings -----------------------
Firmware shall not create runtime mappings, or perform any runtime IO that will -conflict with device access. +conflict with device access by the OS. Normally this means a device may be controlled by firmware, or controlled by the OS, but not both. e.g. If firmware attempts to access an eMMC device at runtime then it will conflict with transactions being performed by the OS.
Devices that are provided to the OS (i.e., via PCIe discovery or ACPI/DT -description) shall not be access by firmware at runtime. +description) shall not be accessed by firmware at runtime. Similarly, devices retained by firmware (i.e., not discoverable by the OS) shall not be accessed by the OS.
Suggested-by: Mark Brown broonie@kernel.org Signed-off-by: Grant Likely grant.likely@arm.com --- source/chapter1-about.rst | 2 -- 1 file changed, 2 deletions(-)
diff --git a/source/chapter1-about.rst b/source/chapter1-about.rst index 34627aa..d1c6d1d 100644 --- a/source/chapter1-about.rst +++ b/source/chapter1-about.rst @@ -76,8 +76,6 @@ The following guiding principles are used while developing the EBBR specificatio
EBBR explicitly does not require a specific system description language. Both Devicetree and ACPI are supported. - While ACPI provides more standardization, Devicetree is preferred in many - embedded platforms for its flexibility. The Linux kernel supports both equally well, and so EBBR doesn't require one over the other. However, EBBR does require the system description to be supplied by the
boot-architecture@lists.linaro.org
-
Grant Likely