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"
42 #include "qom/object.h"
44 #define VMPORT_MAGIC 0x564D5868
46 /* Compatibility flags for migration */
47 #define VMPORT_COMPAT_READ_SET_EAX_BIT 0
48 #define VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT 1
49 #define VMPORT_COMPAT_REPORT_VMX_TYPE_BIT 2
50 #define VMPORT_COMPAT_CMDS_V2_BIT 3
51 #define VMPORT_COMPAT_READ_SET_EAX \
52 (1 << VMPORT_COMPAT_READ_SET_EAX_BIT)
53 #define VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD \
54 (1 << VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT)
55 #define VMPORT_COMPAT_REPORT_VMX_TYPE \
56 (1 << VMPORT_COMPAT_REPORT_VMX_TYPE_BIT)
57 #define VMPORT_COMPAT_CMDS_V2 \
58 (1 << VMPORT_COMPAT_CMDS_V2_BIT)
60 /* vCPU features reported by CMD_GET_VCPU_INFO */
61 #define VCPU_INFO_SLC64_BIT 0
62 #define VCPU_INFO_SYNC_VTSCS_BIT 1
63 #define VCPU_INFO_HV_REPLAY_OK_BIT 2
64 #define VCPU_INFO_LEGACY_X2APIC_BIT 3
65 #define VCPU_INFO_RESERVED_BIT 31
67 OBJECT_DECLARE_SIMPLE_TYPE(VMPortState
, VMPORT
)
73 VMPortReadFunc
*func
[VMPORT_ENTRIES
];
74 void *opaque
[VMPORT_ENTRIES
];
76 uint32_t vmware_vmx_version
;
77 uint8_t vmware_vmx_type
;
79 uint32_t compat_flags
;
82 static VMPortState
*port_state
;
84 void vmport_register(VMPortCommand command
, VMPortReadFunc
*func
, void *opaque
)
86 assert(command
< VMPORT_ENTRIES
);
89 trace_vmport_register(command
, func
, opaque
);
90 port_state
->func
[command
] = func
;
91 port_state
->opaque
[command
] = opaque
;
94 static uint64_t vmport_ioport_read(void *opaque
, hwaddr addr
,
97 VMPortState
*s
= opaque
;
98 CPUState
*cs
= current_cpu
;
99 X86CPU
*cpu
= X86_CPU(cs
);
101 unsigned char command
;
104 if (qtest_enabled()) {
108 cpu_synchronize_state(cs
);
110 eax
= env
->regs
[R_EAX
];
111 if (eax
!= VMPORT_MAGIC
) {
115 command
= env
->regs
[R_ECX
];
116 trace_vmport_command(command
);
117 if (command
>= VMPORT_ENTRIES
|| !s
->func
[command
]) {
118 qemu_log_mask(LOG_UNIMP
, "vmport: unknown command %x\n", command
);
122 eax
= s
->func
[command
](s
->opaque
[command
], addr
);
126 if (s
->compat_flags
& VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD
) {
132 * The call above to cpu_synchronize_state() gets vCPU registers values
133 * to QEMU but also cause QEMU to write QEMU vCPU registers values to
134 * vCPU implementation (e.g. Accelerator such as KVM) just before
137 * Therefore, in order to make IOPort return value propagate to
138 * guest EAX, we need to explicitly update QEMU EAX register value.
140 if (s
->compat_flags
& VMPORT_COMPAT_READ_SET_EAX
) {
141 cpu
->env
.regs
[R_EAX
] = eax
;
147 static void vmport_ioport_write(void *opaque
, hwaddr addr
,
148 uint64_t val
, unsigned size
)
150 X86CPU
*cpu
= X86_CPU(current_cpu
);
152 if (qtest_enabled()) {
155 cpu
->env
.regs
[R_EAX
] = vmport_ioport_read(opaque
, addr
, 4);
158 static uint32_t vmport_cmd_get_version(void *opaque
, uint32_t addr
)
160 X86CPU
*cpu
= X86_CPU(current_cpu
);
162 if (qtest_enabled()) {
165 cpu
->env
.regs
[R_EBX
] = VMPORT_MAGIC
;
166 if (port_state
->compat_flags
& VMPORT_COMPAT_REPORT_VMX_TYPE
) {
167 cpu
->env
.regs
[R_ECX
] = port_state
->vmware_vmx_type
;
169 return port_state
->vmware_vmx_version
;
172 static uint32_t vmport_cmd_get_bios_uuid(void *opaque
, uint32_t addr
)
174 X86CPU
*cpu
= X86_CPU(current_cpu
);
175 uint32_t *uuid_parts
= (uint32_t *)(qemu_uuid
.data
);
177 cpu
->env
.regs
[R_EAX
] = le32_to_cpu(uuid_parts
[0]);
178 cpu
->env
.regs
[R_EBX
] = le32_to_cpu(uuid_parts
[1]);
179 cpu
->env
.regs
[R_ECX
] = le32_to_cpu(uuid_parts
[2]);
180 cpu
->env
.regs
[R_EDX
] = le32_to_cpu(uuid_parts
[3]);
181 return cpu
->env
.regs
[R_EAX
];
184 static uint32_t vmport_cmd_ram_size(void *opaque
, uint32_t addr
)
186 X86CPU
*cpu
= X86_CPU(current_cpu
);
188 if (qtest_enabled()) {
191 cpu
->env
.regs
[R_EBX
] = 0x1177;
192 return current_machine
->ram_size
;
195 static uint32_t vmport_cmd_get_hz(void *opaque
, uint32_t addr
)
197 X86CPU
*cpu
= X86_CPU(current_cpu
);
199 if (cpu
->env
.tsc_khz
&& cpu
->env
.apic_bus_freq
) {
200 uint64_t tsc_freq
= (uint64_t)cpu
->env
.tsc_khz
* 1000;
202 cpu
->env
.regs
[R_ECX
] = cpu
->env
.apic_bus_freq
;
203 cpu
->env
.regs
[R_EBX
] = (uint32_t)(tsc_freq
>> 32);
204 cpu
->env
.regs
[R_EAX
] = (uint32_t)tsc_freq
;
206 /* Signal cmd as not supported */
207 cpu
->env
.regs
[R_EBX
] = UINT32_MAX
;
210 return cpu
->env
.regs
[R_EAX
];
213 static uint32_t vmport_cmd_get_vcpu_info(void *opaque
, uint32_t addr
)
215 X86CPU
*cpu
= X86_CPU(current_cpu
);
218 if (cpu
->env
.features
[FEAT_1_ECX
] & CPUID_EXT_X2APIC
) {
219 ret
|= 1 << VCPU_INFO_LEGACY_X2APIC_BIT
;
225 static const MemoryRegionOps vmport_ops
= {
226 .read
= vmport_ioport_read
,
227 .write
= vmport_ioport_write
,
229 .min_access_size
= 4,
230 .max_access_size
= 4,
232 .endianness
= DEVICE_LITTLE_ENDIAN
,
235 static void vmport_realizefn(DeviceState
*dev
, Error
**errp
)
237 ISADevice
*isadev
= ISA_DEVICE(dev
);
238 VMPortState
*s
= VMPORT(dev
);
240 memory_region_init_io(&s
->io
, OBJECT(s
), &vmport_ops
, s
, "vmport", 1);
241 isa_register_ioport(isadev
, &s
->io
, 0x5658);
245 /* Register some generic port commands */
246 vmport_register(VMPORT_CMD_GETVERSION
, vmport_cmd_get_version
, NULL
);
247 vmport_register(VMPORT_CMD_GETRAMSIZE
, vmport_cmd_ram_size
, NULL
);
248 if (s
->compat_flags
& VMPORT_COMPAT_CMDS_V2
) {
249 vmport_register(VMPORT_CMD_GETBIOSUUID
, vmport_cmd_get_bios_uuid
, NULL
);
250 vmport_register(VMPORT_CMD_GETHZ
, vmport_cmd_get_hz
, NULL
);
251 vmport_register(VMPORT_CMD_GET_VCPU_INFO
, vmport_cmd_get_vcpu_info
,
256 static Property vmport_properties
[] = {
257 /* Used to enforce compatibility for migration */
258 DEFINE_PROP_BIT("x-read-set-eax", VMPortState
, compat_flags
,
259 VMPORT_COMPAT_READ_SET_EAX_BIT
, true),
260 DEFINE_PROP_BIT("x-signal-unsupported-cmd", VMPortState
, compat_flags
,
261 VMPORT_COMPAT_SIGNAL_UNSUPPORTED_CMD_BIT
, true),
262 DEFINE_PROP_BIT("x-report-vmx-type", VMPortState
, compat_flags
,
263 VMPORT_COMPAT_REPORT_VMX_TYPE_BIT
, true),
264 DEFINE_PROP_BIT("x-cmds-v2", VMPortState
, compat_flags
,
265 VMPORT_COMPAT_CMDS_V2_BIT
, true),
267 /* Default value taken from open-vm-tools code VERSION_MAGIC definition */
268 DEFINE_PROP_UINT32("vmware-vmx-version", VMPortState
,
269 vmware_vmx_version
, 6),
271 * Value determines which VMware product type host report itself to guest.
273 * Most guests are fine with exposing host as VMware ESX server.
274 * Some legacy/proprietary guests hard-code a given type.
276 * For a complete list of values, refer to enum VMXType at open-vm-tools
277 * project (Defined at lib/include/vm_vmx_type.h).
279 * Reasonable options:
281 * 1 - VMware Express (deprecated)
282 * 2 - VMware ESX Server
283 * 3 - VMware Server (Deprecated)
284 * 4 - VMware Workstation
285 * 5 - ACE 1.x (Deprecated)
287 DEFINE_PROP_UINT8("vmware-vmx-type", VMPortState
, vmware_vmx_type
, 2),
289 DEFINE_PROP_END_OF_LIST(),
292 static void vmport_class_initfn(ObjectClass
*klass
, void *data
)
294 DeviceClass
*dc
= DEVICE_CLASS(klass
);
296 dc
->realize
= vmport_realizefn
;
297 /* Reason: realize sets global port_state */
298 dc
->user_creatable
= false;
299 device_class_set_props(dc
, vmport_properties
);
302 static const TypeInfo vmport_info
= {
304 .parent
= TYPE_ISA_DEVICE
,
305 .instance_size
= sizeof(VMPortState
),
306 .class_init
= vmport_class_initfn
,
309 static void vmport_register_types(void)
311 type_register_static(&vmport_info
);
314 type_init(vmport_register_types
)