15f6caa4fSJan Kiszka#!/usr/bin/python 25f6caa4fSJan Kiszka# 35f6caa4fSJan Kiszka# tool for querying VMX capabilities 45f6caa4fSJan Kiszka# 55f6caa4fSJan Kiszka# Copyright 2009-2010 Red Hat, Inc. 65f6caa4fSJan Kiszka# 75f6caa4fSJan Kiszka# Authors: 85f6caa4fSJan Kiszka# Avi Kivity <avi@redhat.com> 95f6caa4fSJan Kiszka# 105f6caa4fSJan Kiszka# This work is licensed under the terms of the GNU GPL, version 2. See 115f6caa4fSJan Kiszka# the COPYING file in the top-level directory. 125f6caa4fSJan Kiszka 135f6caa4fSJan KiszkaMSR_IA32_VMX_BASIC = 0x480 145f6caa4fSJan KiszkaMSR_IA32_VMX_PINBASED_CTLS = 0x481 155f6caa4fSJan KiszkaMSR_IA32_VMX_PROCBASED_CTLS = 0x482 165f6caa4fSJan KiszkaMSR_IA32_VMX_EXIT_CTLS = 0x483 175f6caa4fSJan KiszkaMSR_IA32_VMX_ENTRY_CTLS = 0x484 185f6caa4fSJan KiszkaMSR_IA32_VMX_MISC_CTLS = 0x485 195f6caa4fSJan KiszkaMSR_IA32_VMX_PROCBASED_CTLS2 = 0x48B 205f6caa4fSJan KiszkaMSR_IA32_VMX_EPT_VPID_CAP = 0x48C 215f6caa4fSJan KiszkaMSR_IA32_VMX_TRUE_PINBASED_CTLS = 0x48D 225f6caa4fSJan KiszkaMSR_IA32_VMX_TRUE_PROCBASED_CTLS = 0x48E 235f6caa4fSJan KiszkaMSR_IA32_VMX_TRUE_EXIT_CTLS = 0x48F 245f6caa4fSJan KiszkaMSR_IA32_VMX_TRUE_ENTRY_CTLS = 0x490 25287d55c6SAvi KivityMSR_IA32_VMX_VMFUNC = 0x491 265f6caa4fSJan Kiszka 275f6caa4fSJan Kiszkaclass msr(object): 285f6caa4fSJan Kiszka def __init__(self): 295f6caa4fSJan Kiszka try: 30*c3e31eaaSPaolo Bonzini self.f = open('/dev/cpu/0/msr', 'rb', 0) 315f6caa4fSJan Kiszka except: 32*c3e31eaaSPaolo Bonzini self.f = open('/dev/msr0', 'rb', 0) 335f6caa4fSJan Kiszka def read(self, index, default = None): 345f6caa4fSJan Kiszka import struct 355f6caa4fSJan Kiszka self.f.seek(index) 365f6caa4fSJan Kiszka try: 375f6caa4fSJan Kiszka return struct.unpack('Q', self.f.read(8))[0] 385f6caa4fSJan Kiszka except: 395f6caa4fSJan Kiszka return default 405f6caa4fSJan Kiszka 415f6caa4fSJan Kiszkaclass Control(object): 425f6caa4fSJan Kiszka def __init__(self, name, bits, cap_msr, true_cap_msr = None): 435f6caa4fSJan Kiszka self.name = name 445f6caa4fSJan Kiszka self.bits = bits 455f6caa4fSJan Kiszka self.cap_msr = cap_msr 465f6caa4fSJan Kiszka self.true_cap_msr = true_cap_msr 475f6caa4fSJan Kiszka def read2(self, nr): 485f6caa4fSJan Kiszka m = msr() 495f6caa4fSJan Kiszka val = m.read(nr, 0) 505f6caa4fSJan Kiszka return (val & 0xffffffff, val >> 32) 515f6caa4fSJan Kiszka def show(self): 52*c3e31eaaSPaolo Bonzini print(self.name) 535f6caa4fSJan Kiszka mbz, mb1 = self.read2(self.cap_msr) 545f6caa4fSJan Kiszka tmbz, tmb1 = 0, 0 555f6caa4fSJan Kiszka if self.true_cap_msr: 565f6caa4fSJan Kiszka tmbz, tmb1 = self.read2(self.true_cap_msr) 575f6caa4fSJan Kiszka for bit in sorted(self.bits.keys()): 585f6caa4fSJan Kiszka zero = not (mbz & (1 << bit)) 595f6caa4fSJan Kiszka one = mb1 & (1 << bit) 605f6caa4fSJan Kiszka true_zero = not (tmbz & (1 << bit)) 615f6caa4fSJan Kiszka true_one = tmb1 & (1 << bit) 625f6caa4fSJan Kiszka s= '?' 635f6caa4fSJan Kiszka if (self.true_cap_msr and true_zero and true_one 645f6caa4fSJan Kiszka and one and not zero): 655f6caa4fSJan Kiszka s = 'default' 665f6caa4fSJan Kiszka elif zero and not one: 675f6caa4fSJan Kiszka s = 'no' 685f6caa4fSJan Kiszka elif one and not zero: 695f6caa4fSJan Kiszka s = 'forced' 705f6caa4fSJan Kiszka elif one and zero: 715f6caa4fSJan Kiszka s = 'yes' 72*c3e31eaaSPaolo Bonzini print(' %-40s %s' % (self.bits[bit], s)) 735f6caa4fSJan Kiszka 745f6caa4fSJan Kiszkaclass Misc(object): 755f6caa4fSJan Kiszka def __init__(self, name, bits, msr): 765f6caa4fSJan Kiszka self.name = name 775f6caa4fSJan Kiszka self.bits = bits 785f6caa4fSJan Kiszka self.msr = msr 795f6caa4fSJan Kiszka def show(self): 80*c3e31eaaSPaolo Bonzini print(self.name) 815f6caa4fSJan Kiszka value = msr().read(self.msr, 0) 82*c3e31eaaSPaolo Bonzini print(' Hex: 0x%x' % (value)) 835f6caa4fSJan Kiszka def first_bit(key): 845f6caa4fSJan Kiszka if type(key) is tuple: 855f6caa4fSJan Kiszka return key[0] 865f6caa4fSJan Kiszka else: 875f6caa4fSJan Kiszka return key 885f6caa4fSJan Kiszka for bits in sorted(self.bits.keys(), key = first_bit): 895f6caa4fSJan Kiszka if type(bits) is tuple: 905f6caa4fSJan Kiszka lo, hi = bits 915f6caa4fSJan Kiszka fmt = int 925f6caa4fSJan Kiszka else: 935f6caa4fSJan Kiszka lo = hi = bits 945f6caa4fSJan Kiszka def fmt(x): 955f6caa4fSJan Kiszka return { True: 'yes', False: 'no' }[x] 965f6caa4fSJan Kiszka v = (value >> lo) & ((1 << (hi - lo + 1)) - 1) 97*c3e31eaaSPaolo Bonzini print(' %-40s %s' % (self.bits[bits], fmt(v))) 985f6caa4fSJan Kiszka 995f6caa4fSJan Kiszkacontrols = [ 100ea4ee283SJan Kiszka Misc( 101ea4ee283SJan Kiszka name = 'Basic VMX Information', 102ea4ee283SJan Kiszka bits = { 103c5d1e2ccSAdrian-Ken Rueegsegger (0, 30): 'Revision', 104ea4ee283SJan Kiszka (32,44): 'VMCS size', 105ea4ee283SJan Kiszka 48: 'VMCS restricted to 32 bit addresses', 106ea4ee283SJan Kiszka 49: 'Dual-monitor support', 107ea4ee283SJan Kiszka (50, 53): 'VMCS memory type', 108ea4ee283SJan Kiszka 54: 'INS/OUTS instruction information', 109ea4ee283SJan Kiszka 55: 'IA32_VMX_TRUE_*_CTLS support', 110ea4ee283SJan Kiszka }, 111ea4ee283SJan Kiszka msr = MSR_IA32_VMX_BASIC, 112ea4ee283SJan Kiszka ), 1135f6caa4fSJan Kiszka Control( 1145f6caa4fSJan Kiszka name = 'pin-based controls', 1155f6caa4fSJan Kiszka bits = { 1165f6caa4fSJan Kiszka 0: 'External interrupt exiting', 1175f6caa4fSJan Kiszka 3: 'NMI exiting', 1185f6caa4fSJan Kiszka 5: 'Virtual NMIs', 1195f6caa4fSJan Kiszka 6: 'Activate VMX-preemption timer', 120ea4ee283SJan Kiszka 7: 'Process posted interrupts', 1215f6caa4fSJan Kiszka }, 1225f6caa4fSJan Kiszka cap_msr = MSR_IA32_VMX_PINBASED_CTLS, 1235f6caa4fSJan Kiszka true_cap_msr = MSR_IA32_VMX_TRUE_PINBASED_CTLS, 1245f6caa4fSJan Kiszka ), 1255f6caa4fSJan Kiszka 1265f6caa4fSJan Kiszka Control( 1275f6caa4fSJan Kiszka name = 'primary processor-based controls', 1285f6caa4fSJan Kiszka bits = { 1295f6caa4fSJan Kiszka 2: 'Interrupt window exiting', 1305f6caa4fSJan Kiszka 3: 'Use TSC offsetting', 1315f6caa4fSJan Kiszka 7: 'HLT exiting', 1325f6caa4fSJan Kiszka 9: 'INVLPG exiting', 1335f6caa4fSJan Kiszka 10: 'MWAIT exiting', 1345f6caa4fSJan Kiszka 11: 'RDPMC exiting', 1355f6caa4fSJan Kiszka 12: 'RDTSC exiting', 1365f6caa4fSJan Kiszka 15: 'CR3-load exiting', 1375f6caa4fSJan Kiszka 16: 'CR3-store exiting', 1385f6caa4fSJan Kiszka 19: 'CR8-load exiting', 1395f6caa4fSJan Kiszka 20: 'CR8-store exiting', 1405f6caa4fSJan Kiszka 21: 'Use TPR shadow', 1415f6caa4fSJan Kiszka 22: 'NMI-window exiting', 1425f6caa4fSJan Kiszka 23: 'MOV-DR exiting', 1435f6caa4fSJan Kiszka 24: 'Unconditional I/O exiting', 1445f6caa4fSJan Kiszka 25: 'Use I/O bitmaps', 1455f6caa4fSJan Kiszka 27: 'Monitor trap flag', 1465f6caa4fSJan Kiszka 28: 'Use MSR bitmaps', 1475f6caa4fSJan Kiszka 29: 'MONITOR exiting', 1485f6caa4fSJan Kiszka 30: 'PAUSE exiting', 1495f6caa4fSJan Kiszka 31: 'Activate secondary control', 1505f6caa4fSJan Kiszka }, 1515f6caa4fSJan Kiszka cap_msr = MSR_IA32_VMX_PROCBASED_CTLS, 1525f6caa4fSJan Kiszka true_cap_msr = MSR_IA32_VMX_TRUE_PROCBASED_CTLS, 1535f6caa4fSJan Kiszka ), 1545f6caa4fSJan Kiszka 1555f6caa4fSJan Kiszka Control( 1565f6caa4fSJan Kiszka name = 'secondary processor-based controls', 1575f6caa4fSJan Kiszka bits = { 1585f6caa4fSJan Kiszka 0: 'Virtualize APIC accesses', 1595f6caa4fSJan Kiszka 1: 'Enable EPT', 1605f6caa4fSJan Kiszka 2: 'Descriptor-table exiting', 161614413f7SJan Kiszka 3: 'Enable RDTSCP', 1625f6caa4fSJan Kiszka 4: 'Virtualize x2APIC mode', 1635f6caa4fSJan Kiszka 5: 'Enable VPID', 1645f6caa4fSJan Kiszka 6: 'WBINVD exiting', 1655f6caa4fSJan Kiszka 7: 'Unrestricted guest', 166614413f7SJan Kiszka 8: 'APIC register emulation', 167f9e90c79SMarcelo Tosatti 9: 'Virtual interrupt delivery', 1685f6caa4fSJan Kiszka 10: 'PAUSE-loop exiting', 169287d55c6SAvi Kivity 11: 'RDRAND exiting', 170287d55c6SAvi Kivity 12: 'Enable INVPCID', 171287d55c6SAvi Kivity 13: 'Enable VM functions', 172007e986fSJan Kiszka 14: 'VMCS shadowing', 173c5d1e2ccSAdrian-Ken Rueegsegger 16: 'RDSEED exiting', 174c5d1e2ccSAdrian-Ken Rueegsegger 18: 'EPT-violation #VE', 175c5d1e2ccSAdrian-Ken Rueegsegger 20: 'Enable XSAVES/XRSTORS', 176349cb2fbSEduardo Habkost 25: 'TSC scaling', 1775f6caa4fSJan Kiszka }, 1785f6caa4fSJan Kiszka cap_msr = MSR_IA32_VMX_PROCBASED_CTLS2, 1795f6caa4fSJan Kiszka ), 1805f6caa4fSJan Kiszka 1815f6caa4fSJan Kiszka Control( 1825f6caa4fSJan Kiszka name = 'VM-Exit controls', 1835f6caa4fSJan Kiszka bits = { 1845f6caa4fSJan Kiszka 2: 'Save debug controls', 1855f6caa4fSJan Kiszka 9: 'Host address-space size', 1865f6caa4fSJan Kiszka 12: 'Load IA32_PERF_GLOBAL_CTRL', 1875f6caa4fSJan Kiszka 15: 'Acknowledge interrupt on exit', 1885f6caa4fSJan Kiszka 18: 'Save IA32_PAT', 1895f6caa4fSJan Kiszka 19: 'Load IA32_PAT', 1905f6caa4fSJan Kiszka 20: 'Save IA32_EFER', 1915f6caa4fSJan Kiszka 21: 'Load IA32_EFER', 1925f6caa4fSJan Kiszka 22: 'Save VMX-preemption timer value', 1935f6caa4fSJan Kiszka }, 1945f6caa4fSJan Kiszka cap_msr = MSR_IA32_VMX_EXIT_CTLS, 1955f6caa4fSJan Kiszka true_cap_msr = MSR_IA32_VMX_TRUE_EXIT_CTLS, 1965f6caa4fSJan Kiszka ), 1975f6caa4fSJan Kiszka 1985f6caa4fSJan Kiszka Control( 1995f6caa4fSJan Kiszka name = 'VM-Entry controls', 2005f6caa4fSJan Kiszka bits = { 2015f6caa4fSJan Kiszka 2: 'Load debug controls', 202c5d1e2ccSAdrian-Ken Rueegsegger 9: 'IA-32e mode guest', 2035f6caa4fSJan Kiszka 10: 'Entry to SMM', 2045f6caa4fSJan Kiszka 11: 'Deactivate dual-monitor treatment', 2055f6caa4fSJan Kiszka 13: 'Load IA32_PERF_GLOBAL_CTRL', 2065f6caa4fSJan Kiszka 14: 'Load IA32_PAT', 2075f6caa4fSJan Kiszka 15: 'Load IA32_EFER', 2085f6caa4fSJan Kiszka }, 2095f6caa4fSJan Kiszka cap_msr = MSR_IA32_VMX_ENTRY_CTLS, 2105f6caa4fSJan Kiszka true_cap_msr = MSR_IA32_VMX_TRUE_ENTRY_CTLS, 2115f6caa4fSJan Kiszka ), 2125f6caa4fSJan Kiszka 2135f6caa4fSJan Kiszka Misc( 2145f6caa4fSJan Kiszka name = 'Miscellaneous data', 2155f6caa4fSJan Kiszka bits = { 2165f6caa4fSJan Kiszka (0,4): 'VMX-preemption timer scale (log2)', 2175f6caa4fSJan Kiszka 5: 'Store EFER.LMA into IA-32e mode guest control', 2185f6caa4fSJan Kiszka 6: 'HLT activity state', 2195f6caa4fSJan Kiszka 7: 'Shutdown activity state', 2205f6caa4fSJan Kiszka 8: 'Wait-for-SIPI activity state', 221007e986fSJan Kiszka 15: 'IA32_SMBASE support', 2225f6caa4fSJan Kiszka (16,24): 'Number of CR3-target values', 223c5d1e2ccSAdrian-Ken Rueegsegger (25,27): 'MSR-load/store count recommendation', 224287d55c6SAvi Kivity 28: 'IA32_SMM_MONITOR_CTL[2] can be set to 1', 225007e986fSJan Kiszka 29: 'VMWRITE to VM-exit information fields', 226007e986fSJan Kiszka (32,63): 'MSEG revision identifier', 2275f6caa4fSJan Kiszka }, 2285f6caa4fSJan Kiszka msr = MSR_IA32_VMX_MISC_CTLS, 2295f6caa4fSJan Kiszka ), 2305f6caa4fSJan Kiszka 2315f6caa4fSJan Kiszka Misc( 2325f6caa4fSJan Kiszka name = 'VPID and EPT capabilities', 2335f6caa4fSJan Kiszka bits = { 2345f6caa4fSJan Kiszka 0: 'Execute-only EPT translations', 2355f6caa4fSJan Kiszka 6: 'Page-walk length 4', 2365f6caa4fSJan Kiszka 8: 'Paging-structure memory type UC', 2375f6caa4fSJan Kiszka 14: 'Paging-structure memory type WB', 2385f6caa4fSJan Kiszka 16: '2MB EPT pages', 2395f6caa4fSJan Kiszka 17: '1GB EPT pages', 2405f6caa4fSJan Kiszka 20: 'INVEPT supported', 241287d55c6SAvi Kivity 21: 'EPT accessed and dirty flags', 2425f6caa4fSJan Kiszka 25: 'Single-context INVEPT', 2435f6caa4fSJan Kiszka 26: 'All-context INVEPT', 2445f6caa4fSJan Kiszka 32: 'INVVPID supported', 2455f6caa4fSJan Kiszka 40: 'Individual-address INVVPID', 2465f6caa4fSJan Kiszka 41: 'Single-context INVVPID', 2475f6caa4fSJan Kiszka 42: 'All-context INVVPID', 2485f6caa4fSJan Kiszka 43: 'Single-context-retaining-globals INVVPID', 2495f6caa4fSJan Kiszka }, 2505f6caa4fSJan Kiszka msr = MSR_IA32_VMX_EPT_VPID_CAP, 2515f6caa4fSJan Kiszka ), 252287d55c6SAvi Kivity Misc( 253287d55c6SAvi Kivity name = 'VM Functions', 254287d55c6SAvi Kivity bits = { 255287d55c6SAvi Kivity 0: 'EPTP Switching', 256287d55c6SAvi Kivity }, 257287d55c6SAvi Kivity msr = MSR_IA32_VMX_VMFUNC, 258287d55c6SAvi Kivity ), 2595f6caa4fSJan Kiszka ] 2605f6caa4fSJan Kiszka 2615f6caa4fSJan Kiszkafor c in controls: 2625f6caa4fSJan Kiszka c.show() 263