€•ðh      Œ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/x86/xstate”Œ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/x86/xstate”Œ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/x86/xstate”Œ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/x86/xstate”Œ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/x86/xstate”Œ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/x86/xstate”Œ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Œ0Using XSTATE features in user space applications”h]”hŒ0Using XSTATE features in user space applications”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ=/var/lib/git/docbuild/linux/Documentation/arch/x86/xstate.rst”h KubhŒ	paragraph”“”)”}”(hŒÂThe x86 architecture supports floating-point extensions which are
enumerated via CPUID. Applications consult CPUID and use XGETBV to
evaluate which features have been enabled by the kernel XCR0.”h]”hŒÂThe x86 architecture supports floating-point extensions which are
enumerated via CPUID. Applications consult CPUID and use XGETBV to
evaluate which features have been enabled by the kernel XCR0.”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hXJ  Up to AVX-512 and PKRU states, these features are automatically enabled by
the kernel if available. Features like AMX TILE_DATA (XSTATE component 18)
are enabled by XCR0 as well, but the first use of related instruction is
trapped by the kernel because by default the required large XSTATE buffers
are not allocated automatically.”h]”hXJ  Up to AVX-512 and PKRU states, these features are automatically enabled by
the kernel if available. Features like AMX TILE_DATA (XSTATE component 18)
are enabled by XCR0 as well, but the first use of related instruction is
trapped by the kernel because by default the required large XSTATE buffers
are not allocated automatically.”…””}”(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Œ The purpose for dynamic features”h]”hŒ The purpose for dynamic features”…””}”(hhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hhÕhžhhŸh¶h Kubh¸)”}”(hXK  Legacy userspace libraries often have hard-coded, static sizes for
alternate signal stacks, often using MINSIGSTKSZ which is typically 2KB.
That stack must be able to store at *least* the signal frame that the
kernel sets up before jumping into the signal handler. That signal frame
must include an XSAVE buffer defined by the CPU.”h]”(hŒ°Legacy userspace libraries often have hard-coded, static sizes for
alternate signal stacks, often using MINSIGSTKSZ which is typically 2KB.
That stack must be able to store at ”…””}”(hhæhžhhŸNh NubhŒemphasis”“”)”}”(hŒ*least*”h]”hŒleast”…””}”(hhðhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîhhæubhŒ” the signal frame that the
kernel sets up before jumping into the signal handler. That signal frame
must include an XSAVE buffer defined by the CPU.”…””}”(hhæhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÕhžhubh¸)”}”(hX‚  However, that means that the size of signal stacks is dynamic, not static,
because different CPUs have differently-sized XSAVE buffers. A compiled-in
size of 2KB with existing applications is too small for new CPU features
like AMX. Instead of universally requiring larger stack, with the dynamic
enabling, the kernel can enforce userspace applications to have
properly-sized altstacks.”h]”hX‚  However, that means that the size of signal stacks is dynamic, not static,
because different CPUs have differently-sized XSAVE buffers. A compiled-in
size of 2KB with existing applications is too small for new CPU features
like AMX. Instead of universally requiring larger stack, with the dynamic
enabling, the kernel can enforce userspace applications to have
properly-sized altstacks.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÕhžhubeh}”(h]”Œ the-purpose-for-dynamic-features”ah ]”h"]”Œ the purpose for dynamic features”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒDUsing dynamically enabled XSTATE features in user space applications”h]”hŒDUsing dynamically enabled XSTATE features in user space applications”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h Kubh¸)”}”(hŒ›The kernel provides an arch_prctl(2) based mechanism for applications to
request the usage of such features. The arch_prctl(2) options related to
this are:”h]”hŒ›The kernel provides an arch_prctl(2) based mechanism for applications to
request the usage of such features. The arch_prctl(2) options related to
this are:”…””}”(hj/  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K!hj  hžhubhŒoption_list”“”)”}”(hhh]”(hŒoption_list_item”“”)”}”(hhh]”(hŒoption_group”“”)”}”(hhh]”hŒoption”“”)”}”(hŒ-ARCH_GET_XCOMP_SUPP”h]”(hŒoption_string”“”)”}”(hŒ-A”h]”hŒ-A”…””}”hjT  sbah}”(h]”h ]”h"]”h$]”h&]”uh1jR  hjN  ubhŒoption_argument”“”)”}”(hŒRCH_GET_XCOMP_SUPP”h]”hŒRCH_GET_XCOMP_SUPP”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œ	delimiter”huh1jb  hjN  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jL  hjI  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jG  hjD  ubhŒdescription”“”)”}”(hŒ¸arch_prctl(ARCH_GET_XCOMP_SUPP, &features);

ARCH_GET_XCOMP_SUPP stores the supported features in userspace storage of
type uint64_t. The second argument is a pointer to that storage.
”h]”(h¸)”}”(hŒ+arch_prctl(ARCH_GET_XCOMP_SUPP, &features);”h]”hŒ+arch_prctl(ARCH_GET_XCOMP_SUPP, &features);”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K'hj  ubh¸)”}”(hŒŠARCH_GET_XCOMP_SUPP stores the supported features in userspace storage of
type uint64_t. The second argument is a pointer to that storage.”h]”hŒŠARCH_GET_XCOMP_SUPP stores the supported features in userspace storage of
type uint64_t. The second argument is a pointer to that storage.”…””}”(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jD  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jB  hj?  hžhhŸh¶h NubjC  )”}”(hhh]”(jH  )”}”(hhh]”jM  )”}”(hŒ-ARCH_GET_XCOMP_PERM”h]”(jS  )”}”(hŒ-A”h]”hŒ-A”…””}”hj·  sbah}”(h]”h ]”h"]”h$]”h&]”uh1jR  hj³  ubjc  )”}”(hŒRCH_GET_XCOMP_PERM”h]”hŒRCH_GET_XCOMP_PERM”…””}”(hjÅ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œ	delimiter”huh1jb  hj³  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jL  hj°  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jG  hj­  ubj€  )”}”(hŒÝarch_prctl(ARCH_GET_XCOMP_PERM, &features);

ARCH_GET_XCOMP_PERM stores the features for which the userspace process
has permission in userspace storage of type uint64_t. The second argument
is a pointer to that storage.
”h]”(h¸)”}”(hŒ+arch_prctl(ARCH_GET_XCOMP_PERM, &features);”h]”hŒ+arch_prctl(ARCH_GET_XCOMP_PERM, &features);”…””}”(hjä  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K.hjà  ubh¸)”}”(hŒ¯ARCH_GET_XCOMP_PERM stores the features for which the userspace process
has permission in userspace storage of type uint64_t. The second argument
is a pointer to that storage.”h]”hŒ¯ARCH_GET_XCOMP_PERM stores the features for which the userspace process
has permission in userspace storage of type uint64_t. The second argument
is a pointer to that storage.”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K0hjà  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj­  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jB  hj?  hžhhŸh¶h NubjC  )”}”(hhh]”(jH  )”}”(hhh]”jM  )”}”(hŒ-ARCH_REQ_XCOMP_PERM”h]”(jS  )”}”(hŒ-A”h]”hŒ-A”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”uh1jR  hj  ubjc  )”}”(hŒRCH_REQ_XCOMP_PERM”h]”hŒRCH_REQ_XCOMP_PERM”…””}”(hj$  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œ	delimiter”huh1jb  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jL  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jG  hj  ubj€  )”}”(hXs  arch_prctl(ARCH_REQ_XCOMP_PERM, feature_nr);

ARCH_REQ_XCOMP_PERM allows to request permission for a dynamically enabled
feature or a feature set. A feature set can be mapped to a facility, e.g.
AMX, and can require one or more XSTATE components to be enabled.

The feature argument is the number of the highest XSTATE component which
is required for a facility to work.
”h]”(h¸)”}”(hŒ,arch_prctl(ARCH_REQ_XCOMP_PERM, feature_nr);”h]”hŒ,arch_prctl(ARCH_REQ_XCOMP_PERM, feature_nr);”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K6hj?  ubh¸)”}”(hŒÖARCH_REQ_XCOMP_PERM allows to request permission for a dynamically enabled
feature or a feature set. A feature set can be mapped to a facility, e.g.
AMX, and can require one or more XSTATE components to be enabled.”h]”hŒÖARCH_REQ_XCOMP_PERM allows to request permission for a dynamically enabled
feature or a feature set. A feature set can be mapped to a facility, e.g.
AMX, and can require one or more XSTATE components to be enabled.”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K8hj?  ubh¸)”}”(hŒlThe feature argument is the number of the highest XSTATE component which
is required for a facility to work.”h]”hŒlThe feature argument is the number of the highest XSTATE component which
is required for a facility to work.”…””}”(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j  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jB  hj?  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1j=  hŸh¶h K%hj  hžhubh¸)”}”(hX	  When requesting permission for a feature, the kernel checks the
availability. The kernel ensures that sigaltstacks in the process's tasks
are large enough to accommodate the resulting large signal frame. It
enforces this both during ARCH_REQ_XCOMP_SUPP and during any subsequent
sigaltstack(2) calls. If an installed sigaltstack is smaller than the
resulting sigframe size, ARCH_REQ_XCOMP_SUPP results in -ENOSUPP. Also,
sigaltstack(2) results in -ENOMEM if the requested altstack is too small
for the permitted features.”h]”hX  When requesting permission for a feature, the kernel checks the
availability. The kernel ensures that sigaltstacks in the processâ€™s tasks
are large enough to accommodate the resulting large signal frame. It
enforces this both during ARCH_REQ_XCOMP_SUPP and during any subsequent
sigaltstack(2) calls. If an installed sigaltstack is smaller than the
resulting sigframe size, ARCH_REQ_XCOMP_SUPP results in -ENOSUPP. Also,
sigaltstack(2) results in -ENOMEM if the requested altstack is too small
for the permitted features.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K?hj  hžhubh¸)”}”(hŒlPermission, when granted, is valid per process. Permissions are inherited
on fork(2) and cleared on exec(3).”h]”hŒlPermission, when granted, is valid per process. Permissions are inherited
on fork(2) and cleared on exec(3).”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KHhj  hžhubh¸)”}”(hX×  The first use of an instruction related to a dynamically enabled feature is
trapped by the kernel. The trap handler checks whether the process has
permission to use the feature. If the process has no permission then the
kernel sends SIGILL to the application. If the process has permission then
the handler allocates a larger xstate buffer for the task so the large
state can be context switched. In the unlikely cases that the allocation
fails, the kernel sends SIGSEGV.”h]”hX×  The first use of an instruction related to a dynamically enabled feature is
trapped by the kernel. The trap handler checks whether the process has
permission to use the feature. If the process has no permission then the
kernel sends SIGILL to the application. If the process has permission then
the handler allocates a larger xstate buffer for the task so the large
state can be context switched. In the unlikely cases that the allocation
fails, the kernel sends SIGSEGV.”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KKhj  hžhubh¢)”}”(hhh]”(h§)”}”(hŒAMX TILE_DATA enabling example”h]”hŒAMX TILE_DATA enabling example”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj©  hžhhŸh¶h KTubh¸)”}”(hŒPBelow is the example of how userspace applications enable
TILE_DATA dynamically:”h]”hŒPBelow is the example of how userspace applications enable
TILE_DATA dynamically:”…””}”(hjº  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KVhj©  hžhubhŒblock_quote”“”)”}”(hX…  1. The application first needs to query the kernel for AMX
   support::

      #include <asm/prctl.h>
      #include <sys/syscall.h>
      #include <stdio.h>
      #include <unistd.h>

      #ifndef ARCH_GET_XCOMP_SUPP
      #define ARCH_GET_XCOMP_SUPP  0x1021
      #endif

      #ifndef ARCH_XCOMP_TILECFG
      #define ARCH_XCOMP_TILECFG   17
      #endif

      #ifndef ARCH_XCOMP_TILEDATA
      #define ARCH_XCOMP_TILEDATA  18
      #endif

      #define MASK_XCOMP_TILE      ((1 << ARCH_XCOMP_TILECFG) | \
                                    (1 << ARCH_XCOMP_TILEDATA))

      unsigned long features;
      long rc;

      ...

      rc = syscall(SYS_arch_prctl, ARCH_GET_XCOMP_SUPP, &features);

      if (!rc && (features & MASK_XCOMP_TILE) == MASK_XCOMP_TILE)
          printf("AMX is available.\n");

2. After that, determining support for AMX, an application must
   explicitly ask permission to use it::

      #ifndef ARCH_REQ_XCOMP_PERM
      #define ARCH_REQ_XCOMP_PERM  0x1023
      #endif

      ...

      rc = syscall(SYS_arch_prctl, ARCH_REQ_XCOMP_PERM, ARCH_XCOMP_TILEDATA);

      if (!rc)
          printf("AMX is ready for use.\n");
”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hXå  The application first needs to query the kernel for AMX
support::

   #include <asm/prctl.h>
   #include <sys/syscall.h>
   #include <stdio.h>
   #include <unistd.h>

   #ifndef ARCH_GET_XCOMP_SUPP
   #define ARCH_GET_XCOMP_SUPP  0x1021
   #endif

   #ifndef ARCH_XCOMP_TILECFG
   #define ARCH_XCOMP_TILECFG   17
   #endif

   #ifndef ARCH_XCOMP_TILEDATA
   #define ARCH_XCOMP_TILEDATA  18
   #endif

   #define MASK_XCOMP_TILE      ((1 << ARCH_XCOMP_TILECFG) | \
                                 (1 << ARCH_XCOMP_TILEDATA))

   unsigned long features;
   long rc;

   ...

   rc = syscall(SYS_arch_prctl, ARCH_GET_XCOMP_SUPP, &features);

   if (!rc && (features & MASK_XCOMP_TILE) == MASK_XCOMP_TILE)
       printf("AMX is available.\n");
”h]”(h¸)”}”(hŒAThe application first needs to query the kernel for AMX
support::”h]”hŒ@The application first needs to query the kernel for AMX
support:”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KYhjÕ  ubhŒliteral_block”“”)”}”(hXb  #include <asm/prctl.h>
#include <sys/syscall.h>
#include <stdio.h>
#include <unistd.h>

#ifndef ARCH_GET_XCOMP_SUPP
#define ARCH_GET_XCOMP_SUPP  0x1021
#endif

#ifndef ARCH_XCOMP_TILECFG
#define ARCH_XCOMP_TILECFG   17
#endif

#ifndef ARCH_XCOMP_TILEDATA
#define ARCH_XCOMP_TILEDATA  18
#endif

#define MASK_XCOMP_TILE      ((1 << ARCH_XCOMP_TILECFG) | \
                              (1 << ARCH_XCOMP_TILEDATA))

unsigned long features;
long rc;

...

rc = syscall(SYS_arch_prctl, ARCH_GET_XCOMP_SUPP, &features);

if (!rc && (features & MASK_XCOMP_TILE) == MASK_XCOMP_TILE)
    printf("AMX is available.\n");”h]”hXb  #include <asm/prctl.h>
#include <sys/syscall.h>
#include <stdio.h>
#include <unistd.h>

#ifndef ARCH_GET_XCOMP_SUPP
#define ARCH_GET_XCOMP_SUPP  0x1021
#endif

#ifndef ARCH_XCOMP_TILECFG
#define ARCH_XCOMP_TILECFG   17
#endif

#ifndef ARCH_XCOMP_TILEDATA
#define ARCH_XCOMP_TILEDATA  18
#endif

#define MASK_XCOMP_TILE      ((1 << ARCH_XCOMP_TILECFG) | \
                              (1 << ARCH_XCOMP_TILEDATA))

unsigned long features;
long rc;

...

rc = syscall(SYS_arch_prctl, ARCH_GET_XCOMP_SUPP, &features);

if (!rc && (features & MASK_XCOMP_TILE) == MASK_XCOMP_TILE)
    printf("AMX is available.\n");”…””}”hjé  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jç  hŸh¶h K\hjÕ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÓ  hjÐ  ubjÔ  )”}”(hX?  After that, determining support for AMX, an application must
explicitly ask permission to use it::

   #ifndef ARCH_REQ_XCOMP_PERM
   #define ARCH_REQ_XCOMP_PERM  0x1023
   #endif

   ...

   rc = syscall(SYS_arch_prctl, ARCH_REQ_XCOMP_PERM, ARCH_XCOMP_TILEDATA);

   if (!rc)
       printf("AMX is ready for use.\n");
”h]”(h¸)”}”(hŒbAfter that, determining support for AMX, an application must
explicitly ask permission to use it::”h]”hŒaAfter that, determining support for AMX, an application must
explicitly ask permission to use it:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kzhjÿ  ubjè  )”}”(hŒÅ#ifndef ARCH_REQ_XCOMP_PERM
#define ARCH_REQ_XCOMP_PERM  0x1023
#endif

...

rc = syscall(SYS_arch_prctl, ARCH_REQ_XCOMP_PERM, ARCH_XCOMP_TILEDATA);

if (!rc)
    printf("AMX is ready for use.\n");”h]”hŒÅ#ifndef ARCH_REQ_XCOMP_PERM
#define ARCH_REQ_XCOMP_PERM  0x1023
#endif

...

rc = syscall(SYS_arch_prctl, ARCH_REQ_XCOMP_PERM, ARCH_XCOMP_TILEDATA);

if (!rc)
    printf("AMX is ready for use.\n");”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”j÷  jø  uh1jç  hŸh¶h K}hjÿ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÓ  hjÐ  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jÎ  hjÊ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÈ  hŸh¶h KYhj©  hžhubh¸)”}”(hŒ?Note this example does not include the sigaltstack preparation.”h]”hŒ?Note this example does not include the sigaltstack preparation.”…””}”(hj6  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kˆhj©  hžhubeh}”(h]”Œamx-tile-data-enabling-example”ah ]”h"]”Œamx tile_data enabling example”ah$]”h&]”uh1h¡hj  hžhhŸh¶h KTubeh}”(h]”ŒDusing-dynamically-enabled-xstate-features-in-user-space-applications”ah ]”h"]”ŒDusing dynamically enabled xstate features in user space applications”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒ!Dynamic features in signal frames”h]”hŒ!Dynamic features in signal frames”…””}”(hjW  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjT  hžhhŸh¶h K‹ubh¸)”}”(hXN  Dynamically enabled features are not written to the signal frame upon signal
entry if the feature is in its initial configuration.  This differs from
non-dynamic features which are always written regardless of their
configuration.  Signal handlers can examine the XSAVE buffer's XSTATE_BV
field to determine if a features was written.”h]”hXP  Dynamically enabled features are not written to the signal frame upon signal
entry if the feature is in its initial configuration.  This differs from
non-dynamic features which are always written regardless of their
configuration.  Signal handlers can examine the XSAVE bufferâ€™s XSTATE_BV
field to determine if a features was written.”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhjT  hžhubeh}”(h]”Œ!dynamic-features-in-signal-frames”ah ]”h"]”Œ!dynamic features in signal frames”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K‹ubh¢)”}”(hhh]”(h§)”}”(hŒ%Dynamic features for virtual machines”h]”hŒ%Dynamic features for virtual machines”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj{  hžhhŸh¶h K”ubh¸)”}”(hŒÂThe permission for the guest state component needs to be managed separately
from the host, as they are exclusive to each other. A coupled of options
are extended to control the guest permission:”h]”hŒÂThe permission for the guest state component needs to be managed separately
from the host, as they are exclusive to each other. A coupled of options
are extended to control the guest permission:”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K–hj{  hžhubj>  )”}”(hhh]”(jC  )”}”(hhh]”(jH  )”}”(hhh]”jM  )”}”(hŒ-ARCH_GET_XCOMP_GUEST_PERM”h]”(jS  )”}”(hŒ-A”h]”hŒ-A”…””}”hj§  sbah}”(h]”h ]”h"]”h$]”h&]”uh1jR  hj£  ubjc  )”}”(hŒRCH_GET_XCOMP_GUEST_PERM”h]”hŒRCH_GET_XCOMP_GUEST_PERM”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œ	delimiter”huh1jb  hj£  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jL  hj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1jG  hj  ubj€  )”}”(hŒÄarch_prctl(ARCH_GET_XCOMP_GUEST_PERM, &features);

ARCH_GET_XCOMP_GUEST_PERM is a variant of ARCH_GET_XCOMP_PERM. So it
provides the same semantics and functionality but for the guest
components.
”h]”(h¸)”}”(hŒ1arch_prctl(ARCH_GET_XCOMP_GUEST_PERM, &features);”h]”hŒ1arch_prctl(ARCH_GET_XCOMP_GUEST_PERM, &features);”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KœhjÐ  ubh¸)”}”(hŒARCH_GET_XCOMP_GUEST_PERM is a variant of ARCH_GET_XCOMP_PERM. So it
provides the same semantics and functionality but for the guest
components.”h]”hŒARCH_GET_XCOMP_GUEST_PERM is a variant of ARCH_GET_XCOMP_PERM. So it
provides the same semantics and functionality but for the guest
components.”…””}”(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j  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jB  hjš  hžhhŸh¶h NubjC  )”}”(hhh]”(jH  )”}”(hhh]”jM  )”}”(hŒ-ARCH_REQ_XCOMP_GUEST_PERM”h]”(jS  )”}”(hŒ-A”h]”hŒ-A”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”uh1jR  hj  ubjc  )”}”(hŒRCH_REQ_XCOMP_GUEST_PERM”h]”hŒRCH_REQ_XCOMP_GUEST_PERM”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œ	delimiter”huh1jb  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jL  hjÿ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jG  hjü  ubj€  )”}”(hXµ  arch_prctl(ARCH_REQ_XCOMP_GUEST_PERM, feature_nr);

ARCH_REQ_XCOMP_GUEST_PERM is a variant of ARCH_REQ_XCOMP_PERM. It has the
same semantics for the guest permission. While providing a similar
functionality, this comes with a constraint. Permission is frozen when the
first VCPU is created. Any attempt to change permission after that point
is going to be rejected. So, the permission has to be requested before the
first VCPU creation.
”h]”(h¸)”}”(hŒ2arch_prctl(ARCH_REQ_XCOMP_GUEST_PERM, feature_nr);”h]”hŒ2arch_prctl(ARCH_REQ_XCOMP_GUEST_PERM, feature_nr);”…””}”(hj3  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¤hj/  ubh¸)”}”(hX€  ARCH_REQ_XCOMP_GUEST_PERM is a variant of ARCH_REQ_XCOMP_PERM. It has the
same semantics for the guest permission. While providing a similar
functionality, this comes with a constraint. Permission is frozen when the
first VCPU is created. Any attempt to change permission after that point
is going to be rejected. So, the permission has to be requested before the
first VCPU creation.”h]”hX€  ARCH_REQ_XCOMP_GUEST_PERM is a variant of ARCH_REQ_XCOMP_PERM. It has the
same semantics for the guest permission. While providing a similar
functionality, this comes with a constraint. Permission is frozen when the
first VCPU is created. Any attempt to change permission after that point
is going to be rejected. So, the permission has to be requested before the
first VCPU creation.”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¦hj/  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjü  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jB  hjš  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1j=  hŸh¶h Kšhj{  hžhubh¸)”}”(hŒ“Note that some VMMs may have already established a set of supported state
components. These options are not presumed to support any particular VMM.”h]”hŒ“Note that some VMMs may have already established a set of supported state
components. These options are not presumed to support any particular VMM.”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K­hj{  hžhubeh}”(h]”Œ%dynamic-features-for-virtual-machines”ah ]”h"]”Œ%dynamic features for virtual machines”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K”ubeh}”(h]”Œ0using-xstate-features-in-user-space-applications”ah ]”h"]”Œ0using xstate features in user space applications”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”j¢  Œ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|  jy  j  j  jQ  jN  jI  jF  jx  ju  jt  jq  uŒ	nametypes”}”(j|  ‰j  ‰jQ  ‰jI  ‰jx  ‰jt  ‰uh}”(jy  h£j  hÕjN  j  jF  j©  ju  jT  jq  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.