vmm.h revision 273683
1/*-
2 * Copyright (c) 2011 NetApp, Inc.
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: head/sys/amd64/include/vmm.h 273683 2014-10-26 04:44:28Z neel $
27 */
28
29#ifndef _VMM_H_
30#define	_VMM_H_
31
32#include <x86/segments.h>
33
34enum vm_suspend_how {
35	VM_SUSPEND_NONE,
36	VM_SUSPEND_RESET,
37	VM_SUSPEND_POWEROFF,
38	VM_SUSPEND_HALT,
39	VM_SUSPEND_TRIPLEFAULT,
40	VM_SUSPEND_LAST
41};
42
43/*
44 * Identifiers for architecturally defined registers.
45 */
46enum vm_reg_name {
47	VM_REG_GUEST_RAX,
48	VM_REG_GUEST_RBX,
49	VM_REG_GUEST_RCX,
50	VM_REG_GUEST_RDX,
51	VM_REG_GUEST_RSI,
52	VM_REG_GUEST_RDI,
53	VM_REG_GUEST_RBP,
54	VM_REG_GUEST_R8,
55	VM_REG_GUEST_R9,
56	VM_REG_GUEST_R10,
57	VM_REG_GUEST_R11,
58	VM_REG_GUEST_R12,
59	VM_REG_GUEST_R13,
60	VM_REG_GUEST_R14,
61	VM_REG_GUEST_R15,
62	VM_REG_GUEST_CR0,
63	VM_REG_GUEST_CR3,
64	VM_REG_GUEST_CR4,
65	VM_REG_GUEST_DR7,
66	VM_REG_GUEST_RSP,
67	VM_REG_GUEST_RIP,
68	VM_REG_GUEST_RFLAGS,
69	VM_REG_GUEST_ES,
70	VM_REG_GUEST_CS,
71	VM_REG_GUEST_SS,
72	VM_REG_GUEST_DS,
73	VM_REG_GUEST_FS,
74	VM_REG_GUEST_GS,
75	VM_REG_GUEST_LDTR,
76	VM_REG_GUEST_TR,
77	VM_REG_GUEST_IDTR,
78	VM_REG_GUEST_GDTR,
79	VM_REG_GUEST_EFER,
80	VM_REG_GUEST_CR2,
81	VM_REG_GUEST_PDPTE0,
82	VM_REG_GUEST_PDPTE1,
83	VM_REG_GUEST_PDPTE2,
84	VM_REG_GUEST_PDPTE3,
85	VM_REG_GUEST_INTR_SHADOW,
86	VM_REG_LAST
87};
88
89enum x2apic_state {
90	X2APIC_DISABLED,
91	X2APIC_ENABLED,
92	X2APIC_STATE_LAST
93};
94
95#define	VM_INTINFO_VECTOR(info)	((info) & 0xff)
96#define	VM_INTINFO_DEL_ERRCODE	0x800
97#define	VM_INTINFO_RSVD		0x7ffff000
98#define	VM_INTINFO_VALID	0x80000000
99#define	VM_INTINFO_TYPE		0x700
100#define	VM_INTINFO_HWINTR	(0 << 8)
101#define	VM_INTINFO_NMI		(2 << 8)
102#define	VM_INTINFO_HWEXCEPTION	(3 << 8)
103#define	VM_INTINFO_SWINTR	(4 << 8)
104
105#ifdef _KERNEL
106
107#define	VM_MAX_NAMELEN	32
108
109struct vm;
110struct vm_exception;
111struct vm_memory_segment;
112struct seg_desc;
113struct vm_exit;
114struct vm_run;
115struct vhpet;
116struct vioapic;
117struct vlapic;
118struct vmspace;
119struct vm_object;
120struct vm_guest_paging;
121struct pmap;
122
123typedef int	(*vmm_init_func_t)(int ipinum);
124typedef int	(*vmm_cleanup_func_t)(void);
125typedef void	(*vmm_resume_func_t)(void);
126typedef void *	(*vmi_init_func_t)(struct vm *vm, struct pmap *pmap);
127typedef int	(*vmi_run_func_t)(void *vmi, int vcpu, register_t rip,
128				  struct pmap *pmap, void *rendezvous_cookie,
129				  void *suspend_cookie);
130typedef void	(*vmi_cleanup_func_t)(void *vmi);
131typedef int	(*vmi_get_register_t)(void *vmi, int vcpu, int num,
132				      uint64_t *retval);
133typedef int	(*vmi_set_register_t)(void *vmi, int vcpu, int num,
134				      uint64_t val);
135typedef int	(*vmi_get_desc_t)(void *vmi, int vcpu, int num,
136				  struct seg_desc *desc);
137typedef int	(*vmi_set_desc_t)(void *vmi, int vcpu, int num,
138				  struct seg_desc *desc);
139typedef int	(*vmi_get_cap_t)(void *vmi, int vcpu, int num, int *retval);
140typedef int	(*vmi_set_cap_t)(void *vmi, int vcpu, int num, int val);
141typedef struct vmspace * (*vmi_vmspace_alloc)(vm_offset_t min, vm_offset_t max);
142typedef void	(*vmi_vmspace_free)(struct vmspace *vmspace);
143typedef struct vlapic * (*vmi_vlapic_init)(void *vmi, int vcpu);
144typedef void	(*vmi_vlapic_cleanup)(void *vmi, struct vlapic *vlapic);
145
146struct vmm_ops {
147	vmm_init_func_t		init;		/* module wide initialization */
148	vmm_cleanup_func_t	cleanup;
149	vmm_resume_func_t	resume;
150
151	vmi_init_func_t		vminit;		/* vm-specific initialization */
152	vmi_run_func_t		vmrun;
153	vmi_cleanup_func_t	vmcleanup;
154	vmi_get_register_t	vmgetreg;
155	vmi_set_register_t	vmsetreg;
156	vmi_get_desc_t		vmgetdesc;
157	vmi_set_desc_t		vmsetdesc;
158	vmi_get_cap_t		vmgetcap;
159	vmi_set_cap_t		vmsetcap;
160	vmi_vmspace_alloc	vmspace_alloc;
161	vmi_vmspace_free	vmspace_free;
162	vmi_vlapic_init		vlapic_init;
163	vmi_vlapic_cleanup	vlapic_cleanup;
164};
165
166extern struct vmm_ops vmm_ops_intel;
167extern struct vmm_ops vmm_ops_amd;
168
169int vm_create(const char *name, struct vm **retvm);
170void vm_destroy(struct vm *vm);
171int vm_reinit(struct vm *vm);
172const char *vm_name(struct vm *vm);
173int vm_malloc(struct vm *vm, vm_paddr_t gpa, size_t len);
174int vm_map_mmio(struct vm *vm, vm_paddr_t gpa, size_t len, vm_paddr_t hpa);
175int vm_unmap_mmio(struct vm *vm, vm_paddr_t gpa, size_t len);
176void *vm_gpa_hold(struct vm *, vm_paddr_t gpa, size_t len, int prot,
177		  void **cookie);
178void vm_gpa_release(void *cookie);
179int vm_gpabase2memseg(struct vm *vm, vm_paddr_t gpabase,
180	      struct vm_memory_segment *seg);
181int vm_get_memobj(struct vm *vm, vm_paddr_t gpa, size_t len,
182		  vm_offset_t *offset, struct vm_object **object);
183boolean_t vm_mem_allocated(struct vm *vm, vm_paddr_t gpa);
184int vm_get_register(struct vm *vm, int vcpu, int reg, uint64_t *retval);
185int vm_set_register(struct vm *vm, int vcpu, int reg, uint64_t val);
186int vm_get_seg_desc(struct vm *vm, int vcpu, int reg,
187		    struct seg_desc *ret_desc);
188int vm_set_seg_desc(struct vm *vm, int vcpu, int reg,
189		    struct seg_desc *desc);
190int vm_run(struct vm *vm, struct vm_run *vmrun);
191int vm_suspend(struct vm *vm, enum vm_suspend_how how);
192int vm_inject_nmi(struct vm *vm, int vcpu);
193int vm_nmi_pending(struct vm *vm, int vcpuid);
194void vm_nmi_clear(struct vm *vm, int vcpuid);
195int vm_inject_extint(struct vm *vm, int vcpu);
196int vm_extint_pending(struct vm *vm, int vcpuid);
197void vm_extint_clear(struct vm *vm, int vcpuid);
198struct vlapic *vm_lapic(struct vm *vm, int cpu);
199struct vioapic *vm_ioapic(struct vm *vm);
200struct vhpet *vm_hpet(struct vm *vm);
201int vm_get_capability(struct vm *vm, int vcpu, int type, int *val);
202int vm_set_capability(struct vm *vm, int vcpu, int type, int val);
203int vm_get_x2apic_state(struct vm *vm, int vcpu, enum x2apic_state *state);
204int vm_set_x2apic_state(struct vm *vm, int vcpu, enum x2apic_state state);
205int vm_apicid2vcpuid(struct vm *vm, int apicid);
206int vm_activate_cpu(struct vm *vm, int vcpu);
207cpuset_t vm_active_cpus(struct vm *vm);
208cpuset_t vm_suspended_cpus(struct vm *vm);
209struct vm_exit *vm_exitinfo(struct vm *vm, int vcpuid);
210void vm_exit_suspended(struct vm *vm, int vcpuid, uint64_t rip);
211void vm_exit_rendezvous(struct vm *vm, int vcpuid, uint64_t rip);
212void vm_exit_astpending(struct vm *vm, int vcpuid, uint64_t rip);
213
214/*
215 * Rendezvous all vcpus specified in 'dest' and execute 'func(arg)'.
216 * The rendezvous 'func(arg)' is not allowed to do anything that will
217 * cause the thread to be put to sleep.
218 *
219 * If the rendezvous is being initiated from a vcpu context then the
220 * 'vcpuid' must refer to that vcpu, otherwise it should be set to -1.
221 *
222 * The caller cannot hold any locks when initiating the rendezvous.
223 *
224 * The implementation of this API may cause vcpus other than those specified
225 * by 'dest' to be stalled. The caller should not rely on any vcpus making
226 * forward progress when the rendezvous is in progress.
227 */
228typedef void (*vm_rendezvous_func_t)(struct vm *vm, int vcpuid, void *arg);
229void vm_smp_rendezvous(struct vm *vm, int vcpuid, cpuset_t dest,
230    vm_rendezvous_func_t func, void *arg);
231
232static __inline int
233vcpu_rendezvous_pending(void *rendezvous_cookie)
234{
235
236	return (*(uintptr_t *)rendezvous_cookie != 0);
237}
238
239static __inline int
240vcpu_suspended(void *suspend_cookie)
241{
242
243	return (*(int *)suspend_cookie);
244}
245
246/*
247 * Return 1 if device indicated by bus/slot/func is supposed to be a
248 * pci passthrough device.
249 *
250 * Return 0 otherwise.
251 */
252int vmm_is_pptdev(int bus, int slot, int func);
253
254void *vm_iommu_domain(struct vm *vm);
255
256enum vcpu_state {
257	VCPU_IDLE,
258	VCPU_FROZEN,
259	VCPU_RUNNING,
260	VCPU_SLEEPING,
261};
262
263int vcpu_set_state(struct vm *vm, int vcpu, enum vcpu_state state,
264    bool from_idle);
265enum vcpu_state vcpu_get_state(struct vm *vm, int vcpu, int *hostcpu);
266
267static int __inline
268vcpu_is_running(struct vm *vm, int vcpu, int *hostcpu)
269{
270	return (vcpu_get_state(vm, vcpu, hostcpu) == VCPU_RUNNING);
271}
272
273#ifdef _SYS_PROC_H_
274static int __inline
275vcpu_should_yield(struct vm *vm, int vcpu)
276{
277	return (curthread->td_flags & (TDF_ASTPENDING | TDF_NEEDRESCHED));
278}
279#endif
280
281void *vcpu_stats(struct vm *vm, int vcpu);
282void vcpu_notify_event(struct vm *vm, int vcpuid, bool lapic_intr);
283struct vmspace *vm_get_vmspace(struct vm *vm);
284int vm_assign_pptdev(struct vm *vm, int bus, int slot, int func);
285int vm_unassign_pptdev(struct vm *vm, int bus, int slot, int func);
286struct vatpic *vm_atpic(struct vm *vm);
287struct vatpit *vm_atpit(struct vm *vm);
288struct vpmtmr *vm_pmtmr(struct vm *vm);
289
290/*
291 * Inject exception 'vme' into the guest vcpu. This function returns 0 on
292 * success and non-zero on failure.
293 *
294 * Wrapper functions like 'vm_inject_gp()' should be preferred to calling
295 * this function directly because they enforce the trap-like or fault-like
296 * behavior of an exception.
297 *
298 * This function should only be called in the context of the thread that is
299 * executing this vcpu.
300 */
301int vm_inject_exception(struct vm *vm, int vcpuid, struct vm_exception *vme);
302
303/*
304 * This function is called after a VM-exit that occurred during exception or
305 * interrupt delivery through the IDT. The format of 'intinfo' is described
306 * in Figure 15-1, "EXITINTINFO for All Intercepts", APM, Vol 2.
307 *
308 * If a VM-exit handler completes the event delivery successfully then it
309 * should call vm_exit_intinfo() to extinguish the pending event. For e.g.,
310 * if the task switch emulation is triggered via a task gate then it should
311 * call this function with 'intinfo=0' to indicate that the external event
312 * is not pending anymore.
313 *
314 * Return value is 0 on success and non-zero on failure.
315 */
316int vm_exit_intinfo(struct vm *vm, int vcpuid, uint64_t intinfo);
317
318/*
319 * This function is called before every VM-entry to retrieve a pending
320 * event that should be injected into the guest. This function combines
321 * nested events into a double or triple fault.
322 *
323 * Returns 0 if there are no events that need to be injected into the guest
324 * and non-zero otherwise.
325 */
326int vm_entry_intinfo(struct vm *vm, int vcpuid, uint64_t *info);
327
328int vm_get_intinfo(struct vm *vm, int vcpuid, uint64_t *info1, uint64_t *info2);
329
330enum vm_reg_name vm_segment_name(int seg_encoding);
331
332struct vm_copyinfo {
333	uint64_t	gpa;
334	size_t		len;
335	void		*hva;
336	void		*cookie;
337};
338
339/*
340 * Set up 'copyinfo[]' to copy to/from guest linear address space starting
341 * at 'gla' and 'len' bytes long. The 'prot' should be set to PROT_READ for
342 * a copyin or PROT_WRITE for a copyout.
343 *
344 * Returns 0 on success.
345 * Returns 1 if an exception was injected into the guest.
346 * Returns -1 otherwise.
347 *
348 * The 'copyinfo[]' can be passed to 'vm_copyin()' or 'vm_copyout()' only if
349 * the return value is 0. The 'copyinfo[]' resources should be freed by calling
350 * 'vm_copy_teardown()' after the copy is done.
351 */
352int vm_copy_setup(struct vm *vm, int vcpuid, struct vm_guest_paging *paging,
353    uint64_t gla, size_t len, int prot, struct vm_copyinfo *copyinfo,
354    int num_copyinfo);
355void vm_copy_teardown(struct vm *vm, int vcpuid, struct vm_copyinfo *copyinfo,
356    int num_copyinfo);
357void vm_copyin(struct vm *vm, int vcpuid, struct vm_copyinfo *copyinfo,
358    void *kaddr, size_t len);
359void vm_copyout(struct vm *vm, int vcpuid, const void *kaddr,
360    struct vm_copyinfo *copyinfo, size_t len);
361#endif	/* KERNEL */
362
363#define	VM_MAXCPU	16			/* maximum virtual cpus */
364
365/*
366 * Identifiers for optional vmm capabilities
367 */
368enum vm_cap_type {
369	VM_CAP_HALT_EXIT,
370	VM_CAP_MTRAP_EXIT,
371	VM_CAP_PAUSE_EXIT,
372	VM_CAP_UNRESTRICTED_GUEST,
373	VM_CAP_ENABLE_INVPCID,
374	VM_CAP_MAX
375};
376
377enum vm_intr_trigger {
378	EDGE_TRIGGER,
379	LEVEL_TRIGGER
380};
381
382/*
383 * The 'access' field has the format specified in Table 21-2 of the Intel
384 * Architecture Manual vol 3b.
385 *
386 * XXX The contents of the 'access' field are architecturally defined except
387 * bit 16 - Segment Unusable.
388 */
389struct seg_desc {
390	uint64_t	base;
391	uint32_t	limit;
392	uint32_t	access;
393};
394#define	SEG_DESC_TYPE(access)		((access) & 0x001f)
395#define	SEG_DESC_DPL(access)		(((access) >> 5) & 0x3)
396#define	SEG_DESC_PRESENT(access)	(((access) & 0x0080) ? 1 : 0)
397#define	SEG_DESC_DEF32(access)		(((access) & 0x4000) ? 1 : 0)
398#define	SEG_DESC_GRANULARITY(access)	(((access) & 0x8000) ? 1 : 0)
399#define	SEG_DESC_UNUSABLE(access)	(((access) & 0x10000) ? 1 : 0)
400
401enum vm_cpu_mode {
402	CPU_MODE_REAL,
403	CPU_MODE_PROTECTED,
404	CPU_MODE_COMPATIBILITY,		/* IA-32E mode (CS.L = 0) */
405	CPU_MODE_64BIT,			/* IA-32E mode (CS.L = 1) */
406};
407
408enum vm_paging_mode {
409	PAGING_MODE_FLAT,
410	PAGING_MODE_32,
411	PAGING_MODE_PAE,
412	PAGING_MODE_64,
413};
414
415struct vm_guest_paging {
416	uint64_t	cr3;
417	int		cpl;
418	enum vm_cpu_mode cpu_mode;
419	enum vm_paging_mode paging_mode;
420};
421
422/*
423 * The data structures 'vie' and 'vie_op' are meant to be opaque to the
424 * consumers of instruction decoding. The only reason why their contents
425 * need to be exposed is because they are part of the 'vm_exit' structure.
426 */
427struct vie_op {
428	uint8_t		op_byte;	/* actual opcode byte */
429	uint8_t		op_type;	/* type of operation (e.g. MOV) */
430	uint16_t	op_flags;
431};
432
433#define	VIE_INST_SIZE	15
434struct vie {
435	uint8_t		inst[VIE_INST_SIZE];	/* instruction bytes */
436	uint8_t		num_valid;		/* size of the instruction */
437	uint8_t		num_processed;
438
439	uint8_t		addrsize:4, opsize:4;	/* address and operand sizes */
440	uint8_t		rex_w:1,		/* REX prefix */
441			rex_r:1,
442			rex_x:1,
443			rex_b:1,
444			rex_present:1,
445			opsize_override:1,	/* Operand size override */
446			addrsize_override:1;	/* Address size override */
447
448	uint8_t		mod:2,			/* ModRM byte */
449			reg:4,
450			rm:4;
451
452	uint8_t		ss:2,			/* SIB byte */
453			index:4,
454			base:4;
455
456	uint8_t		disp_bytes;
457	uint8_t		imm_bytes;
458
459	uint8_t		scale;
460	int		base_register;		/* VM_REG_GUEST_xyz */
461	int		index_register;		/* VM_REG_GUEST_xyz */
462
463	int64_t		displacement;		/* optional addr displacement */
464	int64_t		immediate;		/* optional immediate operand */
465
466	uint8_t		decoded;	/* set to 1 if successfully decoded */
467
468	struct vie_op	op;			/* opcode description */
469};
470
471enum vm_exitcode {
472	VM_EXITCODE_INOUT,
473	VM_EXITCODE_VMX,
474	VM_EXITCODE_BOGUS,
475	VM_EXITCODE_RDMSR,
476	VM_EXITCODE_WRMSR,
477	VM_EXITCODE_HLT,
478	VM_EXITCODE_MTRAP,
479	VM_EXITCODE_PAUSE,
480	VM_EXITCODE_PAGING,
481	VM_EXITCODE_INST_EMUL,
482	VM_EXITCODE_SPINUP_AP,
483	VM_EXITCODE_DEPRECATED1,	/* used to be SPINDOWN_CPU */
484	VM_EXITCODE_RENDEZVOUS,
485	VM_EXITCODE_IOAPIC_EOI,
486	VM_EXITCODE_SUSPENDED,
487	VM_EXITCODE_INOUT_STR,
488	VM_EXITCODE_TASK_SWITCH,
489	VM_EXITCODE_MONITOR,
490	VM_EXITCODE_MWAIT,
491	VM_EXITCODE_SVM,
492	VM_EXITCODE_MAX
493};
494
495struct vm_inout {
496	uint16_t	bytes:3;	/* 1 or 2 or 4 */
497	uint16_t	in:1;
498	uint16_t	string:1;
499	uint16_t	rep:1;
500	uint16_t	port;
501	uint32_t	eax;		/* valid for out */
502};
503
504struct vm_inout_str {
505	struct vm_inout	inout;		/* must be the first element */
506	struct vm_guest_paging paging;
507	uint64_t	rflags;
508	uint64_t	cr0;
509	uint64_t	index;
510	uint64_t	count;		/* rep=1 (%rcx), rep=0 (1) */
511	int		addrsize;
512	enum vm_reg_name seg_name;
513	struct seg_desc seg_desc;
514};
515
516enum task_switch_reason {
517	TSR_CALL,
518	TSR_IRET,
519	TSR_JMP,
520	TSR_IDT_GATE,	/* task gate in IDT */
521};
522
523struct vm_task_switch {
524	uint16_t	tsssel;		/* new TSS selector */
525	int		ext;		/* task switch due to external event */
526	uint32_t	errcode;
527	int		errcode_valid;	/* push 'errcode' on the new stack */
528	enum task_switch_reason reason;
529	struct vm_guest_paging paging;
530};
531
532struct vm_exit {
533	enum vm_exitcode	exitcode;
534	int			inst_length;	/* 0 means unknown */
535	uint64_t		rip;
536	union {
537		struct vm_inout	inout;
538		struct vm_inout_str inout_str;
539		struct {
540			uint64_t	gpa;
541			int		fault_type;
542		} paging;
543		struct {
544			uint64_t	gpa;
545			uint64_t	gla;
546			int		cs_d;		/* CS.D */
547			struct vm_guest_paging paging;
548			struct vie	vie;
549		} inst_emul;
550		/*
551		 * VMX specific payload. Used when there is no "better"
552		 * exitcode to represent the VM-exit.
553		 */
554		struct {
555			int		status;		/* vmx inst status */
556			/*
557			 * 'exit_reason' and 'exit_qualification' are valid
558			 * only if 'status' is zero.
559			 */
560			uint32_t	exit_reason;
561			uint64_t	exit_qualification;
562			/*
563			 * 'inst_error' and 'inst_type' are valid
564			 * only if 'status' is non-zero.
565			 */
566			int		inst_type;
567			int		inst_error;
568		} vmx;
569		/*
570		 * SVM specific payload.
571		 */
572		struct {
573			uint64_t	exitcode;
574			uint64_t	exitinfo1;
575			uint64_t	exitinfo2;
576		} svm;
577		struct {
578			uint32_t	code;		/* ecx value */
579			uint64_t	wval;
580		} msr;
581		struct {
582			int		vcpu;
583			uint64_t	rip;
584		} spinup_ap;
585		struct {
586			uint64_t	rflags;
587		} hlt;
588		struct {
589			int		vector;
590		} ioapic_eoi;
591		struct {
592			enum vm_suspend_how how;
593		} suspended;
594		struct vm_task_switch task_switch;
595	} u;
596};
597
598/* APIs to inject faults into the guest */
599void vm_inject_fault(void *vm, int vcpuid, int vector, int errcode_valid,
600    int errcode);
601
602static __inline void
603vm_inject_ud(void *vm, int vcpuid)
604{
605	vm_inject_fault(vm, vcpuid, IDT_UD, 0, 0);
606}
607
608static __inline void
609vm_inject_gp(void *vm, int vcpuid)
610{
611	vm_inject_fault(vm, vcpuid, IDT_GP, 1, 0);
612}
613
614static __inline void
615vm_inject_ac(void *vm, int vcpuid, int errcode)
616{
617	vm_inject_fault(vm, vcpuid, IDT_AC, 1, errcode);
618}
619
620static __inline void
621vm_inject_ss(void *vm, int vcpuid, int errcode)
622{
623	vm_inject_fault(vm, vcpuid, IDT_SS, 1, errcode);
624}
625
626void vm_inject_pf(void *vm, int vcpuid, int error_code, uint64_t cr2);
627
628#endif	/* _VMM_H_ */
629