KVM: Split cpuid register access from computation
[deliverable/linux.git] / arch / x86 / include / asm / kvm_emulate.h
CommitLineData
6aa8b732
AK
1/******************************************************************************
2 * x86_emulate.h
3 *
4 * Generic x86 (32-bit and 64-bit) instruction decoder and emulator.
5 *
6 * Copyright (c) 2005 Keir Fraser
7 *
8 * From: xen-unstable 10676:af9809f51f81a3c43f276f00c81a52ef558afda4
9 */
10
1965aae3
PA
11#ifndef _ASM_X86_KVM_X86_EMULATE_H
12#define _ASM_X86_KVM_X86_EMULATE_H
6aa8b732 13
38ba30ba
GN
14#include <asm/desc_defs.h>
15
6aa8b732 16struct x86_emulate_ctxt;
c4f035c6
AK
17enum x86_intercept;
18enum x86_intercept_stage;
6aa8b732 19
da9cb575
AK
20struct x86_exception {
21 u8 vector;
22 bool error_code_valid;
23 u16 error_code;
6389ee94
AK
24 bool nested_page_fault;
25 u64 address; /* cr2 or nested page fault gpa */
da9cb575
AK
26};
27
8a76d7f2
JR
28/*
29 * This struct is used to carry enough information from the instruction
30 * decoder to main KVM so that a decision can be made whether the
31 * instruction needs to be intercepted or not.
32 */
33struct x86_instruction_info {
34 u8 intercept; /* which intercept */
35 u8 rep_prefix; /* rep prefix? */
36 u8 modrm_mod; /* mod part of modrm */
37 u8 modrm_reg; /* index of register used */
38 u8 modrm_rm; /* rm part of modrm */
39 u64 src_val; /* value of source operand */
40 u8 src_bytes; /* size of source operand */
41 u8 dst_bytes; /* size of destination operand */
42 u8 ad_bytes; /* size of src/dst address */
43 u64 next_rip; /* rip following the instruction */
44};
45
6aa8b732
AK
46/*
47 * x86_emulate_ops:
48 *
49 * These operations represent the instruction emulator's interface to memory.
50 * There are two categories of operation: those that act on ordinary memory
51 * regions (*_std), and those that act on memory regions known to require
52 * special treatment or emulation (*_emulated).
53 *
54 * The emulator assumes that an instruction accesses only one 'emulated memory'
55 * location, that this location is the given linear faulting address (cr2), and
56 * that this is one of the instruction's data operands. Instruction fetches and
57 * stack operations are assumed never to access emulated memory. The emulator
58 * automatically deduces which operand of a string-move operation is accessing
59 * emulated memory, and assumes that the other operand accesses normal memory.
60 *
61 * NOTES:
62 * 1. The emulator isn't very smart about emulated vs. standard memory.
63 * 'Emulated memory' access addresses should be checked for sanity.
64 * 'Normal memory' accesses may fault, and the caller must arrange to
65 * detect and handle reentrancy into the emulator via recursive faults.
66 * Accesses may be unaligned and may cross page boundaries.
67 * 2. If the access fails (cannot emulate, or a standard access faults) then
68 * it is up to the memop to propagate the fault to the guest VM via
69 * some out-of-band mechanism, unknown to the emulator. The memop signals
70 * failure by returning X86EMUL_PROPAGATE_FAULT to the emulator, which will
71 * then immediately bail.
72 * 3. Valid access sizes are 1, 2, 4 and 8 bytes. On x86/32 systems only
73 * cmpxchg8b_emulated need support 8-byte accesses.
74 * 4. The emulator cannot handle 64-bit mode emulation on an x86/32 system.
75 */
76/* Access completed successfully: continue emulation as normal. */
77#define X86EMUL_CONTINUE 0
78/* Access is unhandleable: bail from emulation and return error to caller. */
79#define X86EMUL_UNHANDLEABLE 1
80/* Terminate emulation but return success to the caller. */
81#define X86EMUL_PROPAGATE_FAULT 2 /* propagate a generated fault to guest */
e680080e
GN
82#define X86EMUL_RETRY_INSTR 3 /* retry the instruction for some reason */
83#define X86EMUL_CMPXCHG_FAILED 4 /* cmpxchg did not see expected value */
c3cd7ffa 84#define X86EMUL_IO_NEEDED 5 /* IO is needed to complete emulation */
c4f035c6 85#define X86EMUL_INTERCEPTED 6 /* Intercepted by nested VMCB/VMCS */
e680080e 86
6aa8b732
AK
87struct x86_emulate_ops {
88 /*
89 * read_std: Read bytes of standard (non-emulated/special) memory.
1871c602 90 * Used for descriptor reading.
6aa8b732
AK
91 * @addr: [IN ] Linear address from which to read.
92 * @val: [OUT] Value read from memory, zero-extended to 'u_long'.
93 * @bytes: [IN ] Number of bytes to read from memory.
94 */
0f65dd70
AK
95 int (*read_std)(struct x86_emulate_ctxt *ctxt,
96 unsigned long addr, void *val,
97 unsigned int bytes,
bcc55cba 98 struct x86_exception *fault);
1871c602 99
2dafc6c2
GN
100 /*
101 * write_std: Write bytes of standard (non-emulated/special) memory.
102 * Used for descriptor writing.
103 * @addr: [IN ] Linear address to which to write.
104 * @val: [OUT] Value write to memory, zero-extended to 'u_long'.
105 * @bytes: [IN ] Number of bytes to write to memory.
106 */
0f65dd70
AK
107 int (*write_std)(struct x86_emulate_ctxt *ctxt,
108 unsigned long addr, void *val, unsigned int bytes,
bcc55cba 109 struct x86_exception *fault);
1871c602
GN
110 /*
111 * fetch: Read bytes of standard (non-emulated/special) memory.
112 * Used for instruction fetch.
113 * @addr: [IN ] Linear address from which to read.
114 * @val: [OUT] Value read from memory, zero-extended to 'u_long'.
115 * @bytes: [IN ] Number of bytes to read from memory.
116 */
0f65dd70
AK
117 int (*fetch)(struct x86_emulate_ctxt *ctxt,
118 unsigned long addr, void *val, unsigned int bytes,
bcc55cba 119 struct x86_exception *fault);
6aa8b732
AK
120
121 /*
122 * read_emulated: Read bytes from emulated/special memory area.
123 * @addr: [IN ] Linear address from which to read.
124 * @val: [OUT] Value read from memory, zero-extended to 'u_long'.
125 * @bytes: [IN ] Number of bytes to read from memory.
126 */
0f65dd70
AK
127 int (*read_emulated)(struct x86_emulate_ctxt *ctxt,
128 unsigned long addr, void *val, unsigned int bytes,
129 struct x86_exception *fault);
6aa8b732
AK
130
131 /*
0d178975 132 * write_emulated: Write bytes to emulated/special memory area.
6aa8b732
AK
133 * @addr: [IN ] Linear address to which to write.
134 * @val: [IN ] Value to write to memory (low-order bytes used as
135 * required).
136 * @bytes: [IN ] Number of bytes to write to memory.
137 */
0f65dd70
AK
138 int (*write_emulated)(struct x86_emulate_ctxt *ctxt,
139 unsigned long addr, const void *val,
0c7825e6 140 unsigned int bytes,
0f65dd70 141 struct x86_exception *fault);
6aa8b732
AK
142
143 /*
144 * cmpxchg_emulated: Emulate an atomic (LOCKed) CMPXCHG operation on an
145 * emulated/special memory area.
146 * @addr: [IN ] Linear address to access.
147 * @old: [IN ] Value expected to be current at @addr.
148 * @new: [IN ] Value to write to @addr.
149 * @bytes: [IN ] Number of bytes to access using CMPXCHG.
150 */
0f65dd70
AK
151 int (*cmpxchg_emulated)(struct x86_emulate_ctxt *ctxt,
152 unsigned long addr,
0c7825e6
JP
153 const void *old,
154 const void *new,
155 unsigned int bytes,
0f65dd70 156 struct x86_exception *fault);
3cb16fe7 157 void (*invlpg)(struct x86_emulate_ctxt *ctxt, ulong addr);
cf8f70bf 158
ca1d4a9e
AK
159 int (*pio_in_emulated)(struct x86_emulate_ctxt *ctxt,
160 int size, unsigned short port, void *val,
161 unsigned int count);
cf8f70bf 162
ca1d4a9e
AK
163 int (*pio_out_emulated)(struct x86_emulate_ctxt *ctxt,
164 int size, unsigned short port, const void *val,
165 unsigned int count);
cf8f70bf 166
1aa36616
AK
167 bool (*get_segment)(struct x86_emulate_ctxt *ctxt, u16 *selector,
168 struct desc_struct *desc, u32 *base3, int seg);
169 void (*set_segment)(struct x86_emulate_ctxt *ctxt, u16 selector,
170 struct desc_struct *desc, u32 base3, int seg);
4bff1e86
AK
171 unsigned long (*get_cached_segment_base)(struct x86_emulate_ctxt *ctxt,
172 int seg);
173 void (*get_gdt)(struct x86_emulate_ctxt *ctxt, struct desc_ptr *dt);
174 void (*get_idt)(struct x86_emulate_ctxt *ctxt, struct desc_ptr *dt);
1ac9d0cf
AK
175 void (*set_gdt)(struct x86_emulate_ctxt *ctxt, struct desc_ptr *dt);
176 void (*set_idt)(struct x86_emulate_ctxt *ctxt, struct desc_ptr *dt);
717746e3
AK
177 ulong (*get_cr)(struct x86_emulate_ctxt *ctxt, int cr);
178 int (*set_cr)(struct x86_emulate_ctxt *ctxt, int cr, ulong val);
4cee4798 179 void (*set_rflags)(struct x86_emulate_ctxt *ctxt, ulong val);
717746e3
AK
180 int (*cpl)(struct x86_emulate_ctxt *ctxt);
181 int (*get_dr)(struct x86_emulate_ctxt *ctxt, int dr, ulong *dest);
182 int (*set_dr)(struct x86_emulate_ctxt *ctxt, int dr, ulong value);
183 int (*set_msr)(struct x86_emulate_ctxt *ctxt, u32 msr_index, u64 data);
184 int (*get_msr)(struct x86_emulate_ctxt *ctxt, u32 msr_index, u64 *pdata);
222d21aa 185 int (*read_pmc)(struct x86_emulate_ctxt *ctxt, u32 pmc, u64 *pdata);
6c3287f7 186 void (*halt)(struct x86_emulate_ctxt *ctxt);
bcaf5cc5 187 void (*wbinvd)(struct x86_emulate_ctxt *ctxt);
d6aa1000 188 int (*fix_hypercall)(struct x86_emulate_ctxt *ctxt);
5037f6f3
AK
189 void (*get_fpu)(struct x86_emulate_ctxt *ctxt); /* disables preempt */
190 void (*put_fpu)(struct x86_emulate_ctxt *ctxt); /* reenables preempt */
2953538e 191 int (*intercept)(struct x86_emulate_ctxt *ctxt,
8a76d7f2 192 struct x86_instruction_info *info,
c4f035c6 193 enum x86_intercept_stage stage);
bdb42f5a
SB
194
195 bool (*get_cpuid)(struct x86_emulate_ctxt *ctxt,
196 u32 *eax, u32 *ebx, u32 *ecx, u32 *edx);
6aa8b732
AK
197};
198
1253791d
AK
199typedef u32 __attribute__((vector_size(16))) sse128_t;
200
e4e03ded
LV
201/* Type, address-of, and value of an instruction's operand. */
202struct operand {
cbe2c9d3 203 enum { OP_REG, OP_MEM, OP_IMM, OP_XMM, OP_MM, OP_NONE } type;
e4e03ded 204 unsigned int bytes;
16518d5a
AK
205 union {
206 unsigned long orig_val;
207 u64 orig_val64;
208 };
1a6440ae
AK
209 union {
210 unsigned long *reg;
90de84f5
AK
211 struct segmented_address {
212 ulong ea;
213 unsigned seg;
214 } mem;
1253791d 215 unsigned xmm;
cbe2c9d3 216 unsigned mm;
1a6440ae 217 } addr;
414e6277
GN
218 union {
219 unsigned long val;
16518d5a 220 u64 val64;
414e6277 221 char valptr[sizeof(unsigned long) + 2];
1253791d 222 sse128_t vec_val;
cbe2c9d3 223 u64 mm_val;
414e6277 224 };
e4e03ded
LV
225};
226
62266869
AK
227struct fetch_cache {
228 u8 data[15];
229 unsigned long start;
230 unsigned long end;
231};
232
7b262e90
GN
233struct read_cache {
234 u8 data[1024];
235 unsigned long pos;
236 unsigned long end;
237};
238
9dac77fa
AK
239struct x86_emulate_ctxt {
240 struct x86_emulate_ops *ops;
241
242 /* Register state before/after emulation. */
243 unsigned long eflags;
244 unsigned long eip; /* eip before instruction emulation */
245 /* Emulated execution mode, represented by an X86EMUL_MODE value. */
246 int mode;
247
248 /* interruptibility state, as a result of execution of STI or MOV SS */
249 int interruptibility;
250
251 bool guest_mode; /* guest running a nested guest */
252 bool perm_ok; /* do not check permissions if true */
253 bool only_vendor_specific_insn;
254
255 bool have_exception;
256 struct x86_exception exception;
257
258 /* decode cache */
e4e03ded
LV
259 u8 twobyte;
260 u8 b;
c4f035c6 261 u8 intercept;
e4e03ded
LV
262 u8 lock_prefix;
263 u8 rep_prefix;
264 u8 op_bytes;
265 u8 ad_bytes;
33615aa9 266 u8 rex_prefix;
e4e03ded 267 struct operand src;
0dc8d10f 268 struct operand src2;
e4e03ded 269 struct operand dst;
7a5b56df
AK
270 bool has_seg_override;
271 u8 seg_override;
b1ea50b2 272 u64 d;
ef65c889 273 int (*execute)(struct x86_emulate_ctxt *ctxt);
d09beabd 274 int (*check_perm)(struct x86_emulate_ctxt *ctxt);
e4e03ded
LV
275 /* modrm */
276 u8 modrm;
277 u8 modrm_mod;
278 u8 modrm_reg;
279 u8 modrm_rm;
09ee57cd 280 u8 modrm_seg;
f5b4edcd 281 bool rip_relative;
36dd9bb5 282 unsigned long _eip;
b5c9ff73
TY
283 /* Fields above regs are cleared together. */
284 unsigned long regs[NR_VCPU_REGS];
f09ed83e
AK
285 struct operand memop;
286 struct operand *memopp;
62266869 287 struct fetch_cache fetch;
7b262e90 288 struct read_cache io_read;
9de41573 289 struct read_cache mem_read;
e4e03ded
LV
290};
291
90e0a28f 292/* Repeat String Operation Prefix */
1d6b114f
AK
293#define REPE_PREFIX 0xf3
294#define REPNE_PREFIX 0xf2
90e0a28f 295
6aa8b732
AK
296/* Execution mode, passed to the emulator. */
297#define X86EMUL_MODE_REAL 0 /* Real mode. */
a0044755 298#define X86EMUL_MODE_VM86 1 /* Virtual 8086 mode. */
6aa8b732
AK
299#define X86EMUL_MODE_PROT16 2 /* 16-bit protected mode. */
300#define X86EMUL_MODE_PROT32 4 /* 32-bit protected mode. */
301#define X86EMUL_MODE_PROT64 8 /* 64-bit (long) mode. */
302
8ea7d6ae
JR
303/* any protected mode */
304#define X86EMUL_MODE_PROT (X86EMUL_MODE_PROT16|X86EMUL_MODE_PROT32| \
305 X86EMUL_MODE_PROT64)
306
c2226fc9
SB
307/* CPUID vendors */
308#define X86EMUL_CPUID_VENDOR_AuthenticAMD_ebx 0x68747541
309#define X86EMUL_CPUID_VENDOR_AuthenticAMD_ecx 0x444d4163
310#define X86EMUL_CPUID_VENDOR_AuthenticAMD_edx 0x69746e65
311
312#define X86EMUL_CPUID_VENDOR_AMDisbetterI_ebx 0x69444d41
313#define X86EMUL_CPUID_VENDOR_AMDisbetterI_ecx 0x21726574
314#define X86EMUL_CPUID_VENDOR_AMDisbetterI_edx 0x74656273
315
316#define X86EMUL_CPUID_VENDOR_GenuineIntel_ebx 0x756e6547
317#define X86EMUL_CPUID_VENDOR_GenuineIntel_ecx 0x6c65746e
318#define X86EMUL_CPUID_VENDOR_GenuineIntel_edx 0x49656e69
319
c4f035c6 320enum x86_intercept_stage {
40e19b51 321 X86_ICTP_NONE = 0, /* Allow zero-init to not match anything */
c4f035c6
AK
322 X86_ICPT_PRE_EXCEPT,
323 X86_ICPT_POST_EXCEPT,
324 X86_ICPT_POST_MEMACCESS,
325};
326
327enum x86_intercept {
328 x86_intercept_none,
cfec82cb
JR
329 x86_intercept_cr_read,
330 x86_intercept_cr_write,
331 x86_intercept_clts,
3c6e276f
AK
332 x86_intercept_lmsw,
333 x86_intercept_smsw,
3b88e41a
JR
334 x86_intercept_dr_read,
335 x86_intercept_dr_write,
3c6e276f
AK
336 x86_intercept_lidt,
337 x86_intercept_sidt,
338 x86_intercept_lgdt,
339 x86_intercept_sgdt,
340 x86_intercept_lldt,
341 x86_intercept_sldt,
342 x86_intercept_ltr,
343 x86_intercept_str,
344 x86_intercept_rdtsc,
345 x86_intercept_rdpmc,
346 x86_intercept_pushf,
347 x86_intercept_popf,
348 x86_intercept_cpuid,
349 x86_intercept_rsm,
350 x86_intercept_iret,
351 x86_intercept_intn,
352 x86_intercept_invd,
353 x86_intercept_pause,
354 x86_intercept_hlt,
355 x86_intercept_invlpg,
356 x86_intercept_invlpga,
357 x86_intercept_vmrun,
358 x86_intercept_vmload,
359 x86_intercept_vmsave,
360 x86_intercept_vmmcall,
361 x86_intercept_stgi,
362 x86_intercept_clgi,
363 x86_intercept_skinit,
364 x86_intercept_rdtscp,
365 x86_intercept_icebp,
366 x86_intercept_wbinvd,
367 x86_intercept_monitor,
368 x86_intercept_mwait,
8061252e
JR
369 x86_intercept_rdmsr,
370 x86_intercept_wrmsr,
f6511935
JR
371 x86_intercept_in,
372 x86_intercept_ins,
373 x86_intercept_out,
374 x86_intercept_outs,
c4f035c6
AK
375
376 nr_x86_intercepts
377};
378
6aa8b732 379/* Host execution mode. */
d73fa29a 380#if defined(CONFIG_X86_32)
6aa8b732 381#define X86EMUL_MODE_HOST X86EMUL_MODE_PROT32
05b3e0c2 382#elif defined(CONFIG_X86_64)
6aa8b732
AK
383#define X86EMUL_MODE_HOST X86EMUL_MODE_PROT64
384#endif
385
dc25e89e 386int x86_decode_insn(struct x86_emulate_ctxt *ctxt, void *insn, int insn_len);
1cb3f3ae 387bool x86_page_table_writing_insn(struct x86_emulate_ctxt *ctxt);
d2ddd1c4
GN
388#define EMULATION_FAILED -1
389#define EMULATION_OK 0
390#define EMULATION_RESTART 1
775fde86 391#define EMULATION_INTERCEPTED 2
9aabc88f 392int x86_emulate_insn(struct x86_emulate_ctxt *ctxt);
38ba30ba 393int emulator_task_switch(struct x86_emulate_ctxt *ctxt,
7f3d35fd 394 u16 tss_selector, int idt_index, int reason,
e269fb21 395 bool has_error_code, u32 error_code);
7b105ca2 396int emulate_int_real(struct x86_emulate_ctxt *ctxt, int irq);
1965aae3 397#endif /* _ASM_X86_KVM_X86_EMULATE_H */
This page took 0.450107 seconds and 5 git commands to generate.