[PATCH 2/2] docs: arm64: Document booting requirements for POE at EL0
From: Kevin Brodsky
Date: Thu Nov 19 2026 - 13:03:57 EST
Add missing boot requirements for the kernel to enable FEAT_S1POE at
EL0 (POE is currently unused at EL1). SCR_EL3.PIEn controls trapping
for both PIE and POE registers.
Suggested-by: Mark Brown <broonie@xxxxxxxxxx>
Signed-off-by: Kevin Brodsky <kevin.brodsky@xxxxxxx>
---
Documentation/arch/arm64/booting.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/Documentation/arch/arm64/booting.rst b/Documentation/arch/arm64/booting.rst
index 8f22aa7b2c0b..3f31eedd8551 100644
--- a/Documentation/arch/arm64/booting.rst
+++ b/Documentation/arch/arm64/booting.rst
@@ -515,6 +515,18 @@ Before jumping into the kernel, the following conditions must be met:
- HFGRWR_EL2.nPIRE0_EL1 (bit 57) must be initialised to 0b1.
+ For CPUs with the Stage 1 Permission Overlay Extension feature (FEAT_S1POE):
+
+ - If EL3 is present:
+
+ - SCR_EL3.PIEn (bit 45) must be initialised to 0b1.
+
+ - If the kernel is entered at EL1 and EL2 is present:
+
+ - HFGRTR_EL2.nPOR_EL0 (bit 59) must be initialised to 0b1.
+
+ - HFGWTR_EL2.nPOR_EL0 (bit 59) must be initialised to 0b1.
+
For CPUs with Guarded Control Stacks (FEAT_GCS):
- GCSCR_EL1 must be initialised to 0.
--
2.56.0