[PATCH master] Documentation: migration-2025.08.0: add note about W^X

[PATCH master] Documentation: migration-2025.08.0: add note about W^X

[Ahmad Fatoum]

CONFIG_ARM_MMU_PERMISSIONS was a relatively invasive change, so it
should be pointed out specifically to avoid users running into issues
with it.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 .../migration-guides/migration-2025.08.0.rst         | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Documentation/migration-guides/migration-2025.08.0.rst b/Documentation/migration-guides/migration-2025.08.0.rst
index b40119ac672b..86412f25c36e 100644
--- a/Documentation/migration-guides/migration-2025.08.0.rst
+++ b/Documentation/migration-guides/migration-2025.08.0.rst
@@ -1,6 +1,18 @@
 Release v2025.08.0
 ==================
 
+W^X on ARM
+----------
+
+``CONFIG_ARM_MMU_PERMISSIONS=y`` is now the default and instructs barebox to map
+its memory regions with more restricted permissions: Data is no longer executable
+and code as well as read-only data is no longer writable.
+
+This can lead to breakage in code that had invalid assumptions beforehand,
+e.g. code expecting on-chip SRAMs to be executable or bogus code casting away
+const. Please report to upstream any issues that are resolved by disabling
+``CONFIG_ARM_MMU_PERMISSIONS``, so they can be properly fixed.
+
 Bootchooser
 -----------
 
-- 
2.47.3

Re: [PATCH master] Documentation: migration-2025.08.0: add note about W^X

[Sascha Hauer]

On Fri, 24 Oct 2025 12:33:12 +0200, Ahmad Fatoum wrote:
> CONFIG_ARM_MMU_PERMISSIONS was a relatively invasive change, so it
> should be pointed out specifically to avoid users running into issues
> with it.
> 
> 

Applied, thanks!

[1/1] Documentation: migration-2025.08.0: add note about W^X
      https://git.pengutronix.de/cgit/barebox/commit/?id=fa90720f05c4 (link may not be stable)

Best regards,
-- 
Sascha Hauer <s.hauer@pengutronix.de>