]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - arch/x86/include/asm/kvm_host.h
KVM: SVM: Add support for AMD's OSVW feature in guests
[mirror_ubuntu-zesty-kernel.git] / arch / x86 / include / asm / kvm_host.h
CommitLineData
a656c8ef 1/*
043405e1
CO
2 * Kernel-based Virtual Machine driver for Linux
3 *
4 * This header defines architecture specific interfaces, x86 version
5 *
6 * This work is licensed under the terms of the GNU GPL, version 2. See
7 * the COPYING file in the top-level directory.
8 *
9 */
10
1965aae3
PA
11#ifndef _ASM_X86_KVM_HOST_H
12#define _ASM_X86_KVM_HOST_H
043405e1 13
34c16eec
ZX
14#include <linux/types.h>
15#include <linux/mm.h>
e930bffe 16#include <linux/mmu_notifier.h>
229456fc 17#include <linux/tracepoint.h>
f5f48ee1 18#include <linux/cpumask.h>
f5132b01 19#include <linux/irq_work.h>
34c16eec
ZX
20
21#include <linux/kvm.h>
22#include <linux/kvm_para.h>
edf88417 23#include <linux/kvm_types.h>
f5132b01 24#include <linux/perf_event.h>
34c16eec 25
50d0a0f9 26#include <asm/pvclock-abi.h>
e01a1b57 27#include <asm/desc.h>
0bed3b56 28#include <asm/mtrr.h>
9962d032 29#include <asm/msr-index.h>
e01a1b57 30
8c3ba334
SL
31#define KVM_MAX_VCPUS 254
32#define KVM_SOFT_MAX_VCPUS 64
69a9f69b
AK
33#define KVM_MEMORY_SLOTS 32
34/* memory slots that does not exposed to userspace */
35#define KVM_PRIVATE_MEM_SLOTS 4
93a5cef0
XG
36#define KVM_MEM_SLOTS_NUM (KVM_MEMORY_SLOTS + KVM_PRIVATE_MEM_SLOTS)
37
cef4dea0 38#define KVM_MMIO_SIZE 16
69a9f69b
AK
39
40#define KVM_PIO_PAGE_OFFSET 1
542472b5 41#define KVM_COALESCED_MMIO_PAGE_OFFSET 2
69a9f69b 42
cfec82cb
JR
43#define CR0_RESERVED_BITS \
44 (~(unsigned long)(X86_CR0_PE | X86_CR0_MP | X86_CR0_EM | X86_CR0_TS \
45 | X86_CR0_ET | X86_CR0_NE | X86_CR0_WP | X86_CR0_AM \
46 | X86_CR0_NW | X86_CR0_CD | X86_CR0_PG))
47
cd6e8f87
ZX
48#define CR3_PAE_RESERVED_BITS ((X86_CR3_PWT | X86_CR3_PCD) - 1)
49#define CR3_NONPAE_RESERVED_BITS ((PAGE_SIZE-1) & ~(X86_CR3_PWT | X86_CR3_PCD))
7d76b4d3
JP
50#define CR3_L_MODE_RESERVED_BITS (CR3_NONPAE_RESERVED_BITS | \
51 0xFFFFFF0000000000ULL)
cfec82cb
JR
52#define CR4_RESERVED_BITS \
53 (~(unsigned long)(X86_CR4_VME | X86_CR4_PVI | X86_CR4_TSD | X86_CR4_DE\
54 | X86_CR4_PSE | X86_CR4_PAE | X86_CR4_MCE \
55 | X86_CR4_PGE | X86_CR4_PCE | X86_CR4_OSFXSR \
d9c3476d 56 | X86_CR4_OSXSAVE | X86_CR4_SMEP | X86_CR4_RDWRGSFS \
cfec82cb
JR
57 | X86_CR4_OSXMMEXCPT | X86_CR4_VMXE))
58
59#define CR8_RESERVED_BITS (~(unsigned long)X86_CR8_TPR)
60
61
cd6e8f87 62
cd6e8f87 63#define INVALID_PAGE (~(hpa_t)0)
dd180b3e
XG
64#define VALID_PAGE(x) ((x) != INVALID_PAGE)
65
cd6e8f87
ZX
66#define UNMAPPED_GVA (~(gpa_t)0)
67
ec04b260 68/* KVM Hugepage definitions for x86 */
04326caa 69#define KVM_NR_PAGE_SIZES 3
82855413
JR
70#define KVM_HPAGE_GFN_SHIFT(x) (((x) - 1) * 9)
71#define KVM_HPAGE_SHIFT(x) (PAGE_SHIFT + KVM_HPAGE_GFN_SHIFT(x))
ec04b260
JR
72#define KVM_HPAGE_SIZE(x) (1UL << KVM_HPAGE_SHIFT(x))
73#define KVM_HPAGE_MASK(x) (~(KVM_HPAGE_SIZE(x) - 1))
74#define KVM_PAGES_PER_HPAGE(x) (KVM_HPAGE_SIZE(x) / PAGE_SIZE)
05da4558 75
cd6e8f87 76#define DE_VECTOR 0
19bd8afd 77#define DB_VECTOR 1
77ab6db0
JK
78#define BP_VECTOR 3
79#define OF_VECTOR 4
80#define BR_VECTOR 5
cd6e8f87
ZX
81#define UD_VECTOR 6
82#define NM_VECTOR 7
83#define DF_VECTOR 8
84#define TS_VECTOR 10
85#define NP_VECTOR 11
86#define SS_VECTOR 12
87#define GP_VECTOR 13
88#define PF_VECTOR 14
77ab6db0 89#define MF_VECTOR 16
53371b50 90#define MC_VECTOR 18
cd6e8f87
ZX
91
92#define SELECTOR_TI_MASK (1 << 2)
93#define SELECTOR_RPL_MASK 0x03
94
95#define IOPL_SHIFT 12
96
d657a98e
ZX
97#define KVM_PERMILLE_MMU_PAGES 20
98#define KVM_MIN_ALLOC_MMU_PAGES 64
1ae0a13d
DE
99#define KVM_MMU_HASH_SHIFT 10
100#define KVM_NUM_MMU_PAGES (1 << KVM_MMU_HASH_SHIFT)
d657a98e
ZX
101#define KVM_MIN_FREE_MMU_PAGES 5
102#define KVM_REFILL_PAGES 25
73c1160c 103#define KVM_MAX_CPUID_ENTRIES 80
0bed3b56 104#define KVM_NR_FIXED_MTRR_REGION 88
9ba075a6 105#define KVM_NR_VAR_MTRR 8
d657a98e 106
af585b92
GN
107#define ASYNC_PF_PER_VCPU 64
108
e935b837 109extern raw_spinlock_t kvm_lock;
e9b11c17
ZX
110extern struct list_head vm_list;
111
d657a98e
ZX
112struct kvm_vcpu;
113struct kvm;
af585b92 114struct kvm_async_pf;
d657a98e 115
5fdbf976 116enum kvm_reg {
2b3ccfa0
ZX
117 VCPU_REGS_RAX = 0,
118 VCPU_REGS_RCX = 1,
119 VCPU_REGS_RDX = 2,
120 VCPU_REGS_RBX = 3,
121 VCPU_REGS_RSP = 4,
122 VCPU_REGS_RBP = 5,
123 VCPU_REGS_RSI = 6,
124 VCPU_REGS_RDI = 7,
125#ifdef CONFIG_X86_64
126 VCPU_REGS_R8 = 8,
127 VCPU_REGS_R9 = 9,
128 VCPU_REGS_R10 = 10,
129 VCPU_REGS_R11 = 11,
130 VCPU_REGS_R12 = 12,
131 VCPU_REGS_R13 = 13,
132 VCPU_REGS_R14 = 14,
133 VCPU_REGS_R15 = 15,
134#endif
5fdbf976 135 VCPU_REGS_RIP,
2b3ccfa0
ZX
136 NR_VCPU_REGS
137};
138
6de4f3ad
AK
139enum kvm_reg_ex {
140 VCPU_EXREG_PDPTR = NR_VCPU_REGS,
aff48baa 141 VCPU_EXREG_CR3,
6de12732 142 VCPU_EXREG_RFLAGS,
69c73028 143 VCPU_EXREG_CPL,
2fb92db1 144 VCPU_EXREG_SEGMENTS,
6de4f3ad
AK
145};
146
2b3ccfa0 147enum {
81609e3e 148 VCPU_SREG_ES,
2b3ccfa0 149 VCPU_SREG_CS,
81609e3e 150 VCPU_SREG_SS,
2b3ccfa0 151 VCPU_SREG_DS,
2b3ccfa0
ZX
152 VCPU_SREG_FS,
153 VCPU_SREG_GS,
2b3ccfa0
ZX
154 VCPU_SREG_TR,
155 VCPU_SREG_LDTR,
156};
157
56e82318 158#include <asm/kvm_emulate.h>
2b3ccfa0 159
d657a98e
ZX
160#define KVM_NR_MEM_OBJS 40
161
42dbaa5a
JK
162#define KVM_NR_DB_REGS 4
163
164#define DR6_BD (1 << 13)
165#define DR6_BS (1 << 14)
166#define DR6_FIXED_1 0xffff0ff0
167#define DR6_VOLATILE 0x0000e00f
168
169#define DR7_BP_EN_MASK 0x000000ff
170#define DR7_GE (1 << 9)
171#define DR7_GD (1 << 13)
172#define DR7_FIXED_1 0x00000400
173#define DR7_VOLATILE 0xffff23ff
174
d657a98e
ZX
175/*
176 * We don't want allocation failures within the mmu code, so we preallocate
177 * enough memory for a single page fault in a cache.
178 */
179struct kvm_mmu_memory_cache {
180 int nobjs;
181 void *objects[KVM_NR_MEM_OBJS];
182};
183
184#define NR_PTE_CHAIN_ENTRIES 5
185
186struct kvm_pte_chain {
187 u64 *parent_ptes[NR_PTE_CHAIN_ENTRIES];
188 struct hlist_node link;
189};
190
191/*
192 * kvm_mmu_page_role, below, is defined as:
193 *
194 * bits 0:3 - total guest paging levels (2-4, or zero for real mode)
195 * bits 4:7 - page table level for this shadow (1-4)
196 * bits 8:9 - page table quadrant for 2-level guests
f6e2c02b
AK
197 * bit 16 - direct mapping of virtual to physical mapping at gfn
198 * used for real mode and two-dimensional paging
d657a98e
ZX
199 * bits 17:19 - common access permissions for all ptes in this shadow page
200 */
201union kvm_mmu_page_role {
202 unsigned word;
203 struct {
7d76b4d3 204 unsigned level:4;
5b7e0102 205 unsigned cr4_pae:1;
7d76b4d3
JP
206 unsigned quadrant:2;
207 unsigned pad_for_nice_hex_output:6;
f6e2c02b 208 unsigned direct:1;
7d76b4d3 209 unsigned access:3;
2e53d63a 210 unsigned invalid:1;
9645bb56 211 unsigned nxe:1;
3dbe1415 212 unsigned cr0_wp:1;
411c588d 213 unsigned smep_andnot_wp:1;
d657a98e
ZX
214 };
215};
216
217struct kvm_mmu_page {
218 struct list_head link;
219 struct hlist_node hash_link;
220
221 /*
222 * The following two entries are used to key the shadow page in the
223 * hash table.
224 */
225 gfn_t gfn;
226 union kvm_mmu_page_role role;
227
228 u64 *spt;
229 /* hold the gfn of each spte inside spt */
230 gfn_t *gfns;
291f26bc
SY
231 /*
232 * One bit set per slot which has memory
233 * in this shadow page.
234 */
93a5cef0 235 DECLARE_BITMAP(slot_bitmap, KVM_MEM_SLOTS_NUM);
4731d4c7 236 bool unsync;
0571d366 237 int root_count; /* Currently serving as active root */
60c8aec6 238 unsigned int unsync_children;
67052b35 239 unsigned long parent_ptes; /* Reverse mapping for parent_pte */
0074ff63 240 DECLARE_BITMAP(unsync_child_bitmap, 512);
c2a2ac2b
XG
241
242#ifdef CONFIG_X86_32
243 int clear_spte_count;
244#endif
245
a30f47cb
XG
246 int write_flooding_count;
247
c2a2ac2b 248 struct rcu_head rcu;
d657a98e
ZX
249};
250
1c08364c
AK
251struct kvm_pio_request {
252 unsigned long count;
1c08364c
AK
253 int in;
254 int port;
255 int size;
1c08364c
AK
256};
257
d657a98e
ZX
258/*
259 * x86 supports 3 paging modes (4-level 64-bit, 3-level 64-bit, and 2-level
260 * 32-bit). The kvm_mmu structure abstracts the details of the current mmu
261 * mode.
262 */
263struct kvm_mmu {
264 void (*new_cr3)(struct kvm_vcpu *vcpu);
f43addd4 265 void (*set_cr3)(struct kvm_vcpu *vcpu, unsigned long root);
5777ed34 266 unsigned long (*get_cr3)(struct kvm_vcpu *vcpu);
e4e517b4 267 u64 (*get_pdptr)(struct kvm_vcpu *vcpu, int index);
78b2c54a
XG
268 int (*page_fault)(struct kvm_vcpu *vcpu, gva_t gva, u32 err,
269 bool prefault);
6389ee94
AK
270 void (*inject_page_fault)(struct kvm_vcpu *vcpu,
271 struct x86_exception *fault);
d657a98e 272 void (*free)(struct kvm_vcpu *vcpu);
1871c602 273 gpa_t (*gva_to_gpa)(struct kvm_vcpu *vcpu, gva_t gva, u32 access,
ab9ae313 274 struct x86_exception *exception);
c30a358d 275 gpa_t (*translate_gpa)(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access);
e8bc217a 276 int (*sync_page)(struct kvm_vcpu *vcpu,
a4a8e6f7 277 struct kvm_mmu_page *sp);
a7052897 278 void (*invlpg)(struct kvm_vcpu *vcpu, gva_t gva);
0f53b5b1 279 void (*update_pte)(struct kvm_vcpu *vcpu, struct kvm_mmu_page *sp,
7c562522 280 u64 *spte, const void *pte);
d657a98e
ZX
281 hpa_t root_hpa;
282 int root_level;
283 int shadow_root_level;
a770f6f2 284 union kvm_mmu_page_role base_role;
c5a78f2b 285 bool direct_map;
d657a98e
ZX
286
287 u64 *pae_root;
81407ca5 288 u64 *lm_root;
82725b20 289 u64 rsvd_bits_mask[2][4];
ff03a073 290
2d48a985
JR
291 bool nx;
292
ff03a073 293 u64 pdptrs[4]; /* pae */
d657a98e
ZX
294};
295
f5132b01
GN
296enum pmc_type {
297 KVM_PMC_GP = 0,
298 KVM_PMC_FIXED,
299};
300
301struct kvm_pmc {
302 enum pmc_type type;
303 u8 idx;
304 u64 counter;
305 u64 eventsel;
306 struct perf_event *perf_event;
307 struct kvm_vcpu *vcpu;
308};
309
310struct kvm_pmu {
311 unsigned nr_arch_gp_counters;
312 unsigned nr_arch_fixed_counters;
313 unsigned available_event_types;
314 u64 fixed_ctr_ctrl;
315 u64 global_ctrl;
316 u64 global_status;
317 u64 global_ovf_ctrl;
318 u64 counter_bitmask[2];
319 u64 global_ctrl_mask;
320 u8 version;
321 struct kvm_pmc gp_counters[X86_PMC_MAX_GENERIC];
322 struct kvm_pmc fixed_counters[X86_PMC_MAX_FIXED];
323 struct irq_work irq_work;
324 u64 reprogram_pmi;
325};
326
ad312c7c 327struct kvm_vcpu_arch {
5fdbf976
MT
328 /*
329 * rip and regs accesses must go through
330 * kvm_{register,rip}_{read,write} functions.
331 */
332 unsigned long regs[NR_VCPU_REGS];
333 u32 regs_avail;
334 u32 regs_dirty;
34c16eec
ZX
335
336 unsigned long cr0;
e8467fda 337 unsigned long cr0_guest_owned_bits;
34c16eec
ZX
338 unsigned long cr2;
339 unsigned long cr3;
340 unsigned long cr4;
fc78f519 341 unsigned long cr4_guest_owned_bits;
34c16eec 342 unsigned long cr8;
1371d904 343 u32 hflags;
f6801dff 344 u64 efer;
34c16eec
ZX
345 u64 apic_base;
346 struct kvm_lapic *apic; /* kernel irqchip context */
e1035715 347 int32_t apic_arb_prio;
34c16eec
ZX
348 int mp_state;
349 int sipi_vector;
350 u64 ia32_misc_enable_msr;
b209749f 351 bool tpr_access_reporting;
34c16eec 352
14dfe855
JR
353 /*
354 * Paging state of the vcpu
355 *
356 * If the vcpu runs in guest mode with two level paging this still saves
357 * the paging mode of the l1 guest. This context is always used to
358 * handle faults.
359 */
34c16eec 360 struct kvm_mmu mmu;
8df25a32 361
6539e738
JR
362 /*
363 * Paging state of an L2 guest (used for nested npt)
364 *
365 * This context will save all necessary information to walk page tables
366 * of the an L2 guest. This context is only initialized for page table
367 * walking and not for faulting since we never handle l2 page faults on
368 * the host.
369 */
370 struct kvm_mmu nested_mmu;
371
14dfe855
JR
372 /*
373 * Pointer to the mmu context currently used for
374 * gva_to_gpa translations.
375 */
376 struct kvm_mmu *walk_mmu;
377
53c07b18 378 struct kvm_mmu_memory_cache mmu_pte_list_desc_cache;
34c16eec
ZX
379 struct kvm_mmu_memory_cache mmu_page_cache;
380 struct kvm_mmu_memory_cache mmu_page_header_cache;
381
98918833 382 struct fpu guest_fpu;
2acf923e 383 u64 xcr0;
34c16eec 384
34c16eec
ZX
385 struct kvm_pio_request pio;
386 void *pio_data;
387
66fd3f7f
GN
388 u8 event_exit_inst_len;
389
298101da
AK
390 struct kvm_queued_exception {
391 bool pending;
392 bool has_error_code;
ce7ddec4 393 bool reinject;
298101da
AK
394 u8 nr;
395 u32 error_code;
396 } exception;
397
937a7eae
AK
398 struct kvm_queued_interrupt {
399 bool pending;
66fd3f7f 400 bool soft;
937a7eae
AK
401 u8 nr;
402 } interrupt;
403
34c16eec
ZX
404 int halt_request; /* real mode on Intel only */
405
406 int cpuid_nent;
07716717 407 struct kvm_cpuid_entry2 cpuid_entries[KVM_MAX_CPUID_ENTRIES];
34c16eec
ZX
408 /* emulate context */
409
410 struct x86_emulate_ctxt emulate_ctxt;
7ae441ea
GN
411 bool emulate_regs_need_sync_to_vcpu;
412 bool emulate_regs_need_sync_from_vcpu;
18068523
GOC
413
414 gpa_t time;
50d0a0f9 415 struct pvclock_vcpu_time_info hv_clock;
e48672fa 416 unsigned int hw_tsc_khz;
18068523
GOC
417 unsigned int time_offset;
418 struct page *time_page;
c9aaa895
GC
419
420 struct {
421 u64 msr_val;
422 u64 last_steal;
423 u64 accum_steal;
424 struct gfn_to_hva_cache stime;
425 struct kvm_steal_time steal;
426 } st;
427
1d5f066e
ZA
428 u64 last_guest_tsc;
429 u64 last_kernel_ns;
c285545f
ZA
430 u64 last_tsc_nsec;
431 u64 last_tsc_write;
1e993611 432 u32 virtual_tsc_khz;
c285545f 433 bool tsc_catchup;
1e993611
JR
434 u32 tsc_catchup_mult;
435 s8 tsc_catchup_shift;
3419ffc8 436
7460fb4a
AK
437 atomic_t nmi_queued; /* unprocessed asynchronous NMIs */
438 unsigned nmi_pending; /* NMI queued after currently running handler */
439 bool nmi_injected; /* Trying to inject an NMI this entry */
9ba075a6 440
0bed3b56
SY
441 struct mtrr_state_type mtrr_state;
442 u32 pat;
42dbaa5a
JK
443
444 int switch_db_regs;
42dbaa5a
JK
445 unsigned long db[KVM_NR_DB_REGS];
446 unsigned long dr6;
447 unsigned long dr7;
448 unsigned long eff_db[KVM_NR_DB_REGS];
890ca9ae
HY
449
450 u64 mcg_cap;
451 u64 mcg_status;
452 u64 mcg_ctl;
453 u64 *mce_banks;
94fe45da 454
bebb106a
XG
455 /* Cache MMIO info */
456 u64 mmio_gva;
457 unsigned access;
458 gfn_t mmio_gfn;
459
f5132b01
GN
460 struct kvm_pmu pmu;
461
94fe45da 462 /* used for guest single stepping over the given code position */
94fe45da 463 unsigned long singlestep_rip;
f92653ee 464
10388a07
GN
465 /* fields used by HYPER-V emulation */
466 u64 hv_vapic;
f5f48ee1
SY
467
468 cpumask_var_t wbinvd_dirty_mask;
af585b92 469
1cb3f3ae
XG
470 unsigned long last_retry_eip;
471 unsigned long last_retry_addr;
472
af585b92
GN
473 struct {
474 bool halted;
475 gfn_t gfns[roundup_pow_of_two(ASYNC_PF_PER_VCPU)];
344d9588
GN
476 struct gfn_to_hva_cache data;
477 u64 msr_val;
7c90705b 478 u32 id;
6adba527 479 bool send_user_only;
af585b92 480 } apf;
2b036c6b
BO
481
482 /* OSVW MSRs (AMD only) */
483 struct {
484 u64 length;
485 u64 status;
486 } osvw;
34c16eec
ZX
487};
488
fef9cce0 489struct kvm_arch {
49d5ca26 490 unsigned int n_used_mmu_pages;
f05e70ac 491 unsigned int n_requested_mmu_pages;
39de71ec 492 unsigned int n_max_mmu_pages;
332b207d 493 unsigned int indirect_shadow_pages;
f05e70ac
ZX
494 struct hlist_head mmu_page_hash[KVM_NUM_MMU_PAGES];
495 /*
496 * Hash table of struct kvm_mmu_page.
497 */
498 struct list_head active_mmu_pages;
4d5c5d0f 499 struct list_head assigned_dev_head;
19de40a8 500 struct iommu_domain *iommu_domain;
522c68c4 501 int iommu_flags;
d7deeeb0
ZX
502 struct kvm_pic *vpic;
503 struct kvm_ioapic *vioapic;
7837699f 504 struct kvm_pit *vpit;
cc6e462c 505 int vapics_in_nmi_mode;
bfc6d222 506
bfc6d222
ZX
507 unsigned int tss_addr;
508 struct page *apic_access_page;
18068523
GOC
509
510 gpa_t wall_clock;
b7ebfb05
SY
511
512 struct page *ept_identity_pagetable;
513 bool ept_identity_pagetable_done;
b927a3ce 514 gpa_t ept_identity_map_addr;
5550af4d
SY
515
516 unsigned long irq_sources_bitmap;
afbcf7ab 517 s64 kvmclock_offset;
038f8c11 518 raw_spinlock_t tsc_write_lock;
f38e098f
ZA
519 u64 last_tsc_nsec;
520 u64 last_tsc_offset;
521 u64 last_tsc_write;
ffde22ac
ES
522
523 struct kvm_xen_hvm_config xen_hvm_config;
55cd8e5a
GN
524
525 /* fields used by HYPER-V emulation */
526 u64 hv_guest_os_id;
527 u64 hv_hypercall;
b034cf01 528
c2a2ac2b
XG
529 atomic_t reader_counter;
530
b034cf01
XG
531 #ifdef CONFIG_KVM_MMU_AUDIT
532 int audit_point;
533 #endif
d69fb81f
ZX
534};
535
0711456c
ZX
536struct kvm_vm_stat {
537 u32 mmu_shadow_zapped;
538 u32 mmu_pte_write;
539 u32 mmu_pte_updated;
540 u32 mmu_pde_zapped;
541 u32 mmu_flooded;
542 u32 mmu_recycled;
dfc5aa00 543 u32 mmu_cache_miss;
4731d4c7 544 u32 mmu_unsync;
0711456c 545 u32 remote_tlb_flush;
05da4558 546 u32 lpages;
0711456c
ZX
547};
548
77b4c255
ZX
549struct kvm_vcpu_stat {
550 u32 pf_fixed;
551 u32 pf_guest;
552 u32 tlb_flush;
553 u32 invlpg;
554
555 u32 exits;
556 u32 io_exits;
557 u32 mmio_exits;
558 u32 signal_exits;
559 u32 irq_window_exits;
f08864b4 560 u32 nmi_window_exits;
77b4c255
ZX
561 u32 halt_exits;
562 u32 halt_wakeup;
563 u32 request_irq_exits;
564 u32 irq_exits;
565 u32 host_state_reload;
566 u32 efer_reload;
567 u32 fpu_reload;
568 u32 insn_emulation;
569 u32 insn_emulation_fail;
f11c3a8d 570 u32 hypercalls;
fa89a817 571 u32 irq_injections;
c4abb7c9 572 u32 nmi_injections;
77b4c255 573};
ad312c7c 574
8a76d7f2
JR
575struct x86_instruction_info;
576
ea4a5ff8
ZX
577struct kvm_x86_ops {
578 int (*cpu_has_kvm_support)(void); /* __init */
579 int (*disabled_by_bios)(void); /* __init */
10474ae8 580 int (*hardware_enable)(void *dummy);
ea4a5ff8
ZX
581 void (*hardware_disable)(void *dummy);
582 void (*check_processor_compatibility)(void *rtn);
583 int (*hardware_setup)(void); /* __init */
584 void (*hardware_unsetup)(void); /* __exit */
774ead3a 585 bool (*cpu_has_accelerated_tpr)(void);
0e851880 586 void (*cpuid_update)(struct kvm_vcpu *vcpu);
ea4a5ff8
ZX
587
588 /* Create, but do not attach this VCPU */
589 struct kvm_vcpu *(*vcpu_create)(struct kvm *kvm, unsigned id);
590 void (*vcpu_free)(struct kvm_vcpu *vcpu);
591 int (*vcpu_reset)(struct kvm_vcpu *vcpu);
592
593 void (*prepare_guest_switch)(struct kvm_vcpu *vcpu);
594 void (*vcpu_load)(struct kvm_vcpu *vcpu, int cpu);
595 void (*vcpu_put)(struct kvm_vcpu *vcpu);
ea4a5ff8 596
355be0b9
JK
597 void (*set_guest_debug)(struct kvm_vcpu *vcpu,
598 struct kvm_guest_debug *dbg);
ea4a5ff8
ZX
599 int (*get_msr)(struct kvm_vcpu *vcpu, u32 msr_index, u64 *pdata);
600 int (*set_msr)(struct kvm_vcpu *vcpu, u32 msr_index, u64 data);
601 u64 (*get_segment_base)(struct kvm_vcpu *vcpu, int seg);
602 void (*get_segment)(struct kvm_vcpu *vcpu,
603 struct kvm_segment *var, int seg);
2e4d2653 604 int (*get_cpl)(struct kvm_vcpu *vcpu);
ea4a5ff8
ZX
605 void (*set_segment)(struct kvm_vcpu *vcpu,
606 struct kvm_segment *var, int seg);
607 void (*get_cs_db_l_bits)(struct kvm_vcpu *vcpu, int *db, int *l);
e8467fda 608 void (*decache_cr0_guest_bits)(struct kvm_vcpu *vcpu);
aff48baa 609 void (*decache_cr3)(struct kvm_vcpu *vcpu);
ea4a5ff8
ZX
610 void (*decache_cr4_guest_bits)(struct kvm_vcpu *vcpu);
611 void (*set_cr0)(struct kvm_vcpu *vcpu, unsigned long cr0);
612 void (*set_cr3)(struct kvm_vcpu *vcpu, unsigned long cr3);
5e1746d6 613 int (*set_cr4)(struct kvm_vcpu *vcpu, unsigned long cr4);
ea4a5ff8 614 void (*set_efer)(struct kvm_vcpu *vcpu, u64 efer);
89a27f4d
GN
615 void (*get_idt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
616 void (*set_idt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
617 void (*get_gdt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
618 void (*set_gdt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
020df079 619 void (*set_dr7)(struct kvm_vcpu *vcpu, unsigned long value);
5fdbf976 620 void (*cache_reg)(struct kvm_vcpu *vcpu, enum kvm_reg reg);
ea4a5ff8
ZX
621 unsigned long (*get_rflags)(struct kvm_vcpu *vcpu);
622 void (*set_rflags)(struct kvm_vcpu *vcpu, unsigned long rflags);
6b52d186 623 void (*fpu_activate)(struct kvm_vcpu *vcpu);
02daab21 624 void (*fpu_deactivate)(struct kvm_vcpu *vcpu);
ea4a5ff8
ZX
625
626 void (*tlb_flush)(struct kvm_vcpu *vcpu);
ea4a5ff8 627
851ba692
AK
628 void (*run)(struct kvm_vcpu *vcpu);
629 int (*handle_exit)(struct kvm_vcpu *vcpu);
ea4a5ff8 630 void (*skip_emulated_instruction)(struct kvm_vcpu *vcpu);
2809f5d2
GC
631 void (*set_interrupt_shadow)(struct kvm_vcpu *vcpu, int mask);
632 u32 (*get_interrupt_shadow)(struct kvm_vcpu *vcpu, int mask);
ea4a5ff8
ZX
633 void (*patch_hypercall)(struct kvm_vcpu *vcpu,
634 unsigned char *hypercall_addr);
66fd3f7f 635 void (*set_irq)(struct kvm_vcpu *vcpu);
95ba8273 636 void (*set_nmi)(struct kvm_vcpu *vcpu);
298101da 637 void (*queue_exception)(struct kvm_vcpu *vcpu, unsigned nr,
ce7ddec4
JR
638 bool has_error_code, u32 error_code,
639 bool reinject);
b463a6f7 640 void (*cancel_injection)(struct kvm_vcpu *vcpu);
78646121 641 int (*interrupt_allowed)(struct kvm_vcpu *vcpu);
95ba8273 642 int (*nmi_allowed)(struct kvm_vcpu *vcpu);
3cfc3092
JK
643 bool (*get_nmi_mask)(struct kvm_vcpu *vcpu);
644 void (*set_nmi_mask)(struct kvm_vcpu *vcpu, bool masked);
95ba8273
GN
645 void (*enable_nmi_window)(struct kvm_vcpu *vcpu);
646 void (*enable_irq_window)(struct kvm_vcpu *vcpu);
647 void (*update_cr8_intercept)(struct kvm_vcpu *vcpu, int tpr, int irr);
ea4a5ff8 648 int (*set_tss_addr)(struct kvm *kvm, unsigned int addr);
67253af5 649 int (*get_tdp_level)(void);
4b12f0de 650 u64 (*get_mt_mask)(struct kvm_vcpu *vcpu, gfn_t gfn, bool is_mmio);
17cc3935 651 int (*get_lpage_level)(void);
4e47c7a6 652 bool (*rdtscp_supported)(void);
e48672fa 653 void (*adjust_tsc_offset)(struct kvm_vcpu *vcpu, s64 adjustment);
344f414f 654
1c97f0a0
JR
655 void (*set_tdp_cr3)(struct kvm_vcpu *vcpu, unsigned long cr3);
656
d4330ef2
JR
657 void (*set_supported_cpuid)(u32 func, struct kvm_cpuid_entry2 *entry);
658
f5f48ee1
SY
659 bool (*has_wbinvd_exit)(void);
660
4051b188 661 void (*set_tsc_khz)(struct kvm_vcpu *vcpu, u32 user_tsc_khz);
99e3e30a
ZA
662 void (*write_tsc_offset)(struct kvm_vcpu *vcpu, u64 offset);
663
857e4099 664 u64 (*compute_tsc_offset)(struct kvm_vcpu *vcpu, u64 target_tsc);
d5c1785d 665 u64 (*read_l1_tsc)(struct kvm_vcpu *vcpu);
857e4099 666
586f9607 667 void (*get_exit_info)(struct kvm_vcpu *vcpu, u64 *info1, u64 *info2);
8a76d7f2
JR
668
669 int (*check_intercept)(struct kvm_vcpu *vcpu,
670 struct x86_instruction_info *info,
671 enum x86_intercept_stage stage);
ea4a5ff8
ZX
672};
673
af585b92 674struct kvm_arch_async_pf {
7c90705b 675 u32 token;
af585b92 676 gfn_t gfn;
fb67e14f 677 unsigned long cr3;
c4806acd 678 bool direct_map;
af585b92
GN
679};
680
97896d04
ZX
681extern struct kvm_x86_ops *kvm_x86_ops;
682
54f1585a
ZX
683int kvm_mmu_module_init(void);
684void kvm_mmu_module_exit(void);
685
686void kvm_mmu_destroy(struct kvm_vcpu *vcpu);
687int kvm_mmu_create(struct kvm_vcpu *vcpu);
688int kvm_mmu_setup(struct kvm_vcpu *vcpu);
7b52345e 689void kvm_mmu_set_mask_ptes(u64 user_mask, u64 accessed_mask,
4b12f0de 690 u64 dirty_mask, u64 nx_mask, u64 x_mask);
54f1585a
ZX
691
692int kvm_mmu_reset_context(struct kvm_vcpu *vcpu);
693void kvm_mmu_slot_remove_write_access(struct kvm *kvm, int slot);
95d4c16c
TY
694int kvm_mmu_rmap_write_protect(struct kvm *kvm, u64 gfn,
695 struct kvm_memory_slot *slot);
54f1585a 696void kvm_mmu_zap_all(struct kvm *kvm);
3ad82a7e 697unsigned int kvm_mmu_calculate_mmu_pages(struct kvm *kvm);
54f1585a
ZX
698void kvm_mmu_change_mmu_pages(struct kvm *kvm, unsigned int kvm_nr_mmu_pages);
699
ff03a073 700int load_pdptrs(struct kvm_vcpu *vcpu, struct kvm_mmu *mmu, unsigned long cr3);
cc4b6871 701
3200f405 702int emulator_write_phys(struct kvm_vcpu *vcpu, gpa_t gpa,
9f811285 703 const void *val, int bytes);
4b12f0de 704u8 kvm_get_guest_memory_type(struct kvm_vcpu *vcpu, gfn_t gfn);
2f333bcb
MT
705
706extern bool tdp_enabled;
9f811285 707
a3e06bbe
LJ
708u64 vcpu_tsc_khz(struct kvm_vcpu *vcpu);
709
92a1f12d
JR
710/* control of guest tsc rate supported? */
711extern bool kvm_has_tsc_control;
712/* minimum supported tsc_khz for guests */
713extern u32 kvm_min_guest_tsc_khz;
714/* maximum supported tsc_khz for guests */
715extern u32 kvm_max_guest_tsc_khz;
716
54f1585a
ZX
717enum emulation_result {
718 EMULATE_DONE, /* no further processing */
719 EMULATE_DO_MMIO, /* kvm_run filled with mmio request */
720 EMULATE_FAIL, /* can't emulate this instruction */
721};
722
571008da
SY
723#define EMULTYPE_NO_DECODE (1 << 0)
724#define EMULTYPE_TRAP_UD (1 << 1)
ba8afb6b 725#define EMULTYPE_SKIP (1 << 2)
1cb3f3ae 726#define EMULTYPE_RETRY (1 << 3)
dc25e89e
AP
727int x86_emulate_instruction(struct kvm_vcpu *vcpu, unsigned long cr2,
728 int emulation_type, void *insn, int insn_len);
51d8b661
AP
729
730static inline int emulate_instruction(struct kvm_vcpu *vcpu,
731 int emulation_type)
732{
dc25e89e 733 return x86_emulate_instruction(vcpu, 0, emulation_type, NULL, 0);
51d8b661
AP
734}
735
f2b4b7dd 736void kvm_enable_efer_bits(u64);
54f1585a
ZX
737int kvm_get_msr(struct kvm_vcpu *vcpu, u32 msr_index, u64 *data);
738int kvm_set_msr(struct kvm_vcpu *vcpu, u32 msr_index, u64 data);
739
740struct x86_emulate_ctxt;
741
cf8f70bf 742int kvm_fast_pio_out(struct kvm_vcpu *vcpu, int size, unsigned short port);
54f1585a
ZX
743void kvm_emulate_cpuid(struct kvm_vcpu *vcpu);
744int kvm_emulate_halt(struct kvm_vcpu *vcpu);
f5f48ee1 745int kvm_emulate_wbinvd(struct kvm_vcpu *vcpu);
54f1585a 746
3e6e0aab 747void kvm_get_segment(struct kvm_vcpu *vcpu, struct kvm_segment *var, int seg);
c697518a 748int kvm_load_segment_descriptor(struct kvm_vcpu *vcpu, u16 selector, int seg);
3e6e0aab 749
e269fb21
JK
750int kvm_task_switch(struct kvm_vcpu *vcpu, u16 tss_selector, int reason,
751 bool has_error_code, u32 error_code);
37817f29 752
49a9b07e 753int kvm_set_cr0(struct kvm_vcpu *vcpu, unsigned long cr0);
2390218b 754int kvm_set_cr3(struct kvm_vcpu *vcpu, unsigned long cr3);
a83b29c6 755int kvm_set_cr4(struct kvm_vcpu *vcpu, unsigned long cr4);
eea1cff9 756int kvm_set_cr8(struct kvm_vcpu *vcpu, unsigned long cr8);
020df079
GN
757int kvm_set_dr(struct kvm_vcpu *vcpu, int dr, unsigned long val);
758int kvm_get_dr(struct kvm_vcpu *vcpu, int dr, unsigned long *val);
2d3ad1f4
AK
759unsigned long kvm_get_cr8(struct kvm_vcpu *vcpu);
760void kvm_lmsw(struct kvm_vcpu *vcpu, unsigned long msw);
54f1585a 761void kvm_get_cs_db_l_bits(struct kvm_vcpu *vcpu, int *db, int *l);
2acf923e 762int kvm_set_xcr(struct kvm_vcpu *vcpu, u32 index, u64 xcr);
54f1585a
ZX
763
764int kvm_get_msr_common(struct kvm_vcpu *vcpu, u32 msr, u64 *pdata);
765int kvm_set_msr_common(struct kvm_vcpu *vcpu, u32 msr, u64 data);
766
91586a3b
JK
767unsigned long kvm_get_rflags(struct kvm_vcpu *vcpu);
768void kvm_set_rflags(struct kvm_vcpu *vcpu, unsigned long rflags);
022cd0e8 769bool kvm_rdpmc(struct kvm_vcpu *vcpu);
91586a3b 770
298101da
AK
771void kvm_queue_exception(struct kvm_vcpu *vcpu, unsigned nr);
772void kvm_queue_exception_e(struct kvm_vcpu *vcpu, unsigned nr, u32 error_code);
ce7ddec4
JR
773void kvm_requeue_exception(struct kvm_vcpu *vcpu, unsigned nr);
774void kvm_requeue_exception_e(struct kvm_vcpu *vcpu, unsigned nr, u32 error_code);
6389ee94 775void kvm_inject_page_fault(struct kvm_vcpu *vcpu, struct x86_exception *fault);
ec92fe44
JR
776int kvm_read_guest_page_mmu(struct kvm_vcpu *vcpu, struct kvm_mmu *mmu,
777 gfn_t gfn, void *data, int offset, int len,
778 u32 access);
6389ee94 779void kvm_propagate_fault(struct kvm_vcpu *vcpu, struct x86_exception *fault);
0a79b009 780bool kvm_require_cpl(struct kvm_vcpu *vcpu, int required_cpl);
298101da 781
4925663a 782int kvm_pic_set_irq(void *opaque, int irq, int level);
3de42dc0 783
3419ffc8
SY
784void kvm_inject_nmi(struct kvm_vcpu *vcpu);
785
10ab25cd 786int fx_init(struct kvm_vcpu *vcpu);
54f1585a 787
d835dfec 788void kvm_mmu_flush_tlb(struct kvm_vcpu *vcpu);
54f1585a 789void kvm_mmu_pte_write(struct kvm_vcpu *vcpu, gpa_t gpa,
f57f2ef5 790 const u8 *new, int bytes);
1cb3f3ae 791int kvm_mmu_unprotect_page(struct kvm *kvm, gfn_t gfn);
54f1585a
ZX
792int kvm_mmu_unprotect_page_virt(struct kvm_vcpu *vcpu, gva_t gva);
793void __kvm_mmu_free_some_pages(struct kvm_vcpu *vcpu);
794int kvm_mmu_load(struct kvm_vcpu *vcpu);
795void kvm_mmu_unload(struct kvm_vcpu *vcpu);
0ba73cda 796void kvm_mmu_sync_roots(struct kvm_vcpu *vcpu);
e459e322 797gpa_t translate_nested_gpa(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access);
ab9ae313
AK
798gpa_t kvm_mmu_gva_to_gpa_read(struct kvm_vcpu *vcpu, gva_t gva,
799 struct x86_exception *exception);
800gpa_t kvm_mmu_gva_to_gpa_fetch(struct kvm_vcpu *vcpu, gva_t gva,
801 struct x86_exception *exception);
802gpa_t kvm_mmu_gva_to_gpa_write(struct kvm_vcpu *vcpu, gva_t gva,
803 struct x86_exception *exception);
804gpa_t kvm_mmu_gva_to_gpa_system(struct kvm_vcpu *vcpu, gva_t gva,
805 struct x86_exception *exception);
54f1585a
ZX
806
807int kvm_emulate_hypercall(struct kvm_vcpu *vcpu);
808
dc25e89e
AP
809int kvm_mmu_page_fault(struct kvm_vcpu *vcpu, gva_t gva, u32 error_code,
810 void *insn, int insn_len);
a7052897 811void kvm_mmu_invlpg(struct kvm_vcpu *vcpu, gva_t gva);
34c16eec 812
18552672 813void kvm_enable_tdp(void);
5f4cb662 814void kvm_disable_tdp(void);
18552672 815
de7d789a 816int complete_pio(struct kvm_vcpu *vcpu);
f850e2e6 817bool kvm_check_iopl(struct kvm_vcpu *vcpu);
ec6d273d 818
e459e322
XG
819static inline gpa_t translate_gpa(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access)
820{
821 return gpa;
822}
823
ec6d273d
ZX
824static inline struct kvm_mmu_page *page_header(hpa_t shadow_page)
825{
826 struct page *page = pfn_to_page(shadow_page >> PAGE_SHIFT);
827
828 return (struct kvm_mmu_page *)page_private(page);
829}
830
d6e88aec 831static inline u16 kvm_read_ldt(void)
ec6d273d
ZX
832{
833 u16 ldt;
834 asm("sldt %0" : "=g"(ldt));
835 return ldt;
836}
837
d6e88aec 838static inline void kvm_load_ldt(u16 sel)
ec6d273d
ZX
839{
840 asm("lldt %0" : : "rm"(sel));
841}
ec6d273d 842
ec6d273d
ZX
843#ifdef CONFIG_X86_64
844static inline unsigned long read_msr(unsigned long msr)
845{
846 u64 value;
847
848 rdmsrl(msr, value);
849 return value;
850}
851#endif
852
ec6d273d
ZX
853static inline u32 get_rdx_init_val(void)
854{
855 return 0x600; /* P6 family */
856}
857
c1a5d4f9
AK
858static inline void kvm_inject_gp(struct kvm_vcpu *vcpu, u32 error_code)
859{
860 kvm_queue_exception_e(vcpu, GP_VECTOR, error_code);
861}
862
ec6d273d
ZX
863#define TSS_IOPB_BASE_OFFSET 0x66
864#define TSS_BASE_SIZE 0x68
865#define TSS_IOPB_SIZE (65536 / 8)
866#define TSS_REDIRECTION_SIZE (256 / 8)
7d76b4d3
JP
867#define RMODE_TSS_SIZE \
868 (TSS_BASE_SIZE + TSS_REDIRECTION_SIZE + TSS_IOPB_SIZE + 1)
53e0aa7b 869
37817f29
IE
870enum {
871 TASK_SWITCH_CALL = 0,
872 TASK_SWITCH_IRET = 1,
873 TASK_SWITCH_JMP = 2,
874 TASK_SWITCH_GATE = 3,
875};
876
1371d904 877#define HF_GIF_MASK (1 << 0)
3d6368ef
AG
878#define HF_HIF_MASK (1 << 1)
879#define HF_VINTR_MASK (1 << 2)
95ba8273 880#define HF_NMI_MASK (1 << 3)
44c11430 881#define HF_IRET_MASK (1 << 4)
ec9e60b2 882#define HF_GUEST_MASK (1 << 5) /* VCPU is in guest-mode */
1371d904 883
4ecac3fd
AK
884/*
885 * Hardware virtualization extension instructions may fault if a
886 * reboot turns off virtualization while processes are running.
887 * Trap the fault and ignore the instruction if that happens.
888 */
b7c4145b
AK
889asmlinkage void kvm_spurious_fault(void);
890extern bool kvm_rebooting;
4ecac3fd 891
5e520e62 892#define ____kvm_handle_fault_on_reboot(insn, cleanup_insn) \
4ecac3fd 893 "666: " insn "\n\t" \
b7c4145b 894 "668: \n\t" \
18b13e54 895 ".pushsection .fixup, \"ax\" \n" \
4ecac3fd 896 "667: \n\t" \
5e520e62 897 cleanup_insn "\n\t" \
b7c4145b
AK
898 "cmpb $0, kvm_rebooting \n\t" \
899 "jne 668b \n\t" \
8ceed347 900 __ASM_SIZE(push) " $666b \n\t" \
b7c4145b 901 "call kvm_spurious_fault \n\t" \
4ecac3fd
AK
902 ".popsection \n\t" \
903 ".pushsection __ex_table, \"a\" \n\t" \
8ceed347 904 _ASM_PTR " 666b, 667b \n\t" \
4ecac3fd
AK
905 ".popsection"
906
5e520e62
AK
907#define __kvm_handle_fault_on_reboot(insn) \
908 ____kvm_handle_fault_on_reboot(insn, "")
909
e930bffe
AA
910#define KVM_ARCH_WANT_MMU_NOTIFIER
911int kvm_unmap_hva(struct kvm *kvm, unsigned long hva);
912int kvm_age_hva(struct kvm *kvm, unsigned long hva);
8ee53820 913int kvm_test_age_hva(struct kvm *kvm, unsigned long hva);
3da0dd43 914void kvm_set_spte_hva(struct kvm *kvm, unsigned long hva, pte_t pte);
82725b20 915int cpuid_maxphyaddr(struct kvm_vcpu *vcpu);
a1b37100
GN
916int kvm_cpu_has_interrupt(struct kvm_vcpu *vcpu);
917int kvm_arch_interrupt_allowed(struct kvm_vcpu *vcpu);
0b71785d 918int kvm_cpu_get_interrupt(struct kvm_vcpu *v);
e930bffe 919
18863bdd 920void kvm_define_shared_msr(unsigned index, u32 msr);
d5696725 921void kvm_set_shared_msr(unsigned index, u64 val, u64 mask);
18863bdd 922
f92653ee
JK
923bool kvm_is_linear_rip(struct kvm_vcpu *vcpu, unsigned long linear_rip);
924
af585b92
GN
925void kvm_arch_async_page_not_present(struct kvm_vcpu *vcpu,
926 struct kvm_async_pf *work);
927void kvm_arch_async_page_present(struct kvm_vcpu *vcpu,
928 struct kvm_async_pf *work);
56028d08
GN
929void kvm_arch_async_page_ready(struct kvm_vcpu *vcpu,
930 struct kvm_async_pf *work);
7c90705b 931bool kvm_arch_can_inject_async_page_present(struct kvm_vcpu *vcpu);
af585b92
GN
932extern bool kvm_find_async_pf_gfn(struct kvm_vcpu *vcpu, gfn_t gfn);
933
db8fcefa
AP
934void kvm_complete_insn_gp(struct kvm_vcpu *vcpu, int err);
935
f5132b01
GN
936int kvm_is_in_guest(void);
937
938void kvm_pmu_init(struct kvm_vcpu *vcpu);
939void kvm_pmu_destroy(struct kvm_vcpu *vcpu);
940void kvm_pmu_reset(struct kvm_vcpu *vcpu);
941void kvm_pmu_cpuid_update(struct kvm_vcpu *vcpu);
942bool kvm_pmu_msr(struct kvm_vcpu *vcpu, u32 msr);
943int kvm_pmu_get_msr(struct kvm_vcpu *vcpu, u32 msr, u64 *data);
944int kvm_pmu_set_msr(struct kvm_vcpu *vcpu, u32 msr, u64 data);
945int kvm_pmu_read_pmc(struct kvm_vcpu *vcpu, unsigned pmc, u64 *data);
946void kvm_handle_pmu_event(struct kvm_vcpu *vcpu);
947void kvm_deliver_pmi(struct kvm_vcpu *vcpu);
948
1965aae3 949#endif /* _ASM_X86_KVM_HOST_H */