2 * QEMU VMPort emulation
4 * Copyright (C) 2007 Hervé Poussineau
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
26 * Guest code that interacts with this virtual device can be found
27 * in VMware open-vm-tools open-source project:
28 * https://github.com/vmware/open-vm-tools
31 #include "qemu/osdep.h"
32 #include "hw/isa/isa.h"
33 #include "hw/i386/vmport.h"
34 #include "hw/qdev-properties.h"
35 #include "hw/boards.h"
36 #include "sysemu/sysemu.h"
37 #include "sysemu/hw_accel.h"
38 #include "sysemu/qtest.h"
41 #include "qom/object.h"
43 #define VMPORT_MAGIC 0x564D5868
45 /* Compatibility flags for migration */
46 #define VMPORT_COMPAT_READ_SET_EAX_BIT 0
47 #define VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT 1
48 #define VMPORT_COMPAT_REPORT_VMX_TYPE_BIT 2
49 #define VMPORT_COMPAT_CMDS_V2_BIT 3
50 #define VMPORT_COMPAT_READ_SET_EAX \
51 (1 << VMPORT_COMPAT_READ_SET_EAX_BIT)
52 #define VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD \
53 (1 << VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT)
54 #define VMPORT_COMPAT_REPORT_VMX_TYPE \
55 (1 << VMPORT_COMPAT_REPORT_VMX_TYPE_BIT)
56 #define VMPORT_COMPAT_CMDS_V2 \
57 (1 << VMPORT_COMPAT_CMDS_V2_BIT)
59 /* vCPU features reported by CMD_GET_VCPU_INFO */
60 #define VCPU_INFO_SLC64_BIT 0
61 #define VCPU_INFO_SYNC_VTSCS_BIT 1
62 #define VCPU_INFO_HV_REPLAY_OK_BIT 2
63 #define VCPU_INFO_LEGACY_X2APIC_BIT 3
64 #define VCPU_INFO_RESERVED_BIT 31
66 OBJECT_DECLARE_SIMPLE_TYPE(VMPortState
, VMPORT
)
72 VMPortReadFunc
*func
[VMPORT_ENTRIES
];
73 void *opaque
[VMPORT_ENTRIES
];
75 uint32_t vmware_vmx_version
;
76 uint8_t vmware_vmx_type
;
78 uint32_t compat_flags
;
81 static VMPortState
*port_state
;
83 void vmport_register(VMPortCommand command
, VMPortReadFunc
*func
, void *opaque
)
85 assert(command
< VMPORT_ENTRIES
);
88 trace_vmport_register(command
, func
, opaque
);
89 port_state
->func
[command
] = func
;
90 port_state
->opaque
[command
] = opaque
;
93 static uint64_t vmport_ioport_read(void *opaque
, hwaddr addr
,
96 VMPortState
*s
= opaque
;
97 CPUState
*cs
= current_cpu
;
98 X86CPU
*cpu
= X86_CPU(cs
);
100 unsigned char command
;
103 if (qtest_enabled()) {
107 cpu_synchronize_state(cs
);
109 eax
= env
->regs
[R_EAX
];
110 if (eax
!= VMPORT_MAGIC
) {
114 command
= env
->regs
[R_ECX
];
115 trace_vmport_command(command
);
116 if (command
>= VMPORT_ENTRIES
|| !s
->func
[command
]) {
117 qemu_log_mask(LOG_UNIMP
, "vmport: unknown command %x\n", command
);
121 eax
= s
->func
[command
](s
->opaque
[command
], addr
);
125 if (s
->compat_flags
& VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD
) {
131 * The call above to cpu_synchronize_state() gets vCPU registers values
132 * to QEMU but also cause QEMU to write QEMU vCPU registers values to
133 * vCPU implementation (e.g. Accelerator such as KVM) just before
136 * Therefore, in order to make IOPort return value propagate to
137 * guest EAX, we need to explicitly update QEMU EAX register value.
139 if (s
->compat_flags
& VMPORT_COMPAT_READ_SET_EAX
) {
140 cpu
->env
.regs
[R_EAX
] = eax
;
146 static void vmport_ioport_write(void *opaque
, hwaddr addr
,
147 uint64_t val
, unsigned size
)
149 X86CPU
*cpu
= X86_CPU(current_cpu
);
151 if (qtest_enabled()) {
154 cpu
->env
.regs
[R_EAX
] = vmport_ioport_read(opaque
, addr
, 4);
157 static uint32_t vmport_cmd_get_version(void *opaque
, uint32_t addr
)
159 X86CPU
*cpu
= X86_CPU(current_cpu
);
161 if (qtest_enabled()) {
164 cpu
->env
.regs
[R_EBX
] = VMPORT_MAGIC
;
165 if (port_state
->compat_flags
& VMPORT_COMPAT_REPORT_VMX_TYPE
) {
166 cpu
->env
.regs
[R_ECX
] = port_state
->vmware_vmx_type
;
168 return port_state
->vmware_vmx_version
;
171 static uint32_t vmport_cmd_get_bios_uuid(void *opaque
, uint32_t addr
)
173 X86CPU
*cpu
= X86_CPU(current_cpu
);
174 uint32_t *uuid_parts
= (uint32_t *)(qemu_uuid
.data
);
176 cpu
->env
.regs
[R_EAX
] = le32_to_cpu(uuid_parts
[0]);
177 cpu
->env
.regs
[R_EBX
] = le32_to_cpu(uuid_parts
[1]);
178 cpu
->env
.regs
[R_ECX
] = le32_to_cpu(uuid_parts
[2]);
179 cpu
->env
.regs
[R_EDX
] = le32_to_cpu(uuid_parts
[3]);
180 return cpu
->env
.regs
[R_EAX
];
183 static uint32_t vmport_cmd_ram_size(void *opaque
, uint32_t addr
)
185 X86CPU
*cpu
= X86_CPU(current_cpu
);
187 if (qtest_enabled()) {
190 cpu
->env
.regs
[R_EBX
] = 0x1177;
191 return current_machine
->ram_size
;
194 static uint32_t vmport_cmd_get_hz(void *opaque
, uint32_t addr
)
196 X86CPU
*cpu
= X86_CPU(current_cpu
);
198 if (cpu
->env
.tsc_khz
&& cpu
->env
.apic_bus_freq
) {
199 uint64_t tsc_freq
= (uint64_t)cpu
->env
.tsc_khz
* 1000;
201 cpu
->env
.regs
[R_ECX
] = cpu
->env
.apic_bus_freq
;
202 cpu
->env
.regs
[R_EBX
] = (uint32_t)(tsc_freq
>> 32);
203 cpu
->env
.regs
[R_EAX
] = (uint32_t)tsc_freq
;
205 /* Signal cmd as not supported */
206 cpu
->env
.regs
[R_EBX
] = UINT32_MAX
;
209 return cpu
->env
.regs
[R_EAX
];
212 static uint32_t vmport_cmd_get_vcpu_info(void *opaque
, uint32_t addr
)
214 X86CPU
*cpu
= X86_CPU(current_cpu
);
217 if (cpu
->env
.features
[FEAT_1_ECX
] & CPUID_EXT_X2APIC
) {
218 ret
|= 1 << VCPU_INFO_LEGACY_X2APIC_BIT
;
224 static const MemoryRegionOps vmport_ops
= {
225 .read
= vmport_ioport_read
,
226 .write
= vmport_ioport_write
,
228 .min_access_size
= 4,
229 .max_access_size
= 4,
231 .endianness
= DEVICE_LITTLE_ENDIAN
,
234 static void vmport_realizefn(DeviceState
*dev
, Error
**errp
)
236 ISADevice
*isadev
= ISA_DEVICE(dev
);
237 VMPortState
*s
= VMPORT(dev
);
239 memory_region_init_io(&s
->io
, OBJECT(s
), &vmport_ops
, s
, "vmport", 1);
240 isa_register_ioport(isadev
, &s
->io
, 0x5658);
244 /* Register some generic port commands */
245 vmport_register(VMPORT_CMD_GETVERSION
, vmport_cmd_get_version
, NULL
);
246 vmport_register(VMPORT_CMD_GETRAMSIZE
, vmport_cmd_ram_size
, NULL
);
247 if (s
->compat_flags
& VMPORT_COMPAT_CMDS_V2
) {
248 vmport_register(VMPORT_CMD_GETBIOSUUID
, vmport_cmd_get_bios_uuid
, NULL
);
249 vmport_register(VMPORT_CMD_GETHZ
, vmport_cmd_get_hz
, NULL
);
250 vmport_register(VMPORT_CMD_GET_VCPU_INFO
, vmport_cmd_get_vcpu_info
,
255 static Property vmport_properties
[] = {
256 /* Used to enforce compatibility for migration */
257 DEFINE_PROP_BIT("x-read-set-eax", VMPortState
, compat_flags
,
258 VMPORT_COMPAT_READ_SET_EAX_BIT
, true),
259 DEFINE_PROP_BIT("x-signal-unsupported-cmd", VMPortState
, compat_flags
,
260 VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT
, true),
261 DEFINE_PROP_BIT("x-report-vmx-type", VMPortState
, compat_flags
,
262 VMPORT_COMPAT_REPORT_VMX_TYPE_BIT
, true),
263 DEFINE_PROP_BIT("x-cmds-v2", VMPortState
, compat_flags
,
264 VMPORT_COMPAT_CMDS_V2_BIT
, true),
266 /* Default value taken from open-vm-tools code VERSION_MAGIC definition */
267 DEFINE_PROP_UINT32("vmware-vmx-version", VMPortState
,
268 vmware_vmx_version
, 6),
270 * Value determines which VMware product type host report itself to guest.
272 * Most guests are fine with exposing host as VMware ESX server.
273 * Some legacy/proprietary guests hard-code a given type.
275 * For a complete list of values, refer to enum VMXType at open-vm-tools
276 * project (Defined at lib/include/vm_vmx_type.h).
278 * Reasonable options:
280 * 1 - VMware Express (deprecated)
281 * 2 - VMware ESX Server
282 * 3 - VMware Server (Deprecated)
283 * 4 - VMware Workstation
284 * 5 - ACE 1.x (Deprecated)
286 DEFINE_PROP_UINT8("vmware-vmx-type", VMPortState
, vmware_vmx_type
, 2),
288 DEFINE_PROP_END_OF_LIST(),
291 static void vmport_class_initfn(ObjectClass
*klass
, void *data
)
293 DeviceClass
*dc
= DEVICE_CLASS(klass
);
295 dc
->realize
= vmport_realizefn
;
296 /* Reason: realize sets global port_state */
297 dc
->user_creatable
= false;
298 device_class_set_props(dc
, vmport_properties
);
301 static const TypeInfo vmport_info
= {
303 .parent
= TYPE_ISA_DEVICE
,
304 .instance_size
= sizeof(VMPortState
),
305 .class_init
= vmport_class_initfn
,
308 static void vmport_register_types(void)
310 type_register_static(&vmport_info
);
313 type_init(vmport_register_types
)