€•±š      Œ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/riscv/vector”Œ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/riscv/vector”Œ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/riscv/vector”Œ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/riscv/vector”Œ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/riscv/vector”Œ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/riscv/vector”Œ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Œcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ?/var/lib/git/docbuild/linux/Documentation/arch/riscv/vector.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ)Vector Extension Support for RISC-V Linux”h]”hŒ)Vector Extension Support for RISC-V Linux”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒ‡This document briefly outlines the interface provided to userspace by Linux in
order to support the use of the RISC-V Vector Extension.”h]”hŒ‡This document briefly outlines the interface provided to userspace by Linux in
order to support the use of the RISC-V Vector Extension.”…””}”(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.  prctl() Interface”h]”hŒ1.  prctl() Interface”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÙhžhhŸh³h KubhÊ)”}”(hXÈ  Two new prctl() calls are added to allow programs to manage the enablement
status for the use of Vector in userspace. The intended usage guideline for
these interfaces is to give init systems a way to modify the availability of V
for processes running under its domain. Calling these interfaces is not
recommended in libraries routines because libraries should not override policies
configured from the parent process. Also, users must note that these interfaces
are not portable to non-Linux, nor non-RISC-V environments, so it is discourage
to use in a portable code. To get the availability of V in an ELF program,
please read :c:macro:`COMPAT_HWCAP_ISA_V` bit of :c:macro:`ELF_HWCAP` in the
auxiliary vector.”h]”(hXv  Two new prctl() calls are added to allow programs to manage the enablement
status for the use of Vector in userspace. The intended usage guideline for
these interfaces is to give init systems a way to modify the availability of V
for processes running under its domain. Calling these interfaces is not
recommended in libraries routines because libraries should not override policies
configured from the parent process. Also, users must note that these interfaces
are not portable to non-Linux, nor non-RISC-V environments, so it is discourage
to use in a portable code. To get the availability of V in an ELF program,
please read ”…””}”(hhêhžhhŸNh Nubh)”}”(hŒ:c:macro:`COMPAT_HWCAP_ISA_V`”h]”hŒliteral”“”)”}”(hhôh]”hŒCOMPAT_HWCAP_ISA_V”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”(Œxref”Œc”Œc-macro”eh"]”h$]”h&]”uh1höhhòubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œarch/riscv/vector”Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰Œ	reftarget”ŒCOMPAT_HWCAP_ISA_V”uh1hhŸh³h KhhêubhŒ bit of ”…””}”(hhêhžhhŸNh Nubh)”}”(hŒ:c:macro:`ELF_HWCAP`”h]”h÷)”}”(hj  h]”hŒ	ELF_HWCAP”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhj  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  Œ	ELF_HWCAP”uh1hhŸh³h KhhêubhŒ in the
auxiliary vector.”…””}”(hhêhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hX€  prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg)

  Sets the Vector enablement status of the calling thread, where the control
  argument consists of two 2-bit enablement statuses and a bit for inheritance
  mode. Other threads of the calling process are unaffected.

  Enablement status is a tri-state value each occupying 2-bit of space in
  the control argument:

  * :c:macro:`PR_RISCV_V_VSTATE_CTRL_DEFAULT`: Use the system-wide default
    enablement status on execve(). The system-wide default setting can be
    controlled via sysctl interface (see sysctl section below).

  * :c:macro:`PR_RISCV_V_VSTATE_CTRL_ON`: Allow Vector to be run for the
    thread.

  * :c:macro:`PR_RISCV_V_VSTATE_CTRL_OFF`: Disallow Vector. Executing Vector
    instructions under such condition will trap and casuse the termination of the thread.

  arg: The control argument is a 5-bit value consisting of 3 parts, and
  accessed by 3 masks respectively.

  The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK,
  PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT
  represents bit[1:0], bit[3:2], and bit[4]. bit[1:0] accounts for the
  enablement status of current thread, and the setting at bit[3:2] takes place
  at next execve(). bit[4] defines the inheritance mode of the setting in
  bit[3:2].

      * :c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`: bit[1:0]: Account for the
        Vector enablement status for the calling thread. The calling thread is
        not able to turn off Vector once it has been enabled. The prctl() call
        fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
        but the current enablement status is not off. Setting
        PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
        the original enablement status.

      * :c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`: bit[3:2]: Account for the
        Vector enablement setting for the calling thread at the next execve()
        system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
        then the enablement status will be decided by the system-wide
        enablement status when execve() happen.

      * :c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`: bit[4]: the inheritance
        mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
        is set then the following execve() will not clear the setting in both
        PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
        This setting persists across changes in the system-wide default value.

  Return value:
      * 0 on success;
      * EINVAL: Vector not supported, invalid enablement status for current or
        next mask;
      * EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
        was enabled for the calling thread.

  On success:
      * A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
        immediately. The enablement status specified in
        PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
        all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
        set.
      * Every successful call overwrites a previous setting for the calling
        thread.
”h]”(hÊ)”}”(hŒ0prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg)”h]”hŒ0prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg)”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjK  ubhŒblock_quote”“”)”}”(hXè  Sets the Vector enablement status of the calling thread, where the control
argument consists of two 2-bit enablement statuses and a bit for inheritance
mode. Other threads of the calling process are unaffected.

Enablement status is a tri-state value each occupying 2-bit of space in
the control argument:

* :c:macro:`PR_RISCV_V_VSTATE_CTRL_DEFAULT`: Use the system-wide default
  enablement status on execve(). The system-wide default setting can be
  controlled via sysctl interface (see sysctl section below).

* :c:macro:`PR_RISCV_V_VSTATE_CTRL_ON`: Allow Vector to be run for the
  thread.

* :c:macro:`PR_RISCV_V_VSTATE_CTRL_OFF`: Disallow Vector. Executing Vector
  instructions under such condition will trap and casuse the termination of the thread.

arg: The control argument is a 5-bit value consisting of 3 parts, and
accessed by 3 masks respectively.

The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK,
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT
represents bit[1:0], bit[3:2], and bit[4]. bit[1:0] accounts for the
enablement status of current thread, and the setting at bit[3:2] takes place
at next execve(). bit[4] defines the inheritance mode of the setting in
bit[3:2].

    * :c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`: bit[1:0]: Account for the
      Vector enablement status for the calling thread. The calling thread is
      not able to turn off Vector once it has been enabled. The prctl() call
      fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
      but the current enablement status is not off. Setting
      PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
      the original enablement status.

    * :c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`: bit[3:2]: Account for the
      Vector enablement setting for the calling thread at the next execve()
      system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
      then the enablement status will be decided by the system-wide
      enablement status when execve() happen.

    * :c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`: bit[4]: the inheritance
      mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
      is set then the following execve() will not clear the setting in both
      PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
      This setting persists across changes in the system-wide default value.

Return value:
    * 0 on success;
    * EINVAL: Vector not supported, invalid enablement status for current or
      next mask;
    * EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
      was enabled for the calling thread.

On success:
    * A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
      immediately. The enablement status specified in
      PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
      all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
      set.
    * Every successful call overwrites a previous setting for the calling
      thread.
”h]”(hÊ)”}”(hŒÒSets the Vector enablement status of the calling thread, where the control
argument consists of two 2-bit enablement statuses and a bit for inheritance
mode. Other threads of the calling process are unaffected.”h]”hŒÒSets the Vector enablement status of the calling thread, where the control
argument consists of two 2-bit enablement statuses and a bit for inheritance
mode. Other threads of the calling process are unaffected.”…””}”(hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj_  ubhÊ)”}”(hŒ]Enablement status is a tri-state value each occupying 2-bit of space in
the control argument:”h]”hŒ]Enablement status is a tri-state value each occupying 2-bit of space in
the control argument:”…””}”(hjq  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj_  ubjE  )”}”(hhh]”(jJ  )”}”(hŒÉ:c:macro:`PR_RISCV_V_VSTATE_CTRL_DEFAULT`: Use the system-wide default
enablement status on execve(). The system-wide default setting can be
controlled via sysctl interface (see sysctl section below).
”h]”hÊ)”}”(hŒÈ:c:macro:`PR_RISCV_V_VSTATE_CTRL_DEFAULT`: Use the system-wide default
enablement status on execve(). The system-wide default setting can be
controlled via sysctl interface (see sysctl section below).”h]”(h)”}”(hŒ):c:macro:`PR_RISCV_V_VSTATE_CTRL_DEFAULT`”h]”h÷)”}”(hjŒ  h]”hŒPR_RISCV_V_VSTATE_CTRL_DEFAULT”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhjŠ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒPR_RISCV_V_VSTATE_CTRL_DEFAULT”uh1hhŸh³h K!hj†  ubhŒŸ: Use the system-wide default
enablement status on execve(). The system-wide default setting can be
controlled via sysctl interface (see sysctl section below).”…””}”(hj†  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K!hj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj  ubjJ  )”}”(hŒM:c:macro:`PR_RISCV_V_VSTATE_CTRL_ON`: Allow Vector to be run for the
thread.
”h]”hÊ)”}”(hŒL:c:macro:`PR_RISCV_V_VSTATE_CTRL_ON`: Allow Vector to be run for the
thread.”h]”(h)”}”(hŒ$:c:macro:`PR_RISCV_V_VSTATE_CTRL_ON`”h]”h÷)”}”(hjÃ  h]”hŒPR_RISCV_V_VSTATE_CTRL_ON”…””}”(hjÅ  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhjÁ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒPR_RISCV_V_VSTATE_CTRL_ON”uh1hhŸh³h K%hj½  ubhŒ(: Allow Vector to be run for the
thread.”…””}”(hj½  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K%hj¹  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj  ubjJ  )”}”(hŒŸ:c:macro:`PR_RISCV_V_VSTATE_CTRL_OFF`: Disallow Vector. Executing Vector
instructions under such condition will trap and casuse the termination of the thread.
”h]”hÊ)”}”(hŒž:c:macro:`PR_RISCV_V_VSTATE_CTRL_OFF`: Disallow Vector. Executing Vector
instructions under such condition will trap and casuse the termination of the thread.”h]”(h)”}”(hŒ%:c:macro:`PR_RISCV_V_VSTATE_CTRL_OFF`”h]”h÷)”}”(hjú  h]”hŒPR_RISCV_V_VSTATE_CTRL_OFF”…””}”(hjü  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhjø  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒPR_RISCV_V_VSTATE_CTRL_OFF”uh1hhŸh³h K(hjô  ubhŒy: Disallow Vector. Executing Vector
instructions under such condition will trap and casuse the termination of the thread.”…””}”(hjô  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K(hjð  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jD  hŸh³h K!hj_  ubhÊ)”}”(hŒgarg: The control argument is a 5-bit value consisting of 3 parts, and
accessed by 3 masks respectively.”h]”hŒgarg: The control argument is a 5-bit value consisting of 3 parts, and
accessed by 3 masks respectively.”…””}”(hj/  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K+hj_  ubhÊ)”}”(hXV  The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK,
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT
represents bit[1:0], bit[3:2], and bit[4]. bit[1:0] accounts for the
enablement status of current thread, and the setting at bit[3:2] takes place
at next execve(). bit[4] defines the inheritance mode of the setting in
bit[3:2].”h]”hXV  The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK,
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT
represents bit[1:0], bit[3:2], and bit[4]. bit[1:0] accounts for the
enablement status of current thread, and the setting at bit[3:2] takes place
at next execve(). bit[4] defines the inheritance mode of the setting in
bit[3:2].”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K.hj_  ubj^  )”}”(hXm  * :c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`: bit[1:0]: Account for the
  Vector enablement status for the calling thread. The calling thread is
  not able to turn off Vector once it has been enabled. The prctl() call
  fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
  but the current enablement status is not off. Setting
  PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
  the original enablement status.

* :c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`: bit[3:2]: Account for the
  Vector enablement setting for the calling thread at the next execve()
  system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
  then the enablement status will be decided by the system-wide
  enablement status when execve() happen.

* :c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`: bit[4]: the inheritance
  mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
  is set then the following execve() will not clear the setting in both
  PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
  This setting persists across changes in the system-wide default value.
”h]”jE  )”}”(hhh]”(jJ  )”}”(hX·  :c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`: bit[1:0]: Account for the
Vector enablement status for the calling thread. The calling thread is
not able to turn off Vector once it has been enabled. The prctl() call
fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
but the current enablement status is not off. Setting
PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
the original enablement status.
”h]”hÊ)”}”(hX¶  :c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`: bit[1:0]: Account for the
Vector enablement status for the calling thread. The calling thread is
not able to turn off Vector once it has been enabled. The prctl() call
fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
but the current enablement status is not off. Setting
PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
the original enablement status.”h]”(h)”}”(hŒ*:c:macro:`PR_RISCV_V_VSTATE_CTRL_CUR_MASK`”h]”h÷)”}”(hj\  h]”hŒPR_RISCV_V_VSTATE_CTRL_CUR_MASK”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhjZ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒPR_RISCV_V_VSTATE_CTRL_CUR_MASK”uh1hhŸh³h K5hjV  ubhXŒ  : bit[1:0]: Account for the
Vector enablement status for the calling thread. The calling thread is
not able to turn off Vector once it has been enabled. The prctl() call
fails with EPERM if the value in this mask is PR_RISCV_V_VSTATE_CTRL_OFF
but the current enablement status is not off. Setting
PR_RISCV_V_VSTATE_CTRL_DEFAULT here takes no effect but to set back
the original enablement status.”…””}”(hjV  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K5hjR  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjO  ubjJ  )”}”(hX8  :c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`: bit[3:2]: Account for the
Vector enablement setting for the calling thread at the next execve()
system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
then the enablement status will be decided by the system-wide
enablement status when execve() happen.
”h]”hÊ)”}”(hX7  :c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`: bit[3:2]: Account for the
Vector enablement setting for the calling thread at the next execve()
system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
then the enablement status will be decided by the system-wide
enablement status when execve() happen.”h]”(h)”}”(hŒ+:c:macro:`PR_RISCV_V_VSTATE_CTRL_NEXT_MASK`”h]”h÷)”}”(hj“  h]”hŒ PR_RISCV_V_VSTATE_CTRL_NEXT_MASK”…””}”(hj•  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhj‘  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  Œ PR_RISCV_V_VSTATE_CTRL_NEXT_MASK”uh1hhŸh³h K=hj  ubhX  : bit[3:2]: Account for the
Vector enablement setting for the calling thread at the next execve()
system call. If PR_RISCV_V_VSTATE_CTRL_DEFAULT is used in this mask,
then the enablement status will be decided by the system-wide
enablement status when execve() happen.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K=hj‰  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjO  ubjJ  )”}”(hXZ  :c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`: bit[4]: the inheritance
mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
is set then the following execve() will not clear the setting in both
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
This setting persists across changes in the system-wide default value.
”h]”hÊ)”}”(hXY  :c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`: bit[4]: the inheritance
mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
is set then the following execve() will not clear the setting in both
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
This setting persists across changes in the system-wide default value.”h]”(h)”}”(hŒ):c:macro:`PR_RISCV_V_VSTATE_CTRL_INHERIT`”h]”h÷)”}”(hjÊ  h]”hŒPR_RISCV_V_VSTATE_CTRL_INHERIT”…””}”(hjÌ  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhjÈ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒPR_RISCV_V_VSTATE_CTRL_INHERIT”uh1hhŸh³h KChjÄ  ubhX0  : bit[4]: the inheritance
mode for the setting at PR_RISCV_V_VSTATE_CTRL_NEXT_MASK. If the bit
is set then the following execve() will not clear the setting in both
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT.
This setting persists across changes in the system-wide default value.”…””}”(hjÄ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KChjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjO  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h K5hjK  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j]  hŸh³h K5hj_  ubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒãReturn value:
* 0 on success;
* EINVAL: Vector not supported, invalid enablement status for current or
  next mask;
* EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
  was enabled for the calling thread.
”h]”(hŒterm”“”)”}”(hŒReturn value:”h]”hŒReturn value:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h KNhj
  ubhŒ
definition”“”)”}”(hhh]”jE  )”}”(hhh]”(jJ  )”}”(hŒ0 on success;”h]”hÊ)”}”(hj(  h]”hŒ0 on success;”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KJhj&  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj#  ubjJ  )”}”(hŒQEINVAL: Vector not supported, invalid enablement status for current or
next mask;”h]”hÊ)”}”(hŒQEINVAL: Vector not supported, invalid enablement status for current or
next mask;”h]”hŒQEINVAL: Vector not supported, invalid enablement status for current or
next mask;”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KKhj=  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj#  ubjJ  )”}”(hŒkEPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
was enabled for the calling thread.
”h]”hÊ)”}”(hŒjEPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
was enabled for the calling thread.”h]”hŒjEPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector
was enabled for the calling thread.”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KMhjU  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj#  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h KJhj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h KNhj  ubj	  )”}”(hXh  On success:
* A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
  immediately. The enablement status specified in
  PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
  all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
  set.
* Every successful call overwrites a previous setting for the calling
  thread.
”h]”(j  )”}”(hŒOn success:”h]”hŒOn success:”…””}”(hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h KWhj  ubj  )”}”(hhh]”jE  )”}”(hhh]”(jJ  )”}”(hX  A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
immediately. The enablement status specified in
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
set.”h]”hÊ)”}”(hX  A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
immediately. The enablement status specified in
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
set.”h]”hX  A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place
immediately. The enablement status specified in
PR_RISCV_V_VSTATE_CTRL_NEXT_MASK happens at the next execve() call, or
all following execve() calls if PR_RISCV_V_VSTATE_CTRL_INHERIT bit is
set.”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KQhj—  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj”  ubjJ  )”}”(hŒLEvery successful call overwrites a previous setting for the calling
thread.
”h]”hÊ)”}”(hŒKEvery successful call overwrites a previous setting for the calling
thread.”h]”hŒKEvery successful call overwrites a previous setting for the calling
thread.”…””}”(hj³  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KVhj¯  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj”  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h KQhj‘  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h KWhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj_  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j]  hŸh³h KhjK  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjF  hžhhŸh³h NubjJ  )”}”(hX½  prctl(PR_RISCV_V_GET_CONTROL)

  Gets the same Vector enablement status for the calling thread. Setting for
  next execve() call and the inheritance bit are all OR-ed together.

  Note that ELF programs are able to get the availability of V for itself by
  reading :c:macro:`COMPAT_HWCAP_ISA_V` bit of :c:macro:`ELF_HWCAP` in the
  auxiliary vector.

  Return value:
      * a nonnegative value on success;
      * EINVAL: Vector not supported.
”h]”(hÊ)”}”(hŒprctl(PR_RISCV_V_GET_CONTROL)”h]”hŒprctl(PR_RISCV_V_GET_CONTROL)”…””}”(hjï  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KYhjë  ubj^  )”}”(hXŽ  Gets the same Vector enablement status for the calling thread. Setting for
next execve() call and the inheritance bit are all OR-ed together.

Note that ELF programs are able to get the availability of V for itself by
reading :c:macro:`COMPAT_HWCAP_ISA_V` bit of :c:macro:`ELF_HWCAP` in the
auxiliary vector.

Return value:
    * a nonnegative value on success;
    * EINVAL: Vector not supported.
”h]”(hÊ)”}”(hŒGets the same Vector enablement status for the calling thread. Setting for
next execve() call and the inheritance bit are all OR-ed together.”h]”hŒGets the same Vector enablement status for the calling thread. Setting for
next execve() call and the inheritance bit are all OR-ed together.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K[hjý  ubhÊ)”}”(hŒ¥Note that ELF programs are able to get the availability of V for itself by
reading :c:macro:`COMPAT_HWCAP_ISA_V` bit of :c:macro:`ELF_HWCAP` in the
auxiliary vector.”h]”(hŒSNote that ELF programs are able to get the availability of V for itself by
reading ”…””}”(hj  hžhhŸNh Nubh)”}”(hŒ:c:macro:`COMPAT_HWCAP_ISA_V`”h]”h÷)”}”(hj  h]”hŒCOMPAT_HWCAP_ISA_V”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhj  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  ŒCOMPAT_HWCAP_ISA_V”uh1hhŸh³h K^hj  ubhŒ bit of ”…””}”(hj  hžhhŸNh Nubh)”}”(hŒ:c:macro:`ELF_HWCAP`”h]”h÷)”}”(hj<  h]”hŒ	ELF_HWCAP”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”(j  j  Œc-macro”eh"]”h$]”h&]”uh1höhj:  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j  Œ	refdomain”j  Œreftype”Œmacro”Œrefexplicit”‰Œrefwarn”‰j  Œ	ELF_HWCAP”uh1hhŸh³h K^hj  ubhŒ in the
auxiliary vector.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K^hjý  ubj  )”}”(hhh]”j	  )”}”(hŒPReturn value:
* a nonnegative value on success;
* EINVAL: Vector not supported.
”h]”(j  )”}”(hŒReturn value:”h]”hŒReturn value:”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h Kdhjf  ubj  )”}”(hhh]”jE  )”}”(hhh]”(jJ  )”}”(hŒa nonnegative value on success;”h]”hÊ)”}”(hj€  h]”hŒa nonnegative value on success;”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kchj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj{  ubjJ  )”}”(hŒEINVAL: Vector not supported.
”h]”hÊ)”}”(hŒEINVAL: Vector not supported.”h]”hŒEINVAL: Vector not supported.”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kdhj•  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj{  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h Kchjx  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjf  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h Kdhjc  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjý  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j]  hŸh³h K[hjë  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjF  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h KhhÙhžhubeh}”(h]”Œprctl-interface”ah ]”h"]”Œ1. prctl() interface”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ)2.  System runtime configuration (sysctl)”h]”hŒ)2.  System runtime configuration (sysctl)”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjß  hžhhŸh³h KgubhÊ)”}”(hŒõTo mitigate the ABI impact of expansion of the signal stack, a
policy mechanism is provided to the administrators, distro maintainers, and
developers to control the default Vector enablement status for userspace
processes in form of sysctl knob:”h]”hŒõTo mitigate the ABI impact of expansion of the signal stack, a
policy mechanism is provided to the administrators, distro maintainers, and
developers to control the default Vector enablement status for userspace
processes in form of sysctl knob:”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kihjß  hžhubjE  )”}”(hhh]”jJ  )”}”(hXÌ  /proc/sys/abi/riscv_v_default_allow

  Writing the text representation of 0 or 1 to this file sets the default
  system enablement status for new starting userspace programs. Valid values
  are:

  * 0: Do not allow Vector code to be executed as the default for new processes.
  * 1: Allow Vector code to be executed as the default for new processes.

  Reading this file returns the current system default enablement status.

  At every execve() call, a new enablement status of the new process is set to
  the system default, unless:

    * PR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
      setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
      PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,

    * The setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
      PR_RISCV_V_VSTATE_CTRL_DEFAULT.

  Modifying the system default enablement status does not affect the enablement
  status of any existing process of thread that do not make an execve() call.
”h]”(hÊ)”}”(hŒ#/proc/sys/abi/riscv_v_default_allow”h]”hŒ#/proc/sys/abi/riscv_v_default_allow”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Knhj  ubj^  )”}”(hX‰  Writing the text representation of 0 or 1 to this file sets the default
system enablement status for new starting userspace programs. Valid values
are:

* 0: Do not allow Vector code to be executed as the default for new processes.
* 1: Allow Vector code to be executed as the default for new processes.

Reading this file returns the current system default enablement status.

At every execve() call, a new enablement status of the new process is set to
the system default, unless:

  * PR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
    setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
    PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,

  * The setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
    PR_RISCV_V_VSTATE_CTRL_DEFAULT.

Modifying the system default enablement status does not affect the enablement
status of any existing process of thread that do not make an execve() call.
”h]”(hÊ)”}”(hŒ—Writing the text representation of 0 or 1 to this file sets the default
system enablement status for new starting userspace programs. Valid values
are:”h]”hŒ—Writing the text representation of 0 or 1 to this file sets the default
system enablement status for new starting userspace programs. Valid values
are:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kphj  ubjE  )”}”(hhh]”(jJ  )”}”(hŒL0: Do not allow Vector code to be executed as the default for new processes.”h]”hÊ)”}”(hj*  h]”hŒL0: Do not allow Vector code to be executed as the default for new processes.”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kthj(  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj%  ubjJ  )”}”(hŒF1: Allow Vector code to be executed as the default for new processes.
”h]”hÊ)”}”(hŒE1: Allow Vector code to be executed as the default for new processes.”h]”hŒE1: Allow Vector code to be executed as the default for new processes.”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kuhj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj%  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h Kthj  ubhÊ)”}”(hŒGReading this file returns the current system default enablement status.”h]”hŒGReading this file returns the current system default enablement status.”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kwhj  ubhÊ)”}”(hŒhAt every execve() call, a new enablement status of the new process is set to
the system default, unless:”h]”hŒhAt every execve() call, a new enablement status of the new process is set to
the system default, unless:”…””}”(hjk  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kyhj  ubj^  )”}”(hX   * PR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
  setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
  PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,

* The setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
  PR_RISCV_V_VSTATE_CTRL_DEFAULT.
”h]”jE  )”}”(hhh]”(jJ  )”}”(hŒžPR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,
”h]”hÊ)”}”(hŒPR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,”h]”hŒPR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT. Or,”…””}”(hj„  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K|hj€  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj}  ubjJ  )”}”(hŒWThe setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT.
”h]”hÊ)”}”(hŒVThe setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT.”h]”hŒVThe setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT.”…””}”(hjœ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hj˜  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jI  hj}  ubeh}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h K|hjy  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j]  hŸh³h K|hj  ubhÊ)”}”(hŒ™Modifying the system default enablement status does not affect the enablement
status of any existing process of thread that do not make an execve() call.”h]”hŒ™Modifying the system default enablement status does not affect the enablement
status of any existing process of thread that do not make an execve() call.”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kƒhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j]  hŸh³h Kphj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jI  hjþ  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j-  j.  uh1jD  hŸh³h Knhjß  hžhubeh}”(h]”Œ#system-runtime-configuration-sysctl”ah ]”h"]”Œ(2. system runtime configuration (sysctl)”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kgubhµ)”}”(hhh]”(hº)”}”(hŒ-3.  Vector Register State Across System Calls”h]”hŒ-3.  Vector Register State Across System Calls”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjä  hžhhŸh³h K‡ubhÊ)”}”(hŒcAs indicated by version 1.0 of the V extension [1], vector registers are
clobbered by system calls.”h]”hŒcAs indicated by version 1.0 of the V extension [1], vector registers are
clobbered by system calls.”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‰hjä  hžhubhÊ)”}”(hŒL1: https://github.com/riscv/riscv-v-spec/blob/master/calling-convention.adoc”h]”(hŒ1: ”…””}”(hj  hžhhŸNh NubhŒ	reference”“”)”}”(hŒIhttps://github.com/riscv/riscv-v-spec/blob/master/calling-convention.adoc”h]”hŒIhttps://github.com/riscv/riscv-v-spec/blob/master/calling-convention.adoc”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KŒhjä  hžhubeh}”(h]”Œ)vector-register-state-across-system-calls”ah ]”h"]”Œ,3. vector register state across system calls”ah$]”h&]”uh1h´hh¶hžhhŸh³h K‡ubeh}”(h]”Œ)vector-extension-support-for-risc-v-linux”ah ]”h"]”Œ)vector extension support for risc-v linux”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(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”jU  Œ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,  jÜ  jÙ  já  jÞ  j'  j$  uŒ	nametypes”}”(j/  ‰jÜ  ‰já  ‰j'  ‰uh}”(j,  h¶jÙ  hÙjÞ  jß  j$  jä  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.