    /*
     * arch-x86/cpufeatureset.h
     *
     * CPU featureset definitions
     *
     * Permission is hereby granted, free of charge, to any person obtaining a copy
     * of this software and associated documentation files (the "Software"), to
     * deal in the Software without restriction, including without limitation the
     * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
     * sell copies of the Software, and to permit persons to whom the Software is
     * furnished to do so, subject to the following conditions:
     *
     * The above copyright notice and this permission notice shall be included in
     * all copies or substantial portions of the Software.
     *
     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
     * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     * DEALINGS IN THE SOFTWARE.
     *
     * Copyright (c) 2015, 2016 Citrix Systems, Inc.
     */

    /*
     * There are two expected ways of including this header.
     *
     * 1) The "default" case (expected from tools etc).
     *
     * Simply #include <public/arch-x86/cpufeatureset.h>
     *
     * In this circumstance, normal header guards apply and the includer shall get
     * an enumeration in the XEN_X86_FEATURE_xxx namespace.
     *
     * 2) The special case where the includer provides XEN_CPUFEATURE() in scope.
     *
     * In this case, no inclusion guards apply and the caller is responsible for
     * their XEN_CPUFEATURE() being appropriate in the included context.
     */

    #ifndef XEN_CPUFEATURE

    /*
     * Includer has not provided a custom XEN_CPUFEATURE().  Arrange for normal
     * header guards, an enum and constants in the XEN_X86_FEATURE_xxx namespace.
     */
    #ifndef __XEN_PUBLIC_ARCH_X86_CPUFEATURESET_H__
    #define __XEN_PUBLIC_ARCH_X86_CPUFEATURESET_H__

    #define XEN_CPUFEATURESET_DEFAULT_INCLUDE

    #define XEN_CPUFEATURE(name, value) XEN_X86_FEATURE_##name = value,
    enum {

    #endif /* __XEN_PUBLIC_ARCH_X86_CPUFEATURESET_H__ */
    #endif /* !XEN_CPUFEATURE */

    #ifdef XEN_CPUFEATURE
    /*
     * A featureset is a bitmap of x86 features, represented as a collection of
     * 32bit words.
     *
     * Words are as specified in vendors programming manuals, and shall not
     * contain any synthesied values.  New words may be added to the end of
     * featureset.
     *
     * All featureset words currently originate from leaves specified for the
     * CPUID instruction, but this is not preclude other sources of information.
     */

    /*
     * Attribute syntax:
     *
     * Attributes for a particular feature are provided as characters before the
     * first space in the comment immediately following the feature value.  Note -
     * none of these attributes form part of the Xen public ABI.
     *
     * Special: '!'
     *   This bit has special properties and is not a straight indication of a
     *   piece of new functionality.  Xen will handle these differently,
     *   and may override toolstack settings completely.
     *
     * Applicability to guests: 'A', 'S' or 'H'
     *   'A' = All guests.
     *   'S' = All HVM guests (not PV guests).
     *   'H' = HVM HAP guests (not PV or HVM Shadow guests).
     */

    /* Intel-defined CPU features, CPUID level 0x00000001.edx, word 0 */
    XEN_CPUFEATURE(FPU,           0*32+ 0) /*A  Onboard FPU */
    XEN_CPUFEATURE(VME,           0*32+ 1) /*S  Virtual Mode Extensions */
    XEN_CPUFEATURE(DE,            0*32+ 2) /*A  Debugging Extensions */
    XEN_CPUFEATURE(PSE,           0*32+ 3) /*S  Page Size Extensions */
    XEN_CPUFEATURE(TSC,           0*32+ 4) /*A  Time Stamp Counter */
    XEN_CPUFEATURE(MSR,           0*32+ 5) /*A  Model-Specific Registers, RDMSR, WRMSR */
    XEN_CPUFEATURE(PAE,           0*32+ 6) /*A  Physical Address Extensions */
    XEN_CPUFEATURE(MCE,           0*32+ 7) /*A  Machine Check Architecture */
    XEN_CPUFEATURE(CX8,           0*32+ 8) /*A  CMPXCHG8 instruction */
    XEN_CPUFEATURE(APIC,          0*32+ 9) /*!A Onboard APIC */
    XEN_CPUFEATURE(SEP,           0*32+11) /*A  SYSENTER/SYSEXIT */
    XEN_CPUFEATURE(MTRR,          0*32+12) /*S  Memory Type Range Registers */
    XEN_CPUFEATURE(PGE,           0*32+13) /*S  Page Global Enable */
    XEN_CPUFEATURE(MCA,           0*32+14) /*A  Machine Check Architecture */
    XEN_CPUFEATURE(CMOV,          0*32+15) /*A  CMOV instruction (FCMOVCC and FCOMI too if FPU present) */
    XEN_CPUFEATURE(PAT,           0*32+16) /*A  Page Attribute Table */
    XEN_CPUFEATURE(PSE36,         0*32+17) /*S  36-bit PSEs */
    XEN_CPUFEATURE(CLFLUSH,       0*32+19) /*A  CLFLUSH instruction */
    XEN_CPUFEATURE(DS,            0*32+21) /*   Debug Store */
    XEN_CPUFEATURE(ACPI,          0*32+22) /*A  ACPI via MSR */
    XEN_CPUFEATURE(MMX,           0*32+23) /*A  Multimedia Extensions */
    XEN_CPUFEATURE(FXSR,          0*32+24) /*A  FXSAVE and FXRSTOR instructions */
    XEN_CPUFEATURE(SSE,           0*32+25) /*A  Streaming SIMD Extensions */
    XEN_CPUFEATURE(SSE2,          0*32+26) /*A  Streaming SIMD Extensions-2 */
    XEN_CPUFEATURE(SS,            0*32+27) /*A  CPU self snoop */
    XEN_CPUFEATURE(HTT,           0*32+28) /*!A Hyper-Threading Technology */
    XEN_CPUFEATURE(TM1,           0*32+29) /*   Thermal Monitor 1 */
    XEN_CPUFEATURE(PBE,           0*32+31) /*   Pending Break Enable */

    /* Intel-defined CPU features, CPUID level 0x00000001.ecx, word 1 */
    XEN_CPUFEATURE(SSE3,          1*32+ 0) /*A  Streaming SIMD Extensions-3 */
    XEN_CPUFEATURE(PCLMULQDQ,     1*32+ 1) /*A  Carry-less mulitplication */
    XEN_CPUFEATURE(DTES64,        1*32+ 2) /*   64-bit Debug Store */
    XEN_CPUFEATURE(MONITOR,       1*32+ 3) /*   Monitor/Mwait support */
    XEN_CPUFEATURE(DSCPL,         1*32+ 4) /*   CPL Qualified Debug Store */
    XEN_CPUFEATURE(VMX,           1*32+ 5) /*S  Virtual Machine Extensions */
    XEN_CPUFEATURE(SMX,           1*32+ 6) /*   Safer Mode Extensions */
    XEN_CPUFEATURE(EIST,          1*32+ 7) /*   Enhanced SpeedStep */
    XEN_CPUFEATURE(TM2,           1*32+ 8) /*   Thermal Monitor 2 */
    XEN_CPUFEATURE(SSSE3,         1*32+ 9) /*A  Supplemental Streaming SIMD Extensions-3 */
    XEN_CPUFEATURE(FMA,           1*32+12) /*A  Fused Multiply Add */
    XEN_CPUFEATURE(CX16,          1*32+13) /*A  CMPXCHG16B */
    XEN_CPUFEATURE(XTPR,          1*32+14) /*   Send Task Priority Messages */
    XEN_CPUFEATURE(PDCM,          1*32+15) /*   Perf/Debug Capability MSR */
    XEN_CPUFEATURE(PCID,          1*32+17) /*H  Process Context ID */
    XEN_CPUFEATURE(DCA,           1*32+18) /*   Direct Cache Access */
    XEN_CPUFEATURE(SSE4_1,        1*32+19) /*A  Streaming SIMD Extensions 4.1 */
    XEN_CPUFEATURE(SSE4_2,        1*32+20) /*A  Streaming SIMD Extensions 4.2 */
    XEN_CPUFEATURE(X2APIC,        1*32+21) /*!A Extended xAPIC */
    XEN_CPUFEATURE(MOVBE,         1*32+22) /*A  movbe instruction */
    XEN_CPUFEATURE(POPCNT,        1*32+23) /*A  POPCNT instruction */
    XEN_CPUFEATURE(TSC_DEADLINE,  1*32+24) /*S  TSC Deadline Timer */
    XEN_CPUFEATURE(AESNI,         1*32+25) /*A  AES instructions */
    XEN_CPUFEATURE(XSAVE,         1*32+26) /*A  XSAVE/XRSTOR/XSETBV/XGETBV */
    XEN_CPUFEATURE(OSXSAVE,       1*32+27) /*!  OSXSAVE */
    XEN_CPUFEATURE(AVX,           1*32+28) /*A  Advanced Vector Extensions */
    XEN_CPUFEATURE(F16C,          1*32+29) /*A  Half-precision convert instruction */
    XEN_CPUFEATURE(RDRAND,        1*32+30) /*A  Digital Random Number Generator */
    XEN_CPUFEATURE(HYPERVISOR,    1*32+31) /*!A Running under some hypervisor */

    /* AMD-defined CPU features, CPUID level 0x80000001.edx, word 2 */
    XEN_CPUFEATURE(SYSCALL,       2*32+11) /*A  SYSCALL/SYSRET */
    XEN_CPUFEATURE(NX,            2*32+20) /*A  Execute Disable */
    XEN_CPUFEATURE(MMXEXT,        2*32+22) /*A  AMD MMX extensions */
    XEN_CPUFEATURE(FFXSR,         2*32+25) /*A  FFXSR instruction optimizations */
    XEN_CPUFEATURE(PAGE1GB,       2*32+26) /*H  1Gb large page support */
    XEN_CPUFEATURE(RDTSCP,        2*32+27) /*S  RDTSCP */
    XEN_CPUFEATURE(LM,            2*32+29) /*A  Long Mode (x86-64) */
    XEN_CPUFEATURE(3DNOWEXT,      2*32+30) /*A  AMD 3DNow! extensions */
    XEN_CPUFEATURE(3DNOW,         2*32+31) /*A  3DNow! */

    /* AMD-defined CPU features, CPUID level 0x80000001.ecx, word 3 */
    XEN_CPUFEATURE(LAHF_LM,       3*32+ 0) /*A  LAHF/SAHF in long mode */
    XEN_CPUFEATURE(CMP_LEGACY,    3*32+ 1) /*!A If yes HyperThreading not valid */
    XEN_CPUFEATURE(SVM,           3*32+ 2) /*S  Secure virtual machine */
    XEN_CPUFEATURE(EXTAPIC,       3*32+ 3) /*   Extended APIC space */
    XEN_CPUFEATURE(CR8_LEGACY,    3*32+ 4) /*S  CR8 in 32-bit mode */
    XEN_CPUFEATURE(ABM,           3*32+ 5) /*A  Advanced bit manipulation */
    XEN_CPUFEATURE(SSE4A,         3*32+ 6) /*A  SSE-4A */
    XEN_CPUFEATURE(MISALIGNSSE,   3*32+ 7) /*A  Misaligned SSE mode */
    XEN_CPUFEATURE(3DNOWPREFETCH, 3*32+ 8) /*A  3DNow prefetch instructions */
    XEN_CPUFEATURE(OSVW,          3*32+ 9) /*   OS Visible Workaround */
    XEN_CPUFEATURE(IBS,           3*32+10) /*   Instruction Based Sampling */
    XEN_CPUFEATURE(XOP,           3*32+11) /*A  extended AVX instructions */
    XEN_CPUFEATURE(SKINIT,        3*32+12) /*   SKINIT/STGI instructions */
    XEN_CPUFEATURE(WDT,           3*32+13) /*   Watchdog timer */
    XEN_CPUFEATURE(LWP,           3*32+15) /*S  Light Weight Profiling */
    XEN_CPUFEATURE(FMA4,          3*32+16) /*A  4 operands MAC instructions */
    XEN_CPUFEATURE(NODEID_MSR,    3*32+19) /*   NodeId MSR */
    XEN_CPUFEATURE(TBM,           3*32+21) /*A  trailing bit manipulations */
    XEN_CPUFEATURE(TOPOEXT,       3*32+22) /*   topology extensions CPUID leafs */
    XEN_CPUFEATURE(DBEXT,         3*32+26) /*A  data breakpoint extension */
    XEN_CPUFEATURE(MONITORX,      3*32+29) /*   MONITOR extension (MONITORX/MWAITX) */

    /* Intel-defined CPU features, CPUID level 0x0000000D:1.eax, word 4 */
    XEN_CPUFEATURE(XSAVEOPT,      4*32+ 0) /*A  XSAVEOPT instruction */
    XEN_CPUFEATURE(XSAVEC,        4*32+ 1) /*A  XSAVEC/XRSTORC instructions */
    XEN_CPUFEATURE(XGETBV1,       4*32+ 2) /*A  XGETBV with %ecx=1 */
    XEN_CPUFEATURE(XSAVES,        4*32+ 3) /*S  XSAVES/XRSTORS instructions */

    /* Intel-defined CPU features, CPUID level 0x00000007:0.ebx, word 5 */
    XEN_CPUFEATURE(FSGSBASE,      5*32+ 0) /*A  {RD,WR}{FS,GS}BASE instructions */
    XEN_CPUFEATURE(TSC_ADJUST,    5*32+ 1) /*S  TSC_ADJUST MSR available */
    XEN_CPUFEATURE(SGX,           5*32+ 2) /*   Software Guard extensions */
    XEN_CPUFEATURE(BMI1,          5*32+ 3) /*A  1st bit manipulation extensions */
    XEN_CPUFEATURE(HLE,           5*32+ 4) /*A  Hardware Lock Elision */
    XEN_CPUFEATURE(AVX2,          5*32+ 5) /*A  AVX2 instructions */
    XEN_CPUFEATURE(FDP_EXCP_ONLY, 5*32+ 6) /*!  x87 FDP only updated on exception. */
    XEN_CPUFEATURE(SMEP,          5*32+ 7) /*S  Supervisor Mode Execution Protection */
    XEN_CPUFEATURE(BMI2,          5*32+ 8) /*A  2nd bit manipulation extensions */
    XEN_CPUFEATURE(ERMS,          5*32+ 9) /*A  Enhanced REP MOVSB/STOSB */
    XEN_CPUFEATURE(INVPCID,       5*32+10) /*H  Invalidate Process Context ID */
    XEN_CPUFEATURE(RTM,           5*32+11) /*A  Restricted Transactional Memory */
    XEN_CPUFEATURE(PQM,           5*32+12) /*   Platform QoS Monitoring */
    XEN_CPUFEATURE(NO_FPU_SEL,    5*32+13) /*!  FPU CS/DS stored as zero */
    XEN_CPUFEATURE(MPX,           5*32+14) /*S  Memory Protection Extensions */
    XEN_CPUFEATURE(PQE,           5*32+15) /*   Platform QoS Enforcement */
    XEN_CPUFEATURE(AVX512F,       5*32+16) /*A  AVX-512 Foundation Instructions */
    XEN_CPUFEATURE(AVX512DQ,      5*32+17) /*A  AVX-512 Doubleword & Quadword Instrs */
    XEN_CPUFEATURE(RDSEED,        5*32+18) /*A  RDSEED instruction */
    XEN_CPUFEATURE(ADX,           5*32+19) /*A  ADCX, ADOX instructions */
    XEN_CPUFEATURE(SMAP,          5*32+20) /*S  Supervisor Mode Access Prevention */
    XEN_CPUFEATURE(AVX512IFMA,    5*32+21) /*A  AVX-512 Integer Fused Multiply Add */
    XEN_CPUFEATURE(CLFLUSHOPT,    5*32+23) /*A  CLFLUSHOPT instruction */
    XEN_CPUFEATURE(CLWB,          5*32+24) /*A  CLWB instruction */
    XEN_CPUFEATURE(AVX512PF,      5*32+26) /*A  AVX-512 Prefetch Instructions */
    XEN_CPUFEATURE(AVX512ER,      5*32+27) /*A  AVX-512 Exponent & Reciprocal Instrs */
    XEN_CPUFEATURE(AVX512CD,      5*32+28) /*A  AVX-512 Conflict Detection Instrs */
    XEN_CPUFEATURE(SHA,           5*32+29) /*A  SHA1 & SHA256 instructions */
    XEN_CPUFEATURE(AVX512BW,      5*32+30) /*A  AVX-512 Byte and Word Instructions */
    XEN_CPUFEATURE(AVX512VL,      5*32+31) /*A  AVX-512 Vector Length Extensions */

    /* Intel-defined CPU features, CPUID level 0x00000007:0.ecx, word 6 */
    XEN_CPUFEATURE(PREFETCHWT1,   6*32+ 0) /*A  PREFETCHWT1 instruction */
    XEN_CPUFEATURE(AVX512VBMI,    6*32+ 1) /*A  AVX-512 Vector Byte Manipulation Instrs */
    XEN_CPUFEATURE(PKU,           6*32+ 3) /*H  Protection Keys for Userspace */
    XEN_CPUFEATURE(OSPKE,         6*32+ 4) /*!  OS Protection Keys Enable */
    XEN_CPUFEATURE(AVX512_VPOPCNTDQ, 6*32+14) /*A  POPCNT for vectors of DW/QW */
    XEN_CPUFEATURE(RDPID,         6*32+22) /*A  RDPID instruction */

    /* AMD-defined CPU features, CPUID level 0x80000007.edx, word 7 */
    XEN_CPUFEATURE(ITSC,          7*32+ 8) /*   Invariant TSC */
    XEN_CPUFEATURE(EFRO,          7*32+10) /*   APERF/MPERF Read Only interface */

    /* AMD-defined CPU features, CPUID level 0x80000008.ebx, word 8 */
    XEN_CPUFEATURE(CLZERO,        8*32+ 0) /*A  CLZERO instruction */

    /* Intel-defined CPU features, CPUID level 0x00000007:0.edx, word 9 */
    XEN_CPUFEATURE(AVX512_4VNNIW, 9*32+ 2) /*A AVX512 Neural Network Instructions */
    XEN_CPUFEATURE(AVX512_4FMAPS, 9*32+ 3) /*A AVX512 Multiply Accumulation Single Precision */

    #endif /* XEN_CPUFEATURE */

    /* Clean up from a default include.  Close the enum (for C). */
    #ifdef XEN_CPUFEATURESET_DEFAULT_INCLUDE
    #undef XEN_CPUFEATURESET_DEFAULT_INCLUDE
    #undef XEN_CPUFEATURE
    };

    #endif /* XEN_CPUFEATURESET_DEFAULT_INCLUDE */

    /*
     * Local variables:
     * mode: C
     * c-file-style: "BSD"
     * c-basic-offset: 4
     * tab-width: 4
     * indent-tabs-mode: nil
     * End:
     */