1*4882a593Smuzhiyun /****************************************************************************** 2*4882a593Smuzhiyun * arch-x86/cpuid.h 3*4882a593Smuzhiyun * 4*4882a593Smuzhiyun * CPUID interface to Xen. 5*4882a593Smuzhiyun * 6*4882a593Smuzhiyun * Permission is hereby granted, free of charge, to any person obtaining a copy 7*4882a593Smuzhiyun * of this software and associated documentation files (the "Software"), to 8*4882a593Smuzhiyun * deal in the Software without restriction, including without limitation the 9*4882a593Smuzhiyun * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 10*4882a593Smuzhiyun * sell copies of the Software, and to permit persons to whom the Software is 11*4882a593Smuzhiyun * furnished to do so, subject to the following conditions: 12*4882a593Smuzhiyun * 13*4882a593Smuzhiyun * The above copyright notice and this permission notice shall be included in 14*4882a593Smuzhiyun * all copies or substantial portions of the Software. 15*4882a593Smuzhiyun * 16*4882a593Smuzhiyun * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17*4882a593Smuzhiyun * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18*4882a593Smuzhiyun * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 19*4882a593Smuzhiyun * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20*4882a593Smuzhiyun * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21*4882a593Smuzhiyun * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 22*4882a593Smuzhiyun * DEALINGS IN THE SOFTWARE. 23*4882a593Smuzhiyun * 24*4882a593Smuzhiyun * Copyright (c) 2007 Citrix Systems, Inc. 25*4882a593Smuzhiyun * 26*4882a593Smuzhiyun * Authors: 27*4882a593Smuzhiyun * Keir Fraser <keir@xen.org> 28*4882a593Smuzhiyun */ 29*4882a593Smuzhiyun 30*4882a593Smuzhiyun #ifndef __XEN_PUBLIC_ARCH_X86_CPUID_H__ 31*4882a593Smuzhiyun #define __XEN_PUBLIC_ARCH_X86_CPUID_H__ 32*4882a593Smuzhiyun 33*4882a593Smuzhiyun /* 34*4882a593Smuzhiyun * For compatibility with other hypervisor interfaces, the Xen cpuid leaves 35*4882a593Smuzhiyun * can be found at the first otherwise unused 0x100 aligned boundary starting 36*4882a593Smuzhiyun * from 0x40000000. 37*4882a593Smuzhiyun * 38*4882a593Smuzhiyun * e.g If viridian extensions are enabled for an HVM domain, the Xen cpuid 39*4882a593Smuzhiyun * leaves will start at 0x40000100 40*4882a593Smuzhiyun */ 41*4882a593Smuzhiyun 42*4882a593Smuzhiyun #define XEN_CPUID_FIRST_LEAF 0x40000000 43*4882a593Smuzhiyun #define XEN_CPUID_LEAF(i) (XEN_CPUID_FIRST_LEAF + (i)) 44*4882a593Smuzhiyun 45*4882a593Smuzhiyun /* 46*4882a593Smuzhiyun * Leaf 1 (0x40000x00) 47*4882a593Smuzhiyun * EAX: Largest Xen-information leaf. All leaves up to an including @EAX 48*4882a593Smuzhiyun * are supported by the Xen host. 49*4882a593Smuzhiyun * EBX-EDX: "XenVMMXenVMM" signature, allowing positive identification 50*4882a593Smuzhiyun * of a Xen host. 51*4882a593Smuzhiyun */ 52*4882a593Smuzhiyun #define XEN_CPUID_SIGNATURE_EBX 0x566e6558 /* "XenV" */ 53*4882a593Smuzhiyun #define XEN_CPUID_SIGNATURE_ECX 0x65584d4d /* "MMXe" */ 54*4882a593Smuzhiyun #define XEN_CPUID_SIGNATURE_EDX 0x4d4d566e /* "nVMM" */ 55*4882a593Smuzhiyun 56*4882a593Smuzhiyun /* 57*4882a593Smuzhiyun * Leaf 2 (0x40000x01) 58*4882a593Smuzhiyun * EAX[31:16]: Xen major version. 59*4882a593Smuzhiyun * EAX[15: 0]: Xen minor version. 60*4882a593Smuzhiyun * EBX-EDX: Reserved (currently all zeroes). 61*4882a593Smuzhiyun */ 62*4882a593Smuzhiyun 63*4882a593Smuzhiyun /* 64*4882a593Smuzhiyun * Leaf 3 (0x40000x02) 65*4882a593Smuzhiyun * EAX: Number of hypercall transfer pages. This register is always guaranteed 66*4882a593Smuzhiyun * to specify one hypercall page. 67*4882a593Smuzhiyun * EBX: Base address of Xen-specific MSRs. 68*4882a593Smuzhiyun * ECX: Features 1. Unused bits are set to zero. 69*4882a593Smuzhiyun * EDX: Features 2. Unused bits are set to zero. 70*4882a593Smuzhiyun */ 71*4882a593Smuzhiyun 72*4882a593Smuzhiyun /* Does the host support MMU_PT_UPDATE_PRESERVE_AD for this guest? */ 73*4882a593Smuzhiyun #define _XEN_CPUID_FEAT1_MMU_PT_UPDATE_PRESERVE_AD 0 74*4882a593Smuzhiyun #define XEN_CPUID_FEAT1_MMU_PT_UPDATE_PRESERVE_AD (1u<<0) 75*4882a593Smuzhiyun 76*4882a593Smuzhiyun /* 77*4882a593Smuzhiyun * Leaf 4 (0x40000x03) 78*4882a593Smuzhiyun * Sub-leaf 0: EAX: bit 0: emulated tsc 79*4882a593Smuzhiyun * bit 1: host tsc is known to be reliable 80*4882a593Smuzhiyun * bit 2: RDTSCP instruction available 81*4882a593Smuzhiyun * EBX: tsc_mode: 0=default (emulate if necessary), 1=emulate, 82*4882a593Smuzhiyun * 2=no emulation, 3=no emulation + TSC_AUX support 83*4882a593Smuzhiyun * ECX: guest tsc frequency in kHz 84*4882a593Smuzhiyun * EDX: guest tsc incarnation (migration count) 85*4882a593Smuzhiyun * Sub-leaf 1: EAX: tsc offset low part 86*4882a593Smuzhiyun * EBX: tsc offset high part 87*4882a593Smuzhiyun * ECX: multiplicator for tsc->ns conversion 88*4882a593Smuzhiyun * EDX: shift amount for tsc->ns conversion 89*4882a593Smuzhiyun * Sub-leaf 2: EAX: host tsc frequency in kHz 90*4882a593Smuzhiyun */ 91*4882a593Smuzhiyun 92*4882a593Smuzhiyun /* 93*4882a593Smuzhiyun * Leaf 5 (0x40000x04) 94*4882a593Smuzhiyun * HVM-specific features 95*4882a593Smuzhiyun * Sub-leaf 0: EAX: Features 96*4882a593Smuzhiyun * Sub-leaf 0: EBX: vcpu id (iff EAX has XEN_HVM_CPUID_VCPU_ID_PRESENT flag) 97*4882a593Smuzhiyun */ 98*4882a593Smuzhiyun #define XEN_HVM_CPUID_APIC_ACCESS_VIRT (1u << 0) /* Virtualized APIC registers */ 99*4882a593Smuzhiyun #define XEN_HVM_CPUID_X2APIC_VIRT (1u << 1) /* Virtualized x2APIC accesses */ 100*4882a593Smuzhiyun /* Memory mapped from other domains has valid IOMMU entries */ 101*4882a593Smuzhiyun #define XEN_HVM_CPUID_IOMMU_MAPPINGS (1u << 2) 102*4882a593Smuzhiyun #define XEN_HVM_CPUID_VCPU_ID_PRESENT (1u << 3) /* vcpu id is present in EBX */ 103*4882a593Smuzhiyun 104*4882a593Smuzhiyun /* 105*4882a593Smuzhiyun * Leaf 6 (0x40000x05) 106*4882a593Smuzhiyun * PV-specific parameters 107*4882a593Smuzhiyun * Sub-leaf 0: EAX: max available sub-leaf 108*4882a593Smuzhiyun * Sub-leaf 0: EBX: bits 0-7: max machine address width 109*4882a593Smuzhiyun */ 110*4882a593Smuzhiyun 111*4882a593Smuzhiyun /* Max. address width in bits taking memory hotplug into account. */ 112*4882a593Smuzhiyun #define XEN_CPUID_MACHINE_ADDRESS_WIDTH_MASK (0xffu << 0) 113*4882a593Smuzhiyun 114*4882a593Smuzhiyun #define XEN_CPUID_MAX_NUM_LEAVES 5 115*4882a593Smuzhiyun 116*4882a593Smuzhiyun #endif /* __XEN_PUBLIC_ARCH_X86_CPUID_H__ */ 117