[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