[PATCH 3/3] Documentation/arm64: reflects FEAT_MTE_TAGGED_FAR description

Yeoreum Yun posted 3 patches 10 months, 1 week ago
There is a newer version of this series
[PATCH 3/3] Documentation/arm64: reflects FEAT_MTE_TAGGED_FAR description
Posted by Yeoreum Yun 10 months, 1 week ago
When FEAT_MTE_TAGGED_FAR feature is supported, the value of address bits
[63:60] is preserved on synchronous tag check fault.

This patch reflects the above feature in the documentation.

Signed-off-by: Yeoreum Yun <yeoreum.yun@arm.com>
---
 Documentation/arch/arm64/tagged-pointers.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/Documentation/arch/arm64/tagged-pointers.rst b/Documentation/arch/arm64/tagged-pointers.rst
index 81b6c2a770dd..73c59a9c7a63 100644
--- a/Documentation/arch/arm64/tagged-pointers.rst
+++ b/Documentation/arch/arm64/tagged-pointers.rst
@@ -60,11 +60,12 @@ that signal handlers in applications making use of tags cannot rely
 on the tag information for user virtual addresses being maintained
 in these fields unless the flag was set.
 
-Due to architecture limitations, bits 63:60 of the fault address
-are not preserved in response to synchronous tag check faults
-(SEGV_MTESERR) even if SA_EXPOSE_TAGBITS was set. Applications should
-treat the values of these bits as undefined in order to accommodate
-future architecture revisions which may preserve the bits.
+If FEAT_MTE_TAGGED_FAR (Armv8.9) is supported, bits 63:60 of the fault address
+are preserved in response to synchronous tag check faults (SEGV_MTESERR)
+otherwise not preserved even if SA_EXPOSE_TAGBITS was set.
+Applications should interpret the values of these bits based on
+the support for the 'mte_far' hwcap. If the support is not present,
+the values of these bits should be considered as undefined otherwise valid.
 
 For signals raised in response to watchpoint debug exceptions, the
 tag information will be preserved regardless of the SA_EXPOSE_TAGBITS
-- 
LEVI:{C3F47F37-75D8-414A-A8BA-3980EC8A46D7}
Re: [PATCH 3/3] Documentation/arm64: reflects FEAT_MTE_TAGGED_FAR description
Posted by Mark Brown 10 months, 1 week ago
On Thu, Apr 03, 2025 at 03:15:35PM +0100, Yeoreum Yun wrote:
> When FEAT_MTE_TAGGED_FAR feature is supported, the value of address bits
> [63:60] is preserved on synchronous tag check fault.
> 
> This patch reflects the above feature in the documentation.
> 
> Signed-off-by: Yeoreum Yun <yeoreum.yun@arm.com>
> ---
>  Documentation/arch/arm64/tagged-pointers.rst | 11 ++++++-----
>  1 file changed, 6 insertions(+), 5 deletions(-)

I saw the subject line and was looking for the elf_hwcaps.rst update in
this patch, though really it should be in patch 1.
Re: [PATCH 3/3] Documentation/arm64: reflects FEAT_MTE_TAGGED_FAR description
Posted by Yeoreum Yun 10 months, 1 week ago
Hi Mark,

> On Thu, Apr 03, 2025 at 03:15:35PM +0100, Yeoreum Yun wrote:
> > When FEAT_MTE_TAGGED_FAR feature is supported, the value of address bits
> > [63:60] is preserved on synchronous tag check fault.
> >
> > This patch reflects the above feature in the documentation.
> >
> > Signed-off-by: Yeoreum Yun <yeoreum.yun@arm.com>
> > ---
> >  Documentation/arch/arm64/tagged-pointers.rst | 11 ++++++-----
> >  1 file changed, 6 insertions(+), 5 deletions(-)
>
> I saw the subject line and was looking for the elf_hwcaps.rst update in
> this patch, though really it should be in patch 1.

Thanks to let me know. I'll squash it to patch 1.

--
Sincerely,
Yeoreum Yun