€•       Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ"/translations/zh_CN/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/zh_TW/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/it_IT/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/ja_JP/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/ko_KR/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/pt_BR/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/sp_SP/arch/arm64/sme”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ3Scalable Matrix Extension support for AArch64 Linux”h]”hŒ3Scalable Matrix Extension support for AArch64 Linux”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ</var/lib/git/docbuild/linux/Documentation/arch/arm64/sme.rst”h´KubhŒ	paragraph”“”)”}”(hŒThis document outlines briefly the interface provided to userspace by Linux in
order to support use of the ARM Scalable Matrix Extension (SME).”h]”hŒThis document outlines briefly the interface provided to userspace by Linux in
order to support use of the ARM Scalable Matrix Extension (SME).”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒîThis is an outline of the most important features and issues only and not
intended to be exhaustive.  It should be read in conjunction with the SVE
documentation in sve.rst which provides details on the Streaming SVE mode
included in SME.”h]”hŒîThis is an outline of the most important features and issues only and not
intended to be exhaustive.  It should be read in conjunction with the SVE
documentation in sve.rst which provides details on the Streaming SVE mode
included in SME.”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒÊThis document does not aim to describe the SME architecture or programmer's
model.  To aid understanding, a minimal description of relevant programmer's
model features for SME is included in Appendix A.”h]”hŒÎThis document does not aim to describe the SME architecture or programmerâ€™s
model.  To aid understanding, a minimal description of relevant programmerâ€™s
model features for SME is included in Appendix A.”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒ1.  General”h]”hŒ1.  General”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh÷h²hh³hÊh´KubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒŒPSTATE.SM, PSTATE.ZA, the streaming mode vector length, the ZA and (when
present) ZTn register state and TPIDR2_EL0 are tracked per thread.
”h]”hÌ)”}”(hŒ‹PSTATE.SM, PSTATE.ZA, the streaming mode vector length, the ZA and (when
present) ZTn register state and TPIDR2_EL0 are tracked per thread.”h]”hŒ‹PSTATE.SM, PSTATE.ZA, the streaming mode vector length, the ZA and (when
present) ZTn register state and TPIDR2_EL0 are tracked per thread.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hX#  The presence of SME is reported to userspace via HWCAP2_SME in the aux vector
AT_HWCAP2 entry.  Presence of this flag implies the presence of the SME
instructions and registers, and the Linux-specific system interfaces
described in this document.  SME is reported in /proc/cpuinfo as "sme".
”h]”hÌ)”}”(hX"  The presence of SME is reported to userspace via HWCAP2_SME in the aux vector
AT_HWCAP2 entry.  Presence of this flag implies the presence of the SME
instructions and registers, and the Linux-specific system interfaces
described in this document.  SME is reported in /proc/cpuinfo as "sme".”h]”hX&  The presence of SME is reported to userspace via HWCAP2_SME in the aux vector
AT_HWCAP2 entry.  Presence of this flag implies the presence of the SME
instructions and registers, and the Linux-specific system interfaces
described in this document.  SME is reported in /proc/cpuinfo as â€œsmeâ€.”…””}”(hj+  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hX"  The presence of SME2 is reported to userspace via HWCAP2_SME2 in the
aux vector AT_HWCAP2 entry.  Presence of this flag implies the presence of
the SME2 instructions and ZT0, and the Linux-specific system interfaces
described in this document.  SME2 is reported in /proc/cpuinfo as "sme2".
”h]”hÌ)”}”(hX!  The presence of SME2 is reported to userspace via HWCAP2_SME2 in the
aux vector AT_HWCAP2 entry.  Presence of this flag implies the presence of
the SME2 instructions and ZT0, and the Linux-specific system interfaces
described in this document.  SME2 is reported in /proc/cpuinfo as "sme2".”h]”hX%  The presence of SME2 is reported to userspace via HWCAP2_SME2 in the
aux vector AT_HWCAP2 entry.  Presence of this flag implies the presence of
the SME2 instructions and ZT0, and the Linux-specific system interfaces
described in this document.  SME2 is reported in /proc/cpuinfo as â€œsme2â€.”…””}”(hjC  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hX›  Support for the execution of SME instructions in userspace can also be
detected by reading the CPU ID register ID_AA64PFR1_EL1 using an MRS
instruction, and checking that the value of the SME field is nonzero. [3]

It does not guarantee the presence of the system interfaces described in the
following sections: software that needs to verify that those interfaces are
present must check for HWCAP2_SME instead.
”h]”(hÌ)”}”(hŒÕSupport for the execution of SME instructions in userspace can also be
detected by reading the CPU ID register ID_AA64PFR1_EL1 using an MRS
instruction, and checking that the value of the SME field is nonzero. [3]”h]”hŒÕSupport for the execution of SME instructions in userspace can also be
detected by reading the CPU ID register ID_AA64PFR1_EL1 using an MRS
instruction, and checking that the value of the SME field is nonzero. [3]”…””}”(hj[  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K"hjW  ubhÌ)”}”(hŒÃIt does not guarantee the presence of the system interfaces described in the
following sections: software that needs to verify that those interfaces are
present must check for HWCAP2_SME instead.”h]”hŒÃIt does not guarantee the presence of the system interfaces described in the
following sections: software that needs to verify that those interfaces are
present must check for HWCAP2_SME instead.”…””}”(hji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K&hjW  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hX$  There are a number of optional SME features, presence of these is reported
through AT_HWCAP2 through:

      HWCAP2_SME_I16I64
      HWCAP2_SME_F64F64
      HWCAP2_SME_I8I32
      HWCAP2_SME_F16F32
      HWCAP2_SME_B16F32
      HWCAP2_SME_F32F32
      HWCAP2_SME_FA64
      HWCAP2_SME2

This list may be extended over time as the SME architecture evolves.

These extensions are also reported via the CPU ID register ID_AA64SMFR0_EL1,
which userspace can read using an MRS instruction.  See elf_hwcaps.txt and
cpu-feature-registers.txt for details.
”h]”(hÌ)”}”(hŒeThere are a number of optional SME features, presence of these is reported
through AT_HWCAP2 through:”h]”hŒeThere are a number of optional SME features, presence of these is reported
through AT_HWCAP2 through:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K*hj}  ubhŒblock_quote”“”)”}”(hŒ‡HWCAP2_SME_I16I64
HWCAP2_SME_F64F64
HWCAP2_SME_I8I32
HWCAP2_SME_F16F32
HWCAP2_SME_B16F32
HWCAP2_SME_F32F32
HWCAP2_SME_FA64
HWCAP2_SME2
”h]”hÌ)”}”(hŒ†HWCAP2_SME_I16I64
HWCAP2_SME_F64F64
HWCAP2_SME_I8I32
HWCAP2_SME_F16F32
HWCAP2_SME_B16F32
HWCAP2_SME_F32F32
HWCAP2_SME_FA64
HWCAP2_SME2”h]”hŒ†HWCAP2_SME_I16I64
HWCAP2_SME_F64F64
HWCAP2_SME_I8I32
HWCAP2_SME_F16F32
HWCAP2_SME_B16F32
HWCAP2_SME_F32F32
HWCAP2_SME_FA64
HWCAP2_SME2”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K-hj‘  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´K-hj}  ubhÌ)”}”(hŒDThis list may be extended over time as the SME architecture evolves.”h]”hŒDThis list may be extended over time as the SME architecture evolves.”…””}”(hj©  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K6hj}  ubhÌ)”}”(hŒ¾These extensions are also reported via the CPU ID register ID_AA64SMFR0_EL1,
which userspace can read using an MRS instruction.  See elf_hwcaps.txt and
cpu-feature-registers.txt for details.”h]”hŒ¾These extensions are also reported via the CPU ID register ID_AA64SMFR0_EL1,
which userspace can read using an MRS instruction.  See elf_hwcaps.txt and
cpu-feature-registers.txt for details.”…””}”(hj·  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K8hj}  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hX:  Debuggers should restrict themselves to interacting with the target via the
NT_ARM_SVE, NT_ARM_SSVE, NT_ARM_ZA and NT_ARM_ZT regsets.  The recommended
way of detecting support for these regsets is to connect to a target process
first and then attempt a

      ptrace(PTRACE_GETREGSET, pid, NT_ARM_<regset>, &iov).
”h]”(hÌ)”}”(hŒüDebuggers should restrict themselves to interacting with the target via the
NT_ARM_SVE, NT_ARM_SSVE, NT_ARM_ZA and NT_ARM_ZT regsets.  The recommended
way of detecting support for these regsets is to connect to a target process
first and then attempt a”h]”hŒüDebuggers should restrict themselves to interacting with the target via the
NT_ARM_SVE, NT_ARM_SSVE, NT_ARM_ZA and NT_ARM_ZT regsets.  The recommended
way of detecting support for these regsets is to connect to a target process
first and then attempt a”…””}”(hjÏ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K<hjË  ubj  )”}”(hŒ6ptrace(PTRACE_GETREGSET, pid, NT_ARM_<regset>, &iov).
”h]”hÌ)”}”(hŒ5ptrace(PTRACE_GETREGSET, pid, NT_ARM_<regset>, &iov).”h]”hŒ5ptrace(PTRACE_GETREGSET, pid, NT_ARM_<regset>, &iov).”…””}”(hjá  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KAhjÝ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´KAhjË  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hŒüWhenever ZA register values are exchanged in memory between userspace and
the kernel, the register value is encoded in memory as a series of horizontal
vectors from 0 to VL/8-1 stored in the same endianness invariant format as is
used for SVE vectors.
”h]”hÌ)”}”(hŒûWhenever ZA register values are exchanged in memory between userspace and
the kernel, the register value is encoded in memory as a series of horizontal
vectors from 0 to VL/8-1 stored in the same endianness invariant format as is
used for SVE vectors.”h]”hŒûWhenever ZA register values are exchanged in memory between userspace and
the kernel, the register value is encoded in memory as a series of horizontal
vectors from 0 to VL/8-1 stored in the same endianness invariant format as is
used for SVE vectors.”…””}”(hjÿ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KChjû  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubj  )”}”(hŒ˜On thread creation PSTATE.ZA and TPIDR2_EL0 are preserved unless CLONE_VM
is specified, in which case PSTATE.ZA is set to 0 and TPIDR2_EL0 is set to 0.
”h]”hÌ)”}”(hŒ—On thread creation PSTATE.ZA and TPIDR2_EL0 are preserved unless CLONE_VM
is specified, in which case PSTATE.ZA is set to 0 and TPIDR2_EL0 is set to 0.”h]”hŒ—On thread creation PSTATE.ZA and TPIDR2_EL0 are preserved unless CLONE_VM
is specified, in which case PSTATE.ZA is set to 0 and TPIDR2_EL0 is set to 0.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KHhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1j  h³hÊh´Khh÷h²hubeh}”(h]”Œgeneral”ah ]”h"]”Œ
1. general”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ2.  Vector lengths”h]”hŒ2.  Vector lengths”…””}”(hj>  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj;  h²hh³hÊh´KLubhÌ)”}”(hŒòSME defines a second vector length similar to the SVE vector length which
controls the size of the streaming mode SVE vectors and the ZA matrix array.
The ZA matrix is square with each side having as many bytes as a streaming
mode SVE vector.”h]”hŒòSME defines a second vector length similar to the SVE vector length which
controls the size of the streaming mode SVE vectors and the ZA matrix array.
The ZA matrix is square with each side having as many bytes as a streaming
mode SVE vector.”…””}”(hjL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KNhj;  h²hubeh}”(h]”Œvector-lengths”ah ]”h"]”Œ2. vector lengths”ah$]”h&]”uh1hµhh·h²hh³hÊh´KLubh¶)”}”(hhh]”(h»)”}”(hŒ3.  System call behaviour”h]”hŒ3.  System call behaviour”…””}”(hje  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjb  h²hh³hÊh´KUubj	  )”}”(hhh]”(j  )”}”(hŒzOn syscall PSTATE.ZA is preserved, if PSTATE.ZA==1 then the contents of the
ZA matrix and ZTn (if present) are preserved.
”h]”hÌ)”}”(hŒyOn syscall PSTATE.ZA is preserved, if PSTATE.ZA==1 then the contents of the
ZA matrix and ZTn (if present) are preserved.”h]”hŒyOn syscall PSTATE.ZA is preserved, if PSTATE.ZA==1 then the contents of the
ZA matrix and ZTn (if present) are preserved.”…””}”(hjz  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KWhjv  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  h²hh³hÊh´Nubj  )”}”(hŒhOn syscall PSTATE.SM will be cleared and the SVE registers will be handled
as per the standard SVE ABI.
”h]”hÌ)”}”(hŒgOn syscall PSTATE.SM will be cleared and the SVE registers will be handled
as per the standard SVE ABI.”h]”hŒgOn syscall PSTATE.SM will be cleared and the SVE registers will be handled
as per the standard SVE ABI.”…””}”(hj’  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KZhjŽ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  h²hh³hÊh´Nubj  )”}”(hŒhNone of the SVE registers, ZA or ZTn are used to pass arguments to
or receive results from any syscall.
”h]”hÌ)”}”(hŒgNone of the SVE registers, ZA or ZTn are used to pass arguments to
or receive results from any syscall.”h]”hŒgNone of the SVE registers, ZA or ZTn are used to pass arguments to
or receive results from any syscall.”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K]hj¦  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  h²hh³hÊh´Nubj  )”}”(hŒYOn process creation (eg, clone()) the newly created process will have
PSTATE.SM cleared.
”h]”hÌ)”}”(hŒXOn process creation (eg, clone()) the newly created process will have
PSTATE.SM cleared.”h]”hŒXOn process creation (eg, clone()) the newly created process will have
PSTATE.SM cleared.”…””}”(hjÂ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K`hj¾  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  h²hh³hÊh´Nubj  )”}”(hX  All other SME state of a thread, including the currently configured vector
length, the state of the PR_SME_VL_INHERIT flag, and the deferred vector
length (if any), is preserved across all syscalls, subject to the specific
exceptions for execve() described in section 6.

”h]”hÌ)”}”(hX  All other SME state of a thread, including the currently configured vector
length, the state of the PR_SME_VL_INHERIT flag, and the deferred vector
length (if any), is preserved across all syscalls, subject to the specific
exceptions for execve() described in section 6.”h]”hX  All other SME state of a thread, including the currently configured vector
length, the state of the PR_SME_VL_INHERIT flag, and the deferred vector
length (if any), is preserved across all syscalls, subject to the specific
exceptions for execve() described in section 6.”…””}”(hjÚ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KchjÖ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´KWhjb  h²hubeh}”(h]”Œsystem-call-behaviour”ah ]”h"]”Œ3. system call behaviour”ah$]”h&]”uh1hµhh·h²hh³hÊh´KUubh¶)”}”(hhh]”(h»)”}”(hŒ4.  Signal handling”h]”hŒ4.  Signal handling”…””}”(hjÿ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjü  h²hh³hÊh´Kjubj	  )”}”(hhh]”(j  )”}”(hŒMSignal handlers are invoked with PSTATE.SM=0, PSTATE.ZA=0, and TPIDR2_EL0=0.
”h]”hÌ)”}”(hŒLSignal handlers are invoked with PSTATE.SM=0, PSTATE.ZA=0, and TPIDR2_EL0=0.”h]”hŒLSignal handlers are invoked with PSTATE.SM=0, PSTATE.ZA=0, and TPIDR2_EL0=0.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Klhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒ‰A new signal frame record TPIDR2_MAGIC is added formatted as a struct
tpidr2_context to allow access to TPIDR2_EL0 from signal handlers.
”h]”hÌ)”}”(hŒˆA new signal frame record TPIDR2_MAGIC is added formatted as a struct
tpidr2_context to allow access to TPIDR2_EL0 from signal handlers.”h]”hŒˆA new signal frame record TPIDR2_MAGIC is added formatted as a struct
tpidr2_context to allow access to TPIDR2_EL0 from signal handlers.”…””}”(hj,  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Knhj(  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒ^A new signal frame record za_context encodes the ZA register contents on
signal delivery. [1]
”h]”hÌ)”}”(hŒ]A new signal frame record za_context encodes the ZA register contents on
signal delivery. [1]”h]”hŒ]A new signal frame record za_context encodes the ZA register contents on
signal delivery. [1]”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kqhj@  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒ|The signal frame record for ZA always contains basic metadata, in particular
the thread's vector length (in za_context.vl).
”h]”hÌ)”}”(hŒ{The signal frame record for ZA always contains basic metadata, in particular
the thread's vector length (in za_context.vl).”h]”hŒ}The signal frame record for ZA always contains basic metadata, in particular
the threadâ€™s vector length (in za_context.vl).”…””}”(hj\  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KthjX  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒñThe ZA matrix may or may not be included in the record, depending on
the value of PSTATE.ZA.  The registers are present if and only if:
za_context.head.size >= ZA_SIG_CONTEXT_SIZE(sve_vq_from_vl(za_context.vl))
in which case PSTATE.ZA == 1.
”h]”hÌ)”}”(hŒðThe ZA matrix may or may not be included in the record, depending on
the value of PSTATE.ZA.  The registers are present if and only if:
za_context.head.size >= ZA_SIG_CONTEXT_SIZE(sve_vq_from_vl(za_context.vl))
in which case PSTATE.ZA == 1.”h]”hŒðThe ZA matrix may or may not be included in the record, depending on
the value of PSTATE.ZA.  The registers are present if and only if:
za_context.head.size >= ZA_SIG_CONTEXT_SIZE(sve_vq_from_vl(za_context.vl))
in which case PSTATE.ZA == 1.”…””}”(hjt  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kwhjp  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒšIf matrix data is present, the remainder of the record has a vl-dependent
size and layout.  Macros ZA_SIG_* are defined [1] to facilitate access to
them.
”h]”hÌ)”}”(hŒ™If matrix data is present, the remainder of the record has a vl-dependent
size and layout.  Macros ZA_SIG_* are defined [1] to facilitate access to
them.”h]”hŒ™If matrix data is present, the remainder of the record has a vl-dependent
size and layout.  Macros ZA_SIG_* are defined [1] to facilitate access to
them.”…””}”(hjŒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K|hjˆ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒfThe matrix is stored as a series of horizontal vectors in the same format as
is used for SVE vectors.
”h]”hÌ)”}”(hŒeThe matrix is stored as a series of horizontal vectors in the same format as
is used for SVE vectors.”h]”hŒeThe matrix is stored as a series of horizontal vectors in the same format as
is used for SVE vectors.”…””}”(hj¤  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K€hj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hX  If the ZA context is too big to fit in sigcontext.__reserved[], then extra
space is allocated on the stack, an extra_context record is written in
__reserved[] referencing this space.  za_context is then written in the
extra space.  Refer to [1] for further details about this mechanism.
”h]”hÌ)”}”(hX  If the ZA context is too big to fit in sigcontext.__reserved[], then extra
space is allocated on the stack, an extra_context record is written in
__reserved[] referencing this space.  za_context is then written in the
extra space.  Refer to [1] for further details about this mechanism.”h]”hX  If the ZA context is too big to fit in sigcontext.__reserved[], then extra
space is allocated on the stack, an extra_context record is written in
__reserved[] referencing this space.  za_context is then written in the
extra space.  Refer to [1] for further details about this mechanism.”…””}”(hj¼  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kƒhj¸  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒ[If ZTn is supported and PSTATE.ZA==1 then a signal frame record for ZTn will
be generated.
”h]”hÌ)”}”(hŒZIf ZTn is supported and PSTATE.ZA==1 then a signal frame record for ZTn will
be generated.”h]”hŒZIf ZTn is supported and PSTATE.ZA==1 then a signal frame record for ZTn will
be generated.”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KˆhjÐ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hX	  The signal record for ZTn has magic ZT_MAGIC (0x5a544e01) and consists of a
standard signal frame header followed by a struct zt_context specifying
the number of ZTn registers supported by the system, then zt_context.nregs
blocks of 64 bytes of data per register.

”h]”hÌ)”}”(hX  The signal record for ZTn has magic ZT_MAGIC (0x5a544e01) and consists of a
standard signal frame header followed by a struct zt_context specifying
the number of ZTn registers supported by the system, then zt_context.nregs
blocks of 64 bytes of data per register.”h]”hX  The signal record for ZTn has magic ZT_MAGIC (0x5a544e01) and consists of a
standard signal frame header followed by a struct zt_context specifying
the number of ZTn registers supported by the system, then zt_context.nregs
blocks of 64 bytes of data per register.”…””}”(hjì  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K‹hjè  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´Klhjü  h²hubeh}”(h]”Œsignal-handling”ah ]”h"]”Œ4. signal handling”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kjubh¶)”}”(hhh]”(h»)”}”(hŒ5.  Signal return”h]”hŒ5.  Signal return”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj  h²hh³hÊh´K’ubhÌ)”}”(hŒ%When returning from a signal handler:”h]”hŒ%When returning from a signal handler:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K”hj  h²hubj	  )”}”(hhh]”(j  )”}”(hŒ«If there is no za_context record in the signal frame, or if the record is
present but contains no register data as described in the previous section,
then ZA is disabled.
”h]”hÌ)”}”(hŒªIf there is no za_context record in the signal frame, or if the record is
present but contains no register data as described in the previous section,
then ZA is disabled.”h]”hŒªIf there is no za_context record in the signal frame, or if the record is
present but contains no register data as described in the previous section,
then ZA is disabled.”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K–hj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj-  h²hh³hÊh´Nubj  )”}”(hŒŽIf za_context is present in the signal frame and contains matrix data then
PSTATE.ZA is set to 1 and ZA is populated with the specified data.
”h]”hÌ)”}”(hŒIf za_context is present in the signal frame and contains matrix data then
PSTATE.ZA is set to 1 and ZA is populated with the specified data.”h]”hŒIf za_context is present in the signal frame and contains matrix data then
PSTATE.ZA is set to 1 and ZA is populated with the specified data.”…””}”(hjL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KšhjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj-  h²hh³hÊh´Nubj  )”}”(hŒ×The vector length cannot be changed via signal return.  If za_context.vl in
the signal frame does not match the current vector length, the signal return
attempt is treated as illegal, resulting in a forced SIGSEGV.
”h]”hÌ)”}”(hŒÖThe vector length cannot be changed via signal return.  If za_context.vl in
the signal frame does not match the current vector length, the signal return
attempt is treated as illegal, resulting in a forced SIGSEGV.”h]”hŒÖThe vector length cannot be changed via signal return.  If za_context.vl in
the signal frame does not match the current vector length, the signal return
attempt is treated as illegal, resulting in a forced SIGSEGV.”…””}”(hjd  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj`  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj-  h²hh³hÊh´Nubj  )”}”(hŒ‚If ZTn is not supported or PSTATE.ZA==0 then it is illegal to have a
signal frame record for ZTn, resulting in a forced SIGSEGV.

”h]”hÌ)”}”(hŒ€If ZTn is not supported or PSTATE.ZA==0 then it is illegal to have a
signal frame record for ZTn, resulting in a forced SIGSEGV.”h]”hŒ€If ZTn is not supported or PSTATE.ZA==0 then it is illegal to have a
signal frame record for ZTn, resulting in a forced SIGSEGV.”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¡hjx  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj-  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´K–hj  h²hubeh}”(h]”Œsignal-return”ah ]”h"]”Œ5. signal return”ah$]”h&]”uh1hµhh·h²hh³hÊh´K’ubh¶)”}”(hhh]”(h»)”}”(hŒ6.  prctl extensions”h]”hŒ6.  prctl extensions”…””}”(hj¡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjž  h²hh³hÊh´K¦ubhÌ)”}”(hŒSSome new prctl() calls are added to allow programs to manage the SME vector
length:”h]”hŒSSome new prctl() calls are added to allow programs to manage the SME vector
length:”…””}”(hj¯  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¨hjž  h²hubhÌ)”}”(hŒ'prctl(PR_SME_SET_VL, unsigned long arg)”h]”hŒ'prctl(PR_SME_SET_VL, unsigned long arg)”…””}”(hj½  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K«hjž  h²hubj  )”}”(hX“
  Sets the vector length of the calling thread and related flags, where
arg == vl | flags.  Other threads of the calling process are unaffected.

vl is the desired vector length, where sve_vl_valid(vl) must be true.

flags:

    PR_SME_VL_INHERIT

        Inherit the current vector length across execve().  Otherwise, the
        vector length is reset to the system default at execve().  (See
        Section 9.)

    PR_SME_SET_VL_ONEXEC

        Defer the requested vector length change until the next execve()
        performed by this thread.

        The effect is equivalent to implicit execution of the following
        call immediately after the next execve() (if any) by the thread:

            prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)

        This allows launching of a new program with a different vector
        length, while avoiding runtime side effects in the caller.

        Without PR_SME_SET_VL_ONEXEC, the requested change takes effect
        immediately.


Return value: a nonnegative on success, or a negative value on error:
    EINVAL: SME not supported, invalid vector length requested, or
        invalid flags.


On success:

* Either the calling thread's vector length or the deferred vector length
  to be applied at the next execve() by the thread (dependent on whether
  PR_SME_SET_VL_ONEXEC is present in arg), is set to the largest value
  supported by the system that is less than or equal to vl.  If vl ==
  SVE_VL_MAX, the value set will be the largest value supported by the
  system.

* Any previously outstanding deferred vector length change in the calling
  thread is cancelled.

* The returned value describes the resulting configuration, encoded as for
  PR_SME_GET_VL.  The vector length reported in this value is the new
  current vector length for this thread if PR_SME_SET_VL_ONEXEC was not
  present in arg; otherwise, the reported vector length is the deferred
  vector length that will be applied at the next execve() by the calling
  thread.

* Changing the vector length causes all of ZA, ZTn, P0..P15, FFR and all
  bits of Z0..Z31 except for Z0 bits [127:0] .. Z31 bits [127:0] to become
  unspecified, including both streaming and non-streaming SVE state.
  Calling PR_SME_SET_VL with vl equal to the thread's current vector
  length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
  does not constitute a change to the vector length for this purpose.

* Changing the vector length causes PSTATE.ZA to be cleared.
  Calling PR_SME_SET_VL with vl equal to the thread's current vector
  length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
  does not constitute a change to the vector length for this purpose.

”h]”(hÌ)”}”(hŒŽSets the vector length of the calling thread and related flags, where
arg == vl | flags.  Other threads of the calling process are unaffected.”h]”hŒŽSets the vector length of the calling thread and related flags, where
arg == vl | flags.  Other threads of the calling process are unaffected.”…””}”(hjÏ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K­hjË  ubhÌ)”}”(hŒEvl is the desired vector length, where sve_vl_valid(vl) must be true.”h]”hŒEvl is the desired vector length, where sve_vl_valid(vl) must be true.”…””}”(hjÝ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K°hjË  ubhÌ)”}”(hŒflags:”h]”hŒflags:”…””}”(hjë  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K²hjË  ubj  )”}”(hXÇ  PR_SME_VL_INHERIT

    Inherit the current vector length across execve().  Otherwise, the
    vector length is reset to the system default at execve().  (See
    Section 9.)

PR_SME_SET_VL_ONEXEC

    Defer the requested vector length change until the next execve()
    performed by this thread.

    The effect is equivalent to implicit execution of the following
    call immediately after the next execve() (if any) by the thread:

        prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)

    This allows launching of a new program with a different vector
    length, while avoiding runtime side effects in the caller.

    Without PR_SME_SET_VL_ONEXEC, the requested change takes effect
    immediately.

”h]”(hÌ)”}”(hŒPR_SME_VL_INHERIT”h]”hŒPR_SME_VL_INHERIT”…””}”(hjý  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K´hjù  ubj  )”}”(hŒInherit the current vector length across execve().  Otherwise, the
vector length is reset to the system default at execve().  (See
Section 9.)
”h]”hÌ)”}”(hŒŽInherit the current vector length across execve().  Otherwise, the
vector length is reset to the system default at execve().  (See
Section 9.)”h]”hŒŽInherit the current vector length across execve().  Otherwise, the
vector length is reset to the system default at execve().  (See
Section 9.)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¶hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´K¶hjù  ubhÌ)”}”(hŒPR_SME_SET_VL_ONEXEC”h]”hŒPR_SME_SET_VL_ONEXEC”…””}”(hj#  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kºhjù  ubj  )”}”(hXÞ  Defer the requested vector length change until the next execve()
performed by this thread.

The effect is equivalent to implicit execution of the following
call immediately after the next execve() (if any) by the thread:

    prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)

This allows launching of a new program with a different vector
length, while avoiding runtime side effects in the caller.

Without PR_SME_SET_VL_ONEXEC, the requested change takes effect
immediately.

”h]”(hÌ)”}”(hŒZDefer the requested vector length change until the next execve()
performed by this thread.”h]”hŒZDefer the requested vector length change until the next execve()
performed by this thread.”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¼hj1  ubhÌ)”}”(hŒ€The effect is equivalent to implicit execution of the following
call immediately after the next execve() (if any) by the thread:”h]”hŒ€The effect is equivalent to implicit execution of the following
call immediately after the next execve() (if any) by the thread:”…””}”(hjC  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¿hj1  ubj  )”}”(hŒ2prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)
”h]”hÌ)”}”(hŒ1prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)”h]”hŒ1prctl(PR_SME_SET_VL, arg & ~PR_SME_SET_VL_ONEXEC)”…””}”(hjU  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÂhjQ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´KÂhj1  ubhÌ)”}”(hŒyThis allows launching of a new program with a different vector
length, while avoiding runtime side effects in the caller.”h]”hŒyThis allows launching of a new program with a different vector
length, while avoiding runtime side effects in the caller.”…””}”(hji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÄhj1  ubhÌ)”}”(hŒLWithout PR_SME_SET_VL_ONEXEC, the requested change takes effect
immediately.”h]”hŒLWithout PR_SME_SET_VL_ONEXEC, the requested change takes effect
immediately.”…””}”(hjw  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÇhj1  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´K¼hjù  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´K´hjË  ubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒ™Return value: a nonnegative on success, or a negative value on error:
EINVAL: SME not supported, invalid vector length requested, or
    invalid flags.

”h]”(hŒterm”“”)”}”(hŒEReturn value: a nonnegative on success, or a negative value on error:”h]”hŒEReturn value: a nonnegative on success, or a negative value on error:”…””}”(hjž  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jœ  h³hÊh´KÎhj˜  ubhŒ
definition”“”)”}”(hhh]”j’  )”}”(hhh]”j—  )”}”(hŒOEINVAL: SME not supported, invalid vector length requested, or
invalid flags.

”h]”(j  )”}”(hŒ>EINVAL: SME not supported, invalid vector length requested, or”h]”hŒ>EINVAL: SME not supported, invalid vector length requested, or”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jœ  h³hÊh´KÎhj´  ubj­  )”}”(hhh]”hÌ)”}”(hŒinvalid flags.”h]”hŒinvalid flags.”…””}”(hjÉ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÍhjÆ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¬  hj´  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j–  h³hÊh´KÎhj±  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hj®  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¬  hj˜  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j–  h³hÊh´KÎhj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjË  ubhÌ)”}”(hŒOn success:”h]”hŒOn success:”…””}”(hjû  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÐhjË  ubj	  )”}”(hhh]”(j  )”}”(hXe  Either the calling thread's vector length or the deferred vector length
to be applied at the next execve() by the thread (dependent on whether
PR_SME_SET_VL_ONEXEC is present in arg), is set to the largest value
supported by the system that is less than or equal to vl.  If vl ==
SVE_VL_MAX, the value set will be the largest value supported by the
system.
”h]”hÌ)”}”(hXd  Either the calling thread's vector length or the deferred vector length
to be applied at the next execve() by the thread (dependent on whether
PR_SME_SET_VL_ONEXEC is present in arg), is set to the largest value
supported by the system that is less than or equal to vl.  If vl ==
SVE_VL_MAX, the value set will be the largest value supported by the
system.”h]”hXf  Either the calling threadâ€™s vector length or the deferred vector length
to be applied at the next execve() by the thread (dependent on whether
PR_SME_SET_VL_ONEXEC is present in arg), is set to the largest value
supported by the system that is less than or equal to vl.  If vl ==
SVE_VL_MAX, the value set will be the largest value supported by the
system.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÒhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubj  )”}”(hŒ]Any previously outstanding deferred vector length change in the calling
thread is cancelled.
”h]”hÌ)”}”(hŒ\Any previously outstanding deferred vector length change in the calling
thread is cancelled.”h]”hŒ\Any previously outstanding deferred vector length change in the calling
thread is cancelled.”…””}”(hj(  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÙhj$  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubj  )”}”(hXh  The returned value describes the resulting configuration, encoded as for
PR_SME_GET_VL.  The vector length reported in this value is the new
current vector length for this thread if PR_SME_SET_VL_ONEXEC was not
present in arg; otherwise, the reported vector length is the deferred
vector length that will be applied at the next execve() by the calling
thread.
”h]”hÌ)”}”(hXg  The returned value describes the resulting configuration, encoded as for
PR_SME_GET_VL.  The vector length reported in this value is the new
current vector length for this thread if PR_SME_SET_VL_ONEXEC was not
present in arg; otherwise, the reported vector length is the deferred
vector length that will be applied at the next execve() by the calling
thread.”h]”hXg  The returned value describes the resulting configuration, encoded as for
PR_SME_GET_VL.  The vector length reported in this value is the new
current vector length for this thread if PR_SME_SET_VL_ONEXEC was not
present in arg; otherwise, the reported vector length is the deferred
vector length that will be applied at the next execve() by the calling
thread.”…””}”(hj@  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÜhj<  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubj  )”}”(hXŸ  Changing the vector length causes all of ZA, ZTn, P0..P15, FFR and all
bits of Z0..Z31 except for Z0 bits [127:0] .. Z31 bits [127:0] to become
unspecified, including both streaming and non-streaming SVE state.
Calling PR_SME_SET_VL with vl equal to the thread's current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.
”h]”hÌ)”}”(hXž  Changing the vector length causes all of ZA, ZTn, P0..P15, FFR and all
bits of Z0..Z31 except for Z0 bits [127:0] .. Z31 bits [127:0] to become
unspecified, including both streaming and non-streaming SVE state.
Calling PR_SME_SET_VL with vl equal to the thread's current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.”h]”hX   Changing the vector length causes all of ZA, ZTn, P0..P15, FFR and all
bits of Z0..Z31 except for Z0 bits [127:0] .. Z31 bits [127:0] to become
unspecified, including both streaming and non-streaming SVE state.
Calling PR_SME_SET_VL with vl equal to the threadâ€™s current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.”…””}”(hjX  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KãhjT  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubj  )”}”(hX  Changing the vector length causes PSTATE.ZA to be cleared.
Calling PR_SME_SET_VL with vl equal to the thread's current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.

”h]”hÌ)”}”(hX  Changing the vector length causes PSTATE.ZA to be cleared.
Calling PR_SME_SET_VL with vl equal to the thread's current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.”h]”hX  Changing the vector length causes PSTATE.ZA to be cleared.
Calling PR_SME_SET_VL with vl equal to the threadâ€™s current vector
length, or calling PR_SME_SET_VL with the PR_SME_SET_VL_ONEXEC flag,
does not constitute a change to the vector length for this purpose.”…””}”(hjp  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kêhjl  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´KÒhjË  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´K­hjž  h²hubhÌ)”}”(hŒprctl(PR_SME_GET_VL)”h]”hŒprctl(PR_SME_GET_VL)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kðhjž  h²hubj  )”}”(hXD  Gets the vector length of the calling thread.

The following flag may be OR-ed into the result:

    PR_SME_VL_INHERIT

        Vector length will be inherited across execve().

There is no way to determine whether there is an outstanding deferred
vector length change (which would only normally be the case between a
fork() or vfork() and the corresponding execve() in typical use).

To extract the vector length from the result, bitwise and it with
PR_SME_VL_LEN_MASK.

Return value: a nonnegative value on success, or a negative value on error:
    EINVAL: SME not supported.

”h]”(hÌ)”}”(hŒ-Gets the vector length of the calling thread.”h]”hŒ-Gets the vector length of the calling thread.”…””}”(hj¢  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kòhjž  ubhÌ)”}”(hŒ0The following flag may be OR-ed into the result:”h]”hŒ0The following flag may be OR-ed into the result:”…””}”(hj°  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kôhjž  ubj  )”}”(hŒHPR_SME_VL_INHERIT

    Vector length will be inherited across execve().
”h]”(hÌ)”}”(hŒPR_SME_VL_INHERIT”h]”hŒPR_SME_VL_INHERIT”…””}”(hjÂ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Köhj¾  ubj  )”}”(hŒ1Vector length will be inherited across execve().
”h]”hÌ)”}”(hŒ0Vector length will be inherited across execve().”h]”hŒ0Vector length will be inherited across execve().”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KøhjÐ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Køhj¾  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Köhjž  ubhÌ)”}”(hŒÍThere is no way to determine whether there is an outstanding deferred
vector length change (which would only normally be the case between a
fork() or vfork() and the corresponding execve() in typical use).”h]”hŒÍThere is no way to determine whether there is an outstanding deferred
vector length change (which would only normally be the case between a
fork() or vfork() and the corresponding execve() in typical use).”…””}”(hjî  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kúhjž  ubhÌ)”}”(hŒUTo extract the vector length from the result, bitwise and it with
PR_SME_VL_LEN_MASK.”h]”hŒUTo extract the vector length from the result, bitwise and it with
PR_SME_VL_LEN_MASK.”…””}”(hjü  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kþhjž  ubj’  )”}”(hhh]”j—  )”}”(hŒhReturn value: a nonnegative value on success, or a negative value on error:
EINVAL: SME not supported.

”h]”(j  )”}”(hŒKReturn value: a nonnegative value on success, or a negative value on error:”h]”hŒKReturn value: a nonnegative value on success, or a negative value on error:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jœ  h³hÊh´Mhj  ubj­  )”}”(hhh]”hÌ)”}”(hŒEINVAL: SME not supported.”h]”hŒEINVAL: SME not supported.”…””}”(hj"  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¬  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j–  h³hÊh´Mhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjž  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Kòhjž  h²hubeh}”(h]”Œprctl-extensions”ah ]”h"]”Œ6. prctl extensions”ah$]”h&]”uh1hµhh·h²hh³hÊh´K¦ubh¶)”}”(hhh]”(h»)”}”(hŒ7.  ptrace extensions”h]”hŒ7.  ptrace extensions”…””}”(hjS  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjP  h²hh³hÊh´Mubj	  )”}”(hhh]”(j  )”}”(hŒ–A new regset NT_ARM_SSVE is defined for access to streaming mode SVE
state via PTRACE_GETREGSET and  PTRACE_SETREGSET, this is documented in
sve.rst.
”h]”hÌ)”}”(hŒ•A new regset NT_ARM_SSVE is defined for access to streaming mode SVE
state via PTRACE_GETREGSET and  PTRACE_SETREGSET, this is documented in
sve.rst.”h]”hŒ•A new regset NT_ARM_SSVE is defined for access to streaming mode SVE
state via PTRACE_GETREGSET and  PTRACE_SETREGSET, this is documented in
sve.rst.”…””}”(hjh  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hja  h²hh³hÊh´Nubj  )”}”(hŒA new regset NT_ARM_ZA is defined for ZA state for access to ZA state via
PTRACE_GETREGSET and PTRACE_SETREGSET.

Refer to [2] for definitions.
”h]”(hÌ)”}”(hŒpA new regset NT_ARM_ZA is defined for ZA state for access to ZA state via
PTRACE_GETREGSET and PTRACE_SETREGSET.”h]”hŒpA new regset NT_ARM_ZA is defined for ZA state for access to ZA state via
PTRACE_GETREGSET and PTRACE_SETREGSET.”…””}”(hj€  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj|  ubhÌ)”}”(hŒRefer to [2] for definitions.”h]”hŒRefer to [2] for definitions.”…””}”(hjŽ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj|  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hja  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´MhjP  h²hubhÌ)”}”(hŒ>The regset data starts with struct user_za_header, containing:”h]”hŒ>The regset data starts with struct user_za_header, containing:”…””}”(hj¨  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjP  h²hubj  )”}”(hXB  size

    Size of the complete regset, in bytes.
    This depends on vl and possibly on other things in the future.

    If a call to PTRACE_GETREGSET requests less data than the value of
    size, the caller can allocate a larger buffer and retry in order to
    read the complete regset.

max_size

    Maximum size in bytes that the regset can grow to for the target
    thread.  The regset won't grow bigger than this even if the target
    thread changes its vector length etc.

vl

    Target thread's current streaming vector length, in bytes.

max_vl

    Maximum possible streaming vector length for the target thread.

flags

    Zero or more of the following flags, which have the same
    meaning and behaviour as the corresponding PR_SET_VL_* flags:

        SME_PT_VL_INHERIT

        SME_PT_VL_ONEXEC (SETREGSET only).
”h]”(hÌ)”}”(hŒsize”h]”hŒsize”…””}”(hjº  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj¶  ubj  )”}”(hX  Size of the complete regset, in bytes.
This depends on vl and possibly on other things in the future.

If a call to PTRACE_GETREGSET requests less data than the value of
size, the caller can allocate a larger buffer and retry in order to
read the complete regset.
”h]”(hÌ)”}”(hŒeSize of the complete regset, in bytes.
This depends on vl and possibly on other things in the future.”h]”hŒeSize of the complete regset, in bytes.
This depends on vl and possibly on other things in the future.”…””}”(hjÌ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjÈ  ubhÌ)”}”(hŒ If a call to PTRACE_GETREGSET requests less data than the value of
size, the caller can allocate a larger buffer and retry in order to
read the complete regset.”h]”hŒ If a call to PTRACE_GETREGSET requests less data than the value of
size, the caller can allocate a larger buffer and retry in order to
read the complete regset.”…””}”(hjÚ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjÈ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mhj¶  ubhÌ)”}”(hŒmax_size”h]”hŒmax_size”…””}”(hjî  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj¶  ubj  )”}”(hŒªMaximum size in bytes that the regset can grow to for the target
thread.  The regset won't grow bigger than this even if the target
thread changes its vector length etc.
”h]”hÌ)”}”(hŒ©Maximum size in bytes that the regset can grow to for the target
thread.  The regset won't grow bigger than this even if the target
thread changes its vector length etc.”h]”hŒ«Maximum size in bytes that the regset can grow to for the target
thread.  The regset wonâ€™t grow bigger than this even if the target
thread changes its vector length etc.”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjü  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´Mhj¶  ubhÌ)”}”(hŒvl”h]”hŒvl”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M"hj¶  ubj  )”}”(hŒ;Target thread's current streaming vector length, in bytes.
”h]”hÌ)”}”(hŒ:Target thread's current streaming vector length, in bytes.”h]”hŒ<Target threadâ€™s current streaming vector length, in bytes.”…””}”(hj&  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M$hj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M$hj¶  ubhÌ)”}”(hŒmax_vl”h]”hŒmax_vl”…””}”(hj:  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M&hj¶  ubj  )”}”(hŒ@Maximum possible streaming vector length for the target thread.
”h]”hÌ)”}”(hŒ?Maximum possible streaming vector length for the target thread.”h]”hŒ?Maximum possible streaming vector length for the target thread.”…””}”(hjL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M(hjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M(hj¶  ubhÌ)”}”(hŒflags”h]”hŒflags”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M*hj¶  ubj  )”}”(hŒ¶Zero or more of the following flags, which have the same
meaning and behaviour as the corresponding PR_SET_VL_* flags:

    SME_PT_VL_INHERIT

    SME_PT_VL_ONEXEC (SETREGSET only).
”h]”(hÌ)”}”(hŒvZero or more of the following flags, which have the same
meaning and behaviour as the corresponding PR_SET_VL_* flags:”h]”hŒvZero or more of the following flags, which have the same
meaning and behaviour as the corresponding PR_SET_VL_* flags:”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M,hjn  ubj  )”}”(hŒ6SME_PT_VL_INHERIT

SME_PT_VL_ONEXEC (SETREGSET only).
”h]”(hÌ)”}”(hŒSME_PT_VL_INHERIT”h]”hŒSME_PT_VL_INHERIT”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M/hj€  ubhÌ)”}”(hŒ"SME_PT_VL_ONEXEC (SETREGSET only).”h]”hŒ"SME_PT_VL_ONEXEC (SETREGSET only).”…””}”(hj’  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M1hj€  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M/hjn  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M,hj¶  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´MhjP  h²hubj	  )”}”(hhh]”(j  )”}”(hX  The effects of changing the vector length and/or flags are equivalent to
those documented for PR_SME_SET_VL.

The caller must make a further GETREGSET call if it needs to know what VL is
actually set by SETREGSET, unless is it known in advance that the requested
VL is supported.
”h]”(hÌ)”}”(hŒlThe effects of changing the vector length and/or flags are equivalent to
those documented for PR_SME_SET_VL.”h]”hŒlThe effects of changing the vector length and/or flags are equivalent to
those documented for PR_SME_SET_VL.”…””}”(hj¹  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M3hjµ  ubhÌ)”}”(hŒ©The caller must make a further GETREGSET call if it needs to know what VL is
actually set by SETREGSET, unless is it known in advance that the requested
VL is supported.”h]”hŒ©The caller must make a further GETREGSET call if it needs to know what VL is
actually set by SETREGSET, unless is it known in advance that the requested
VL is supported.”…””}”(hjÇ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M6hjµ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒˆThe size and layout of the payload depends on the header fields.  The
ZA_PT_ZA*() macros are provided to facilitate access to the data.
”h]”hÌ)”}”(hŒ‡The size and layout of the payload depends on the header fields.  The
ZA_PT_ZA*() macros are provided to facilitate access to the data.”h]”hŒ‡The size and layout of the payload depends on the header fields.  The
ZA_PT_ZA*() macros are provided to facilitate access to the data.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M:hjÛ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hX   In either case, for SETREGSET it is permissible to omit the payload, in which
case the vector length and flags are changed and PSTATE.ZA is set to 0
(along with any consequences of those changes).  If a payload is provided
then PSTATE.ZA will be set to 1.
”h]”hÌ)”}”(hŒÿIn either case, for SETREGSET it is permissible to omit the payload, in which
case the vector length and flags are changed and PSTATE.ZA is set to 0
(along with any consequences of those changes).  If a payload is provided
then PSTATE.ZA will be set to 1.”h]”hŒÿIn either case, for SETREGSET it is permissible to omit the payload, in which
case the vector length and flags are changed and PSTATE.ZA is set to 0
(along with any consequences of those changes).  If a payload is provided
then PSTATE.ZA will be set to 1.”…””}”(hj÷  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M=hjó  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hXW  For SETREGSET, if the requested VL is not supported, the effect will be the
same as if the payload were omitted, except that an EIO error is reported.
No attempt is made to translate the payload data to the correct layout
for the vector length actually set.  It is up to the caller to translate the
payload layout for the actual VL and retry.
”h]”hÌ)”}”(hXV  For SETREGSET, if the requested VL is not supported, the effect will be the
same as if the payload were omitted, except that an EIO error is reported.
No attempt is made to translate the payload data to the correct layout
for the vector length actually set.  It is up to the caller to translate the
payload layout for the actual VL and retry.”h]”hXV  For SETREGSET, if the requested VL is not supported, the effect will be the
same as if the payload were omitted, except that an EIO error is reported.
No attempt is made to translate the payload data to the correct layout
for the vector length actually set.  It is up to the caller to translate the
payload layout for the actual VL and retry.”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MBhj	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒDThe effect of writing a partial, incomplete payload is unspecified.
”h]”hÌ)”}”(hŒCThe effect of writing a partial, incomplete payload is unspecified.”h]”hŒCThe effect of writing a partial, incomplete payload is unspecified.”…””}”(hj'	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MHhj#	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒeA new regset NT_ARM_ZT is defined for access to ZTn state via
PTRACE_GETREGSET and PTRACE_SETREGSET.
”h]”hÌ)”}”(hŒdA new regset NT_ARM_ZT is defined for access to ZTn state via
PTRACE_GETREGSET and PTRACE_SETREGSET.”h]”hŒdA new regset NT_ARM_ZT is defined for access to ZTn state via
PTRACE_GETREGSET and PTRACE_SETREGSET.”…””}”(hj?	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MJhj;	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒ<The NT_ARM_ZT regset consists of a single 512 bit register.
”h]”hÌ)”}”(hŒ;The NT_ARM_ZT regset consists of a single 512 bit register.”h]”hŒ;The NT_ARM_ZT regset consists of a single 512 bit register.”…””}”(hjW	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MMhjS	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒGWhen PSTATE.ZA==0 reads of NT_ARM_ZT will report all bits of ZTn as 0.
”h]”hÌ)”}”(hŒFWhen PSTATE.ZA==0 reads of NT_ARM_ZT will report all bits of ZTn as 0.”h]”hŒFWhen PSTATE.ZA==0 reads of NT_ARM_ZT will report all bits of ZTn as 0.”…””}”(hjo	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MOhjk	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒ-Writes to NT_ARM_ZT will set PSTATE.ZA to 1.
”h]”hÌ)”}”(hŒ,Writes to NT_ARM_ZT will set PSTATE.ZA to 1.”h]”hŒ,Writes to NT_ARM_ZT will set PSTATE.ZA to 1.”…””}”(hj‡	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MQhjƒ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubj  )”}”(hŒ¼If any register data is provided along with SME_PT_VL_ONEXEC then the
registers data will be interpreted with the current vector length, not
the vector length configured for use on exec.

”h]”hÌ)”}”(hŒºIf any register data is provided along with SME_PT_VL_ONEXEC then the
registers data will be interpreted with the current vector length, not
the vector length configured for use on exec.”h]”hŒºIf any register data is provided along with SME_PT_VL_ONEXEC then the
registers data will be interpreted with the current vector length, not
the vector length configured for use on exec.”…””}”(hjŸ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MShj›	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj²  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´M3hjP  h²hubeh}”(h]”Œptrace-extensions”ah ]”h"]”Œ7. ptrace extensions”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mubh¶)”}”(hhh]”(h»)”}”(hŒ8.  ELF coredump extensions”h]”hŒ8.  ELF coredump extensions”…””}”(hjÄ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÁ	  h²hh³hÊh´MYubj	  )”}”(hhh]”(j  )”}”(hX  NT_ARM_SSVE notes will be added to each coredump for
each thread of the dumped process.  The contents will be equivalent to the
data that would have been read if a PTRACE_GETREGSET of the corresponding
type were executed for each thread when the coredump was generated.
”h]”hÌ)”}”(hX  NT_ARM_SSVE notes will be added to each coredump for
each thread of the dumped process.  The contents will be equivalent to the
data that would have been read if a PTRACE_GETREGSET of the corresponding
type were executed for each thread when the coredump was generated.”h]”hX  NT_ARM_SSVE notes will be added to each coredump for
each thread of the dumped process.  The contents will be equivalent to the
data that would have been read if a PTRACE_GETREGSET of the corresponding
type were executed for each thread when the coredump was generated.”…””}”(hjÙ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M[hjÕ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÒ	  h²hh³hÊh´Nubj  )”}”(hX   A NT_ARM_ZA note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZA were executed for each thread
when the coredump was generated.
”h]”hÌ)”}”(hŒÿA NT_ARM_ZA note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZA were executed for each thread
when the coredump was generated.”h]”hŒÿA NT_ARM_ZA note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZA were executed for each thread
when the coredump was generated.”…””}”(hjñ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M`hjí	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÒ	  h²hh³hÊh´Nubj  )”}”(hX   A NT_ARM_ZT note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZT were executed for each thread
when the coredump was generated.
”h]”hÌ)”}”(hŒÿA NT_ARM_ZT note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZT were executed for each thread
when the coredump was generated.”h]”hŒÿA NT_ARM_ZT note will be added to each coredump for each thread of the
dumped process.  The contents will be equivalent to the data that would have
been read if a PTRACE_GETREGSET of NT_ARM_ZT were executed for each thread
when the coredump was generated.”…””}”(hj	
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mehj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÒ	  h²hh³hÊh´Nubj  )”}”(hŒ·The NT_ARM_TLS note will be extended to two registers, the second register
will contain TPIDR2_EL0 on systems that support SME and will be read as
zero with writes ignored otherwise.
”h]”hÌ)”}”(hŒ¶The NT_ARM_TLS note will be extended to two registers, the second register
will contain TPIDR2_EL0 on systems that support SME and will be read as
zero with writes ignored otherwise.”h]”hŒ¶The NT_ARM_TLS note will be extended to two registers, the second register
will contain TPIDR2_EL0 on systems that support SME and will be read as
zero with writes ignored otherwise.”…””}”(hj!
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mjhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÒ	  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´M[hjÁ	  h²hubeh}”(h]”Œelf-coredump-extensions”ah ]”h"]”Œ8. elf coredump extensions”ah$]”h&]”uh1hµhh·h²hh³hÊh´MYubh¶)”}”(hhh]”(h»)”}”(hŒ 9.  System runtime configuration”h]”hŒ 9.  System runtime configuration”…””}”(hjF
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjC
  h²hh³hÊh´Moubj	  )”}”(hhh]”j  )”}”(hŒÌTo mitigate the ABI impact of expansion of the signal frame, a policy
mechanism is provided for administrators, distro maintainers and developers
to set the default vector length for userspace processes:
”h]”hÌ)”}”(hŒËTo mitigate the ABI impact of expansion of the signal frame, a policy
mechanism is provided for administrators, distro maintainers and developers
to set the default vector length for userspace processes:”h]”hŒËTo mitigate the ABI impact of expansion of the signal frame, a policy
mechanism is provided for administrators, distro maintainers and developers
to set the default vector length for userspace processes:”…””}”(hj[
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MqhjW
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjT
  h²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´MqhjC
  h²hubhÌ)”}”(hŒ'/proc/sys/abi/sme_default_vector_length”h]”hŒ'/proc/sys/abi/sme_default_vector_length”…””}”(hju
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MuhjC
  h²hubj  )”}”(hX<  Writing the text representation of an integer to this file sets the system
default vector length to the specified value rounded to a supported value
using the same rules as for setting vector length via PR_SME_SET_VL.

The result can be determined by reopening the file and reading its
contents.

At boot, the default vector length is initially set to 32 or the maximum
supported vector length, whichever is smaller and supported.  This
determines the initial vector length of the init process (PID 1).

Reading this file returns the current system default vector length.
”h]”(hÌ)”}”(hŒÙWriting the text representation of an integer to this file sets the system
default vector length to the specified value rounded to a supported value
using the same rules as for setting vector length via PR_SME_SET_VL.”h]”hŒÙWriting the text representation of an integer to this file sets the system
default vector length to the specified value rounded to a supported value
using the same rules as for setting vector length via PR_SME_SET_VL.”…””}”(hj‡
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mwhjƒ
  ubhÌ)”}”(hŒLThe result can be determined by reopening the file and reading its
contents.”h]”hŒLThe result can be determined by reopening the file and reading its
contents.”…””}”(hj•
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M{hjƒ
  ubhÌ)”}”(hŒÍAt boot, the default vector length is initially set to 32 or the maximum
supported vector length, whichever is smaller and supported.  This
determines the initial vector length of the init process (PID 1).”h]”hŒÍAt boot, the default vector length is initially set to 32 or the maximum
supported vector length, whichever is smaller and supported.  This
determines the initial vector length of the init process (PID 1).”…””}”(hj£
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M~hjƒ
  ubhÌ)”}”(hŒCReading this file returns the current system default vector length.”h]”hŒCReading this file returns the current system default vector length.”…””}”(hj±
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”•™=      h&]”uh1hËh³hÊh´M‚hjƒ
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´MwhjC
  h²hubj	  )”}”(hhh]”(j  )”}”(hXO  At every execve() call, the new vector length of the new process is set to
the system default vector length, unless

  * PR_SME_VL_INHERIT (or equivalently SME_PT_VL_INHERIT) is set for the
    calling thread, or

  * a deferred vector length change is pending, established via the
    PR_SME_SET_VL_ONEXEC flag (or SME_PT_VL_ONEXEC).
”h]”(hÌ)”}”(hŒsAt every execve() call, the new vector length of the new process is set to
the system default vector length, unless”h]”hŒsAt every execve() call, the new vector length of the new process is set to
the system default vector length, unless”…””}”(hjÌ
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M„hjÈ
  ubj  )”}”(hŒÒ* PR_SME_VL_INHERIT (or equivalently SME_PT_VL_INHERIT) is set for the
  calling thread, or

* a deferred vector length change is pending, established via the
  PR_SME_SET_VL_ONEXEC flag (or SME_PT_VL_ONEXEC).
”h]”j	  )”}”(hhh]”(j  )”}”(hŒXPR_SME_VL_INHERIT (or equivalently SME_PT_VL_INHERIT) is set for the
calling thread, or
”h]”hÌ)”}”(hŒWPR_SME_VL_INHERIT (or equivalently SME_PT_VL_INHERIT) is set for the
calling thread, or”h]”hŒWPR_SME_VL_INHERIT (or equivalently SME_PT_VL_INHERIT) is set for the
calling thread, or”…””}”(hjå
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M‡hjá
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÞ
  ubj  )”}”(hŒqa deferred vector length change is pending, established via the
PR_SME_SET_VL_ONEXEC flag (or SME_PT_VL_ONEXEC).
”h]”hÌ)”}”(hŒpa deferred vector length change is pending, established via the
PR_SME_SET_VL_ONEXEC flag (or SME_PT_VL_ONEXEC).”h]”hŒpa deferred vector length change is pending, established via the
PR_SME_SET_VL_ONEXEC flag (or SME_PT_VL_ONEXEC).”…””}”(hjý
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MŠhjù
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÞ
  ubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´M‡hjÚ
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÊh´M‡hjÈ
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÅ
  h²hh³hÊh´Nubj  )”}”(hŒ•Modifying the system default vector length does not affect the vector length
of any existing process or thread that does not make an execve() call.

”h]”hÌ)”}”(hŒ“Modifying the system default vector length does not affect the vector length
of any existing process or thread that does not make an execve() call.”h]”hŒ“Modifying the system default vector length does not affect the vector length
of any existing process or thread that does not make an execve() call.”…””}”(hj'  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj#  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÅ
  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´M„hjC
  h²hubh¶)”}”(hhh]”(h»)”}”(hŒ1Appendix A.  SME programmer's model (informative)”h]”hŒ3Appendix A.  SME programmerâ€™s model (informative)”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjA  h²hh³hÊh´M’ubhÌ)”}”(hŒŽThis section provides a minimal description of the additions made by SME to the
ARMv8-A programmer's model that are relevant to this document.”h]”hŒThis section provides a minimal description of the additions made by SME to the
ARMv8-A programmerâ€™s model that are relevant to this document.”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M”hjA  h²hubhÌ)”}”(hŒyNote: This section is for information only and not intended to be complete or
to replace any architectural specification.”h]”hŒyNote: This section is for information only and not intended to be complete or
to replace any architectural specification.”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M—hjA  h²hubeh}”(h]”Œ-appendix-a-sme-programmer-s-model-informative”ah ]”h"]”Œ0appendix a. sme programmer's model (informative)”ah$]”h&]”uh1hµhjC
  h²hh³hÊh´M’ubeh}”(h]”Œsystem-runtime-configuration”ah ]”h"]”Œ9. system runtime configuration”ah$]”h&]”uh1hµhh·h²hh³hÊh´Moubh¶)”}”(hhh]”(h»)”}”(hŒA.1.  Registers”h]”hŒA.1.  Registers”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj~  h²hh³hÊh´M›ubhÌ)”}”(hŒ%In A64 state, SME adds the following:”h]”hŒ%In A64 state, SME adds the following:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj~  h²hubj	  )”}”(hhh]”(j  )”}”(hX2  A new mode, streaming mode, in which a subset of the normal FPSIMD and SVE
features are available.  When supported EL0 software may enter and leave
streaming mode at any time.

For best system performance it is strongly encouraged for software to enable
streaming mode only when it is actively being used.
”h]”(hÌ)”}”(hŒ¯A new mode, streaming mode, in which a subset of the normal FPSIMD and SVE
features are available.  When supported EL0 software may enter and leave
streaming mode at any time.”h]”hŒ¯A new mode, streaming mode, in which a subset of the normal FPSIMD and SVE
features are available.  When supported EL0 software may enter and leave
streaming mode at any time.”…””}”(hj¤  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MŸhj   ubhÌ)”}”(hŒ€For best system performance it is strongly encouraged for software to enable
streaming mode only when it is actively being used.”h]”hŒ€For best system performance it is strongly encouraged for software to enable
streaming mode only when it is actively being used.”…””}”(hj²  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M£hj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hX‰  A new vector length controlling the size of ZA and the Z registers when in
streaming mode, separately to the vector length used for SVE when not in
streaming mode.  There is no requirement that either the currently selected
vector length or the set of vector lengths supported for the two modes in
a given system have any relationship.  The streaming mode vector length
is referred to as SVL.
”h]”hÌ)”}”(hXˆ  A new vector length controlling the size of ZA and the Z registers when in
streaming mode, separately to the vector length used for SVE when not in
streaming mode.  There is no requirement that either the currently selected
vector length or the set of vector lengths supported for the two modes in
a given system have any relationship.  The streaming mode vector length
is referred to as SVL.”h]”hXˆ  A new vector length controlling the size of ZA and the Z registers when in
streaming mode, separately to the vector length used for SVE when not in
streaming mode.  There is no requirement that either the currently selected
vector length or the set of vector lengths supported for the two modes in
a given system have any relationship.  The streaming mode vector length
is referred to as SVL.”…””}”(hjÊ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¦hjÆ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hXM  A new ZA matrix register.  This is a square matrix of SVLxSVL bits.  Most
operations on ZA require that streaming mode be enabled but ZA can be
enabled without streaming mode in order to load, save and retain data.

For best system performance it is strongly encouraged for software to enable
ZA only when it is actively being used.
”h]”(hÌ)”}”(hŒÖA new ZA matrix register.  This is a square matrix of SVLxSVL bits.  Most
operations on ZA require that streaming mode be enabled but ZA can be
enabled without streaming mode in order to load, save and retain data.”h]”hŒÖA new ZA matrix register.  This is a square matrix of SVLxSVL bits.  Most
operations on ZA require that streaming mode be enabled but ZA can be
enabled without streaming mode in order to load, save and retain data.”…””}”(hjâ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M­hjÞ  ubhÌ)”}”(hŒtFor best system performance it is strongly encouraged for software to enable
ZA only when it is actively being used.”h]”hŒtFor best system performance it is strongly encouraged for software to enable
ZA only when it is actively being used.”…””}”(hjð  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M±hjÞ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hŒŽA new ZT0 register is introduced when SME2 is present. This is a 512 bit
register which is accessible when PSTATE.ZA is set, as ZA itself is.
”h]”hÌ)”}”(hŒA new ZT0 register is introduced when SME2 is present. This is a 512 bit
register which is accessible when PSTATE.ZA is set, as ZA itself is.”h]”hŒA new ZT0 register is introduced when SME2 is present. This is a 512 bit
register which is accessible when PSTATE.ZA is set, as ZA itself is.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M´hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³hÊh´Nubj  )”}”(hXR  Two new 1 bit fields in PSTATE which may be controlled via the SMSTART and
SMSTOP instructions or by access to the SVCR system register:

* PSTATE.ZA, if this is 1 then the ZA matrix is accessible and has valid
  data while if it is 0 then ZA can not be accessed.  When PSTATE.ZA is
  changed from 0 to 1 all bits in ZA are cleared.

* PSTATE.SM, if this is 1 then the PE is in streaming mode.  When the value
  of PSTATE.SM is changed then it is implementation defined if the subset
  of the floating point register bits valid in both modes may be retained.
  Any other bits will be cleared.

”h]”(hÌ)”}”(hŒˆTwo new 1 bit fields in PSTATE which may be controlled via the SMSTART and
SMSTOP instructions or by access to the SVCR system register:”h]”hŒˆTwo new 1 bit fields in PSTATE which may be controlled via the SMSTART and
SMSTOP instructions or by access to the SVCR system register:”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M·hj  ubj	  )”}”(hhh]”(j  )”}”(hŒ½PSTATE.ZA, if this is 1 then the ZA matrix is accessible and has valid
data while if it is 0 then ZA can not be accessed.  When PSTATE.ZA is
changed from 0 to 1 all bits in ZA are cleared.
”h]”hÌ)”}”(hŒ¼PSTATE.ZA, if this is 1 then the ZA matrix is accessible and has valid
data while if it is 0 then ZA can not be accessed.  When PSTATE.ZA is
changed from 0 to 1 all bits in ZA are cleared.”h]”hŒ¼PSTATE.ZA, if this is 1 then the ZA matrix is accessible and has valid
data while if it is 0 then ZA can not be accessed.  When PSTATE.ZA is
changed from 0 to 1 all bits in ZA are cleared.”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mºhj1  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj.  ubj  )”}”(hŒüPSTATE.SM, if this is 1 then the PE is in streaming mode.  When the value
of PSTATE.SM is changed then it is implementation defined if the subset
of the floating point register bits valid in both modes may be retained.
Any other bits will be cleared.

”h]”hÌ)”}”(hŒúPSTATE.SM, if this is 1 then the PE is in streaming mode.  When the value
of PSTATE.SM is changed then it is implementation defined if the subset
of the floating point register bits valid in both modes may be retained.
Any other bits will be cleared.”h]”hŒúPSTATE.SM, if this is 1 then the PE is in streaming mode.  When the value
of PSTATE.SM is changed then it is implementation defined if the subset
of the floating point register bits valid in both modes may be retained.
Any other bits will be cleared.”…””}”(hjM  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¾hjI  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj.  ubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´Mºhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j1  j2  uh1j  h³hÊh´MŸhj~  h²hubh¶)”}”(hhh]”(h»)”}”(hŒ
References”h]”hŒ
References”…””}”(hjv  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjs  h²hh³hÊh´MÅubj’  )”}”(hhh]”(j—  )”}”(hŒR[1] arch/arm64/include/uapi/asm/sigcontext.h
AArch64 Linux signal ABI definitions
”h]”(j  )”}”(hŒ,[1] arch/arm64/include/uapi/asm/sigcontext.h”h]”hŒ,[1] arch/arm64/include/uapi/asm/sigcontext.h”…””}”(hj‹  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jœ  h³hÊh´MÈhj‡  ubj­  )”}”(hhh]”hÌ)”}”(hŒ$AArch64 Linux signal ABI definitions”h]”hŒ$AArch64 Linux signal ABI definitions”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÈhj™  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¬  hj‡  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j–  h³hÊh´MÈhj„  ubj—  )”}”(hŒN[2] arch/arm64/include/uapi/asm/ptrace.h
AArch64 Linux ptrace ABI definitions
”h]”(j  )”}”(hŒ([2] arch/arm64/include/uapi/asm/ptrace.h”h]”hŒ([2] arch/arm64/include/uapi/asm/ptrace.h”…””}”(hjº  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jœ  h³hÊh´MËhj¶  ubj­  )”}”(hhh]”hÌ)”}”(hŒ$AArch64 Linux ptrace ABI definitions”h]”hŒ$AArch64 Linux ptrace ABI definitions”…””}”(hjË  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MËhjÈ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¬  hj¶  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j–  h³hÊh´MËhj„  h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j‘  hjs  h²hh³hÊh´NubhÌ)”}”(hŒ6[3] Documentation/arch/arm64/cpu-feature-registers.rst”h]”hŒ6[3] Documentation/arch/arm64/cpu-feature-registers.rst”…””}”(hjë  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÍhjs  h²hubeh}”(h]”Œ
references”ah ]”h"]”Œ
references”ah$]”h&]”uh1hµhj~  h²hh³hÊh´MÅubeh}”(h]”Œa-1-registers”ah ]”h"]”Œa.1. registers”ah$]”h&]”uh1hµhh·h²hh³hÊh´M›ubeh}”(h]”Œ3scalable-matrix-extension-support-for-aarch64-linux”ah ]”h"]”Œ3scalable matrix extension support for aarch64 linux”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j4  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j  j  j8  j5  j_  j\  jù  jö  j  j  j›  j˜  jM  jJ  j¾	  j»	  j@
  j=
  j{  jx  js  jp  j  j  jþ  jû  uŒ	nametypes”}”(j  ‰j8  ‰j_  ‰jù  ‰j  ‰j›  ‰jM  ‰j¾	  ‰j@
  ‰j{  ‰js  ‰j  ‰jþ  ‰uh}”(j  h·j5  h÷j\  j;  jö  jb  j  jü  j˜  j  jJ  jž  j»	  jP  j=
  jÁ	  jx  jC
  jp  jA  j  j~  jû  js  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.