kvm_host.h 29.4 KB
Newer Older
1
/*
2 3 4 5 6 7 8 9 10
 * Kernel-based Virtual Machine driver for Linux
 *
 * This header defines architecture specific interfaces, x86 version
 *
 * This work is licensed under the terms of the GNU GPL, version 2.  See
 * the COPYING file in the top-level directory.
 *
 */

H
H. Peter Anvin 已提交
11 12
#ifndef _ASM_X86_KVM_HOST_H
#define _ASM_X86_KVM_HOST_H
13

14 15
#include <linux/types.h>
#include <linux/mm.h>
16
#include <linux/mmu_notifier.h>
17
#include <linux/tracepoint.h>
18
#include <linux/cpumask.h>
19
#include <linux/irq_work.h>
20 21 22

#include <linux/kvm.h>
#include <linux/kvm_para.h>
23
#include <linux/kvm_types.h>
24
#include <linux/perf_event.h>
25 26
#include <linux/pvclock_gtod.h>
#include <linux/clocksource.h>
27

28
#include <asm/pvclock-abi.h>
29
#include <asm/desc.h>
S
Sheng Yang 已提交
30
#include <asm/mtrr.h>
31
#include <asm/msr-index.h>
32
#include <asm/asm.h>
33

34
#define KVM_MAX_VCPUS 255
35
#define KVM_SOFT_MAX_VCPUS 160
36
#define KVM_USER_MEM_SLOTS 125
37 38
/* memory slots that are not exposed to userspace */
#define KVM_PRIVATE_MEM_SLOTS 3
39
#define KVM_MEM_SLOTS_NUM (KVM_USER_MEM_SLOTS + KVM_PRIVATE_MEM_SLOTS)
40

A
Avi Kivity 已提交
41
#define KVM_MMIO_SIZE 16
42 43

#define KVM_PIO_PAGE_OFFSET 1
44
#define KVM_COALESCED_MMIO_PAGE_OFFSET 2
45

46 47
#define KVM_IRQCHIP_NUM_PINS  KVM_IOAPIC_NUM_PINS

48 49 50 51 52
#define CR0_RESERVED_BITS                                               \
	(~(unsigned long)(X86_CR0_PE | X86_CR0_MP | X86_CR0_EM | X86_CR0_TS \
			  | X86_CR0_ET | X86_CR0_NE | X86_CR0_WP | X86_CR0_AM \
			  | X86_CR0_NW | X86_CR0_CD | X86_CR0_PG))

53 54
#define CR3_PAE_RESERVED_BITS ((X86_CR3_PWT | X86_CR3_PCD) - 1)
#define CR3_NONPAE_RESERVED_BITS ((PAGE_SIZE-1) & ~(X86_CR3_PWT | X86_CR3_PCD))
55
#define CR3_PCID_ENABLED_RESERVED_BITS 0xFFFFFF0000000000ULL
56 57
#define CR3_L_MODE_RESERVED_BITS (CR3_NONPAE_RESERVED_BITS |	\
				  0xFFFFFF0000000000ULL)
58 59 60
#define CR4_RESERVED_BITS                                               \
	(~(unsigned long)(X86_CR4_VME | X86_CR4_PVI | X86_CR4_TSD | X86_CR4_DE\
			  | X86_CR4_PSE | X86_CR4_PAE | X86_CR4_MCE     \
61
			  | X86_CR4_PGE | X86_CR4_PCE | X86_CR4_OSFXSR | X86_CR4_PCIDE \
62
			  | X86_CR4_OSXSAVE | X86_CR4_SMEP | X86_CR4_RDWRGSFS \
63 64 65 66 67
			  | X86_CR4_OSXMMEXCPT | X86_CR4_VMXE))

#define CR8_RESERVED_BITS (~(unsigned long)X86_CR8_TPR)


68 69

#define INVALID_PAGE (~(hpa_t)0)
70 71
#define VALID_PAGE(x) ((x) != INVALID_PAGE)

72 73
#define UNMAPPED_GVA (~(gpa_t)0)

74
/* KVM Hugepage definitions for x86 */
75
#define KVM_NR_PAGE_SIZES	3
76 77
#define KVM_HPAGE_GFN_SHIFT(x)	(((x) - 1) * 9)
#define KVM_HPAGE_SHIFT(x)	(PAGE_SHIFT + KVM_HPAGE_GFN_SHIFT(x))
78 79 80
#define KVM_HPAGE_SIZE(x)	(1UL << KVM_HPAGE_SHIFT(x))
#define KVM_HPAGE_MASK(x)	(~(KVM_HPAGE_SIZE(x) - 1))
#define KVM_PAGES_PER_HPAGE(x)	(KVM_HPAGE_SIZE(x) / PAGE_SIZE)
M
Marcelo Tosatti 已提交
81

82 83 84 85 86
#define SELECTOR_TI_MASK (1 << 2)
#define SELECTOR_RPL_MASK 0x03

#define IOPL_SHIFT 12

87 88
#define KVM_PERMILLE_MMU_PAGES 20
#define KVM_MIN_ALLOC_MMU_PAGES 64
89 90
#define KVM_MMU_HASH_SHIFT 10
#define KVM_NUM_MMU_PAGES (1 << KVM_MMU_HASH_SHIFT)
91 92
#define KVM_MIN_FREE_MMU_PAGES 5
#define KVM_REFILL_PAGES 25
93
#define KVM_MAX_CPUID_ENTRIES 80
S
Sheng Yang 已提交
94
#define KVM_NR_FIXED_MTRR_REGION 88
A
Avi Kivity 已提交
95
#define KVM_NR_VAR_MTRR 8
96

97 98
#define ASYNC_PF_PER_VCPU 64

99 100
struct kvm_vcpu;
struct kvm;
101
struct kvm_async_pf;
102

103
enum kvm_reg {
104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
	VCPU_REGS_RAX = 0,
	VCPU_REGS_RCX = 1,
	VCPU_REGS_RDX = 2,
	VCPU_REGS_RBX = 3,
	VCPU_REGS_RSP = 4,
	VCPU_REGS_RBP = 5,
	VCPU_REGS_RSI = 6,
	VCPU_REGS_RDI = 7,
#ifdef CONFIG_X86_64
	VCPU_REGS_R8 = 8,
	VCPU_REGS_R9 = 9,
	VCPU_REGS_R10 = 10,
	VCPU_REGS_R11 = 11,
	VCPU_REGS_R12 = 12,
	VCPU_REGS_R13 = 13,
	VCPU_REGS_R14 = 14,
	VCPU_REGS_R15 = 15,
#endif
122
	VCPU_REGS_RIP,
123 124 125
	NR_VCPU_REGS
};

A
Avi Kivity 已提交
126 127
enum kvm_reg_ex {
	VCPU_EXREG_PDPTR = NR_VCPU_REGS,
128
	VCPU_EXREG_CR3,
A
Avi Kivity 已提交
129
	VCPU_EXREG_RFLAGS,
A
Avi Kivity 已提交
130
	VCPU_EXREG_CPL,
A
Avi Kivity 已提交
131
	VCPU_EXREG_SEGMENTS,
A
Avi Kivity 已提交
132 133
};

134
enum {
135
	VCPU_SREG_ES,
136
	VCPU_SREG_CS,
137
	VCPU_SREG_SS,
138 139 140 141 142 143 144
	VCPU_SREG_DS,
	VCPU_SREG_FS,
	VCPU_SREG_GS,
	VCPU_SREG_TR,
	VCPU_SREG_LDTR,
};

145
#include <asm/kvm_emulate.h>
146

147 148
#define KVM_NR_MEM_OBJS 40

149 150 151 152 153 154 155 156 157 158 159 160 161
#define KVM_NR_DB_REGS	4

#define DR6_BD		(1 << 13)
#define DR6_BS		(1 << 14)
#define DR6_FIXED_1	0xffff0ff0
#define DR6_VOLATILE	0x0000e00f

#define DR7_BP_EN_MASK	0x000000ff
#define DR7_GE		(1 << 9)
#define DR7_GD		(1 << 13)
#define DR7_FIXED_1	0x00000400
#define DR7_VOLATILE	0xffff23ff

162 163
/* apic attention bits */
#define KVM_APIC_CHECK_VAPIC	0
164 165 166 167 168 169 170
/*
 * The following bit is set with PV-EOI, unset on EOI.
 * We detect PV-EOI changes by guest by comparing
 * this bit with PV-EOI in guest memory.
 * See the implementation in apic_update_pv_eoi.
 */
#define KVM_APIC_PV_EOI_PENDING	1
171

172 173 174 175 176 177 178 179 180 181 182 183 184 185 186
/*
 * We don't want allocation failures within the mmu code, so we preallocate
 * enough memory for a single page fault in a cache.
 */
struct kvm_mmu_memory_cache {
	int nobjs;
	void *objects[KVM_NR_MEM_OBJS];
};

/*
 * kvm_mmu_page_role, below, is defined as:
 *
 *   bits 0:3 - total guest paging levels (2-4, or zero for real mode)
 *   bits 4:7 - page table level for this shadow (1-4)
 *   bits 8:9 - page table quadrant for 2-level guests
187 188
 *   bit   16 - direct mapping of virtual to physical mapping at gfn
 *              used for real mode and two-dimensional paging
189 190 191 192 193
 *   bits 17:19 - common access permissions for all ptes in this shadow page
 */
union kvm_mmu_page_role {
	unsigned word;
	struct {
194
		unsigned level:4;
195
		unsigned cr4_pae:1;
196 197
		unsigned quadrant:2;
		unsigned pad_for_nice_hex_output:6;
198
		unsigned direct:1;
199
		unsigned access:3;
200
		unsigned invalid:1;
201
		unsigned nxe:1;
202
		unsigned cr0_wp:1;
203
		unsigned smep_andnot_wp:1;
204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220
	};
};

struct kvm_mmu_page {
	struct list_head link;
	struct hlist_node hash_link;

	/*
	 * The following two entries are used to key the shadow page in the
	 * hash table.
	 */
	gfn_t gfn;
	union kvm_mmu_page_role role;

	u64 *spt;
	/* hold the gfn of each spte inside spt */
	gfn_t *gfns;
221
	bool unsync;
222
	int root_count;          /* Currently serving as active root */
223
	unsigned int unsync_children;
224
	unsigned long parent_ptes;	/* Reverse mapping for parent_pte */
225
	DECLARE_BITMAP(unsync_child_bitmap, 512);
226 227 228 229 230

#ifdef CONFIG_X86_32
	int clear_spte_count;
#endif

231
	int write_flooding_count;
232
	bool mmio_cached;
233 234
};

235 236 237 238 239 240 241
struct kvm_pio_request {
	unsigned long count;
	int in;
	int port;
	int size;
};

242 243 244 245 246 247 248
/*
 * x86 supports 3 paging modes (4-level 64-bit, 3-level 64-bit, and 2-level
 * 32-bit).  The kvm_mmu structure abstracts the details of the current mmu
 * mode.
 */
struct kvm_mmu {
	void (*new_cr3)(struct kvm_vcpu *vcpu);
249
	void (*set_cr3)(struct kvm_vcpu *vcpu, unsigned long root);
250
	unsigned long (*get_cr3)(struct kvm_vcpu *vcpu);
251
	u64 (*get_pdptr)(struct kvm_vcpu *vcpu, int index);
252 253
	int (*page_fault)(struct kvm_vcpu *vcpu, gva_t gva, u32 err,
			  bool prefault);
254 255
	void (*inject_page_fault)(struct kvm_vcpu *vcpu,
				  struct x86_exception *fault);
256
	void (*free)(struct kvm_vcpu *vcpu);
257
	gpa_t (*gva_to_gpa)(struct kvm_vcpu *vcpu, gva_t gva, u32 access,
258
			    struct x86_exception *exception);
259
	gpa_t (*translate_gpa)(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access);
260
	int (*sync_page)(struct kvm_vcpu *vcpu,
261
			 struct kvm_mmu_page *sp);
M
Marcelo Tosatti 已提交
262
	void (*invlpg)(struct kvm_vcpu *vcpu, gva_t gva);
263
	void (*update_pte)(struct kvm_vcpu *vcpu, struct kvm_mmu_page *sp,
264
			   u64 *spte, const void *pte);
265 266 267
	hpa_t root_hpa;
	int root_level;
	int shadow_root_level;
268
	union kvm_mmu_page_role base_role;
269
	bool direct_map;
270

271 272 273 274 275 276 277
	/*
	 * Bitmap; bit set = permission fault
	 * Byte index: page fault error code [4:1]
	 * Bit index: pte permissions in ACC_* format
	 */
	u8 permissions[16];

278
	u64 *pae_root;
279
	u64 *lm_root;
280
	u64 rsvd_bits_mask[2][4];
281

A
Avi Kivity 已提交
282 283 284 285 286 287 288
	/*
	 * Bitmap: bit set = last pte in walk
	 * index[0:1]: level (zero-based)
	 * index[2]: pte.ps
	 */
	u8 last_pte_bitmap;

289 290
	bool nx;

291
	u64 pdptrs[4]; /* pae */
292 293
};

294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318
enum pmc_type {
	KVM_PMC_GP = 0,
	KVM_PMC_FIXED,
};

struct kvm_pmc {
	enum pmc_type type;
	u8 idx;
	u64 counter;
	u64 eventsel;
	struct perf_event *perf_event;
	struct kvm_vcpu *vcpu;
};

struct kvm_pmu {
	unsigned nr_arch_gp_counters;
	unsigned nr_arch_fixed_counters;
	unsigned available_event_types;
	u64 fixed_ctr_ctrl;
	u64 global_ctrl;
	u64 global_status;
	u64 global_ovf_ctrl;
	u64 counter_bitmask[2];
	u64 global_ctrl_mask;
	u8 version;
319 320
	struct kvm_pmc gp_counters[INTEL_PMC_MAX_GENERIC];
	struct kvm_pmc fixed_counters[INTEL_PMC_MAX_FIXED];
321 322 323 324
	struct irq_work irq_work;
	u64 reprogram_pmi;
};

325
struct kvm_vcpu_arch {
326 327 328 329 330 331 332
	/*
	 * rip and regs accesses must go through
	 * kvm_{register,rip}_{read,write} functions.
	 */
	unsigned long regs[NR_VCPU_REGS];
	u32 regs_avail;
	u32 regs_dirty;
333 334

	unsigned long cr0;
335
	unsigned long cr0_guest_owned_bits;
336 337 338
	unsigned long cr2;
	unsigned long cr3;
	unsigned long cr4;
339
	unsigned long cr4_guest_owned_bits;
340
	unsigned long cr8;
341
	u32 hflags;
342
	u64 efer;
343 344
	u64 apic_base;
	struct kvm_lapic *apic;    /* kernel irqchip context */
345
	unsigned long apic_attention;
346
	int32_t apic_arb_prio;
347 348
	int mp_state;
	u64 ia32_misc_enable_msr;
349
	bool tpr_access_reporting;
350

351 352 353 354 355 356 357
	/*
	 * Paging state of the vcpu
	 *
	 * If the vcpu runs in guest mode with two level paging this still saves
	 * the paging mode of the l1 guest. This context is always used to
	 * handle faults.
	 */
358
	struct kvm_mmu mmu;
359

360 361 362 363 364 365 366 367 368 369
	/*
	 * Paging state of an L2 guest (used for nested npt)
	 *
	 * This context will save all necessary information to walk page tables
	 * of the an L2 guest. This context is only initialized for page table
	 * walking and not for faulting since we never handle l2 page faults on
	 * the host.
	 */
	struct kvm_mmu nested_mmu;

370 371 372 373 374 375
	/*
	 * Pointer to the mmu context currently used for
	 * gva_to_gpa translations.
	 */
	struct kvm_mmu *walk_mmu;

376
	struct kvm_mmu_memory_cache mmu_pte_list_desc_cache;
377 378 379
	struct kvm_mmu_memory_cache mmu_page_cache;
	struct kvm_mmu_memory_cache mmu_page_header_cache;

S
Sheng Yang 已提交
380
	struct fpu guest_fpu;
381
	u64 xcr0;
382 383 384 385

	struct kvm_pio_request pio;
	void *pio_data;

386 387
	u8 event_exit_inst_len;

388 389 390
	struct kvm_queued_exception {
		bool pending;
		bool has_error_code;
391
		bool reinject;
392 393 394 395
		u8 nr;
		u32 error_code;
	} exception;

A
Avi Kivity 已提交
396 397
	struct kvm_queued_interrupt {
		bool pending;
398
		bool soft;
A
Avi Kivity 已提交
399 400 401
		u8 nr;
	} interrupt;

402 403 404
	int halt_request; /* real mode on Intel only */

	int cpuid_nent;
405
	struct kvm_cpuid_entry2 cpuid_entries[KVM_MAX_CPUID_ENTRIES];
406 407 408
	/* emulate context */

	struct x86_emulate_ctxt emulate_ctxt;
409 410
	bool emulate_regs_need_sync_to_vcpu;
	bool emulate_regs_need_sync_from_vcpu;
411
	int (*complete_userspace_io)(struct kvm_vcpu *vcpu);
412 413

	gpa_t time;
414
	struct pvclock_vcpu_time_info hv_clock;
Z
Zachary Amsden 已提交
415
	unsigned int hw_tsc_khz;
416 417
	struct gfn_to_hva_cache pv_time;
	bool pv_time_enabled;
418 419
	/* set guest stopped flag in pvclock flags field */
	bool pvclock_set_guest_stopped_request;
G
Glauber Costa 已提交
420 421 422 423 424 425 426 427 428

	struct {
		u64 msr_val;
		u64 last_steal;
		u64 accum_steal;
		struct gfn_to_hva_cache stime;
		struct kvm_steal_time steal;
	} st;

429 430
	u64 last_guest_tsc;
	u64 last_kernel_ns;
431
	u64 last_host_tsc;
432
	u64 tsc_offset_adjustment;
433 434 435
	u64 this_tsc_nsec;
	u64 this_tsc_write;
	u8  this_tsc_generation;
Z
Zachary Amsden 已提交
436
	bool tsc_catchup;
437 438 439 440
	bool tsc_always_catchup;
	s8 virtual_tsc_shift;
	u32 virtual_tsc_mult;
	u32 virtual_tsc_khz;
W
Will Auld 已提交
441
	s64 ia32_tsc_adjust_msr;
442

A
Avi Kivity 已提交
443 444 445
	atomic_t nmi_queued;  /* unprocessed asynchronous NMIs */
	unsigned nmi_pending; /* NMI queued after currently running handler */
	bool nmi_injected;    /* Trying to inject an NMI this entry */
A
Avi Kivity 已提交
446

S
Sheng Yang 已提交
447 448
	struct mtrr_state_type mtrr_state;
	u32 pat;
449 450 451 452 453 454

	int switch_db_regs;
	unsigned long db[KVM_NR_DB_REGS];
	unsigned long dr6;
	unsigned long dr7;
	unsigned long eff_db[KVM_NR_DB_REGS];
455
	unsigned long guest_debug_dr7;
H
Huang Ying 已提交
456 457 458 459 460

	u64 mcg_cap;
	u64 mcg_status;
	u64 mcg_ctl;
	u64 *mce_banks;
461

462 463 464 465 466
	/* Cache MMIO info */
	u64 mmio_gva;
	unsigned access;
	gfn_t mmio_gfn;

467 468
	struct kvm_pmu pmu;

469 470
	/* used for guest single stepping over the given code position */
	unsigned long singlestep_rip;
J
Jan Kiszka 已提交
471

G
Gleb Natapov 已提交
472 473
	/* fields used by HYPER-V emulation */
	u64 hv_vapic;
474 475

	cpumask_var_t wbinvd_dirty_mask;
476

477 478 479
	unsigned long last_retry_eip;
	unsigned long last_retry_addr;

480 481 482
	struct {
		bool halted;
		gfn_t gfns[roundup_pow_of_two(ASYNC_PF_PER_VCPU)];
483 484
		struct gfn_to_hva_cache data;
		u64 msr_val;
485
		u32 id;
486
		bool send_user_only;
487
	} apf;
488 489 490 491 492 493

	/* OSVW MSRs (AMD only) */
	struct {
		u64 length;
		u64 status;
	} osvw;
494 495 496 497 498

	struct {
		u64 msr_val;
		struct gfn_to_hva_cache data;
	} pv_eoi;
499 500 501 502 503 504 505

	/*
	 * Indicate whether the access faults on its page table in guest
	 * which is set when fix page fault and used to detect unhandeable
	 * instruction.
	 */
	bool write_fault_to_shadow_pgtable;
506 507
};

508 509 510 511 512
struct kvm_lpage_info {
	int write_count;
};

struct kvm_arch_memory_slot {
513
	unsigned long *rmap[KVM_NR_PAGE_SIZES];
514 515 516
	struct kvm_lpage_info *lpage_info[KVM_NR_PAGE_SIZES - 1];
};

517 518 519 520 521 522 523 524 525 526
struct kvm_apic_map {
	struct rcu_head rcu;
	u8 ldr_bits;
	/* fields bellow are used to decode ldr values in different modes */
	u32 cid_shift, cid_mask, lid_mask;
	struct kvm_lapic *phys_map[256];
	/* first index is cluster id second is cpu id in a cluster */
	struct kvm_lapic *logical_map[16][16];
};

527
struct kvm_arch {
528
	unsigned int n_used_mmu_pages;
529
	unsigned int n_requested_mmu_pages;
530
	unsigned int n_max_mmu_pages;
531
	unsigned int indirect_shadow_pages;
532 533 534 535 536
	struct hlist_head mmu_page_hash[KVM_NUM_MMU_PAGES];
	/*
	 * Hash table of struct kvm_mmu_page.
	 */
	struct list_head active_mmu_pages;
B
Ben-Ami Yassour 已提交
537
	struct list_head assigned_dev_head;
J
Joerg Roedel 已提交
538
	struct iommu_domain *iommu_domain;
539
	int iommu_flags;
540 541
	struct kvm_pic *vpic;
	struct kvm_ioapic *vioapic;
S
Sheng Yang 已提交
542
	struct kvm_pit *vpit;
543
	int vapics_in_nmi_mode;
544 545
	struct mutex apic_map_lock;
	struct kvm_apic_map *apic_map;
546 547 548

	unsigned int tss_addr;
	struct page *apic_access_page;
549 550

	gpa_t wall_clock;
551 552 553

	struct page *ept_identity_pagetable;
	bool ept_identity_pagetable_done;
554
	gpa_t ept_identity_map_addr;
555 556

	unsigned long irq_sources_bitmap;
557
	s64 kvmclock_offset;
558
	raw_spinlock_t tsc_write_lock;
Z
Zachary Amsden 已提交
559 560
	u64 last_tsc_nsec;
	u64 last_tsc_write;
561
	u32 last_tsc_khz;
562 563 564 565
	u64 cur_tsc_nsec;
	u64 cur_tsc_write;
	u64 cur_tsc_offset;
	u8  cur_tsc_generation;
566
	int nr_vcpus_matched_tsc;
E
Ed Swierk 已提交
567

568 569 570 571 572
	spinlock_t pvclock_gtod_sync_lock;
	bool use_master_clock;
	u64 master_kernel_ns;
	cycle_t master_cycle_now;

E
Ed Swierk 已提交
573
	struct kvm_xen_hvm_config xen_hvm_config;
574 575 576 577

	/* fields used by HYPER-V emulation */
	u64 hv_guest_os_id;
	u64 hv_hypercall;
578 579 580 581

	#ifdef CONFIG_KVM_MMU_AUDIT
	int audit_point;
	#endif
582 583
};

584 585 586 587 588 589 590
struct kvm_vm_stat {
	u32 mmu_shadow_zapped;
	u32 mmu_pte_write;
	u32 mmu_pte_updated;
	u32 mmu_pde_zapped;
	u32 mmu_flooded;
	u32 mmu_recycled;
A
Avi Kivity 已提交
591
	u32 mmu_cache_miss;
592
	u32 mmu_unsync;
593
	u32 remote_tlb_flush;
M
Marcelo Tosatti 已提交
594
	u32 lpages;
595 596
};

597 598 599 600 601 602 603 604 605 606 607
struct kvm_vcpu_stat {
	u32 pf_fixed;
	u32 pf_guest;
	u32 tlb_flush;
	u32 invlpg;

	u32 exits;
	u32 io_exits;
	u32 mmio_exits;
	u32 signal_exits;
	u32 irq_window_exits;
608
	u32 nmi_window_exits;
609 610 611 612 613 614 615 616 617
	u32 halt_exits;
	u32 halt_wakeup;
	u32 request_irq_exits;
	u32 irq_exits;
	u32 host_state_reload;
	u32 efer_reload;
	u32 fpu_reload;
	u32 insn_emulation;
	u32 insn_emulation_fail;
A
Amit Shah 已提交
618
	u32 hypercalls;
619
	u32 irq_injections;
620
	u32 nmi_injections;
621
};
622

623 624
struct x86_instruction_info;

625 626 627 628 629 630
struct msr_data {
	bool host_initiated;
	u32 index;
	u64 data;
};

631 632 633
struct kvm_x86_ops {
	int (*cpu_has_kvm_support)(void);          /* __init */
	int (*disabled_by_bios)(void);             /* __init */
634
	int (*hardware_enable)(void *dummy);
635 636 637 638
	void (*hardware_disable)(void *dummy);
	void (*check_processor_compatibility)(void *rtn);
	int (*hardware_setup)(void);               /* __init */
	void (*hardware_unsetup)(void);            /* __exit */
639
	bool (*cpu_has_accelerated_tpr)(void);
640
	void (*cpuid_update)(struct kvm_vcpu *vcpu);
641 642 643 644

	/* Create, but do not attach this VCPU */
	struct kvm_vcpu *(*vcpu_create)(struct kvm *kvm, unsigned id);
	void (*vcpu_free)(struct kvm_vcpu *vcpu);
645
	void (*vcpu_reset)(struct kvm_vcpu *vcpu);
646 647 648 649 650

	void (*prepare_guest_switch)(struct kvm_vcpu *vcpu);
	void (*vcpu_load)(struct kvm_vcpu *vcpu, int cpu);
	void (*vcpu_put)(struct kvm_vcpu *vcpu);

651
	void (*update_db_bp_intercept)(struct kvm_vcpu *vcpu);
652
	int (*get_msr)(struct kvm_vcpu *vcpu, u32 msr_index, u64 *pdata);
653
	int (*set_msr)(struct kvm_vcpu *vcpu, struct msr_data *msr);
654 655 656
	u64 (*get_segment_base)(struct kvm_vcpu *vcpu, int seg);
	void (*get_segment)(struct kvm_vcpu *vcpu,
			    struct kvm_segment *var, int seg);
657
	int (*get_cpl)(struct kvm_vcpu *vcpu);
658 659 660
	void (*set_segment)(struct kvm_vcpu *vcpu,
			    struct kvm_segment *var, int seg);
	void (*get_cs_db_l_bits)(struct kvm_vcpu *vcpu, int *db, int *l);
661
	void (*decache_cr0_guest_bits)(struct kvm_vcpu *vcpu);
662
	void (*decache_cr3)(struct kvm_vcpu *vcpu);
663 664 665
	void (*decache_cr4_guest_bits)(struct kvm_vcpu *vcpu);
	void (*set_cr0)(struct kvm_vcpu *vcpu, unsigned long cr0);
	void (*set_cr3)(struct kvm_vcpu *vcpu, unsigned long cr3);
666
	int (*set_cr4)(struct kvm_vcpu *vcpu, unsigned long cr4);
667
	void (*set_efer)(struct kvm_vcpu *vcpu, u64 efer);
668 669 670 671
	void (*get_idt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
	void (*set_idt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
	void (*get_gdt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
	void (*set_gdt)(struct kvm_vcpu *vcpu, struct desc_ptr *dt);
672
	void (*set_dr7)(struct kvm_vcpu *vcpu, unsigned long value);
673
	void (*cache_reg)(struct kvm_vcpu *vcpu, enum kvm_reg reg);
674 675
	unsigned long (*get_rflags)(struct kvm_vcpu *vcpu);
	void (*set_rflags)(struct kvm_vcpu *vcpu, unsigned long rflags);
A
Avi Kivity 已提交
676
	void (*fpu_activate)(struct kvm_vcpu *vcpu);
677
	void (*fpu_deactivate)(struct kvm_vcpu *vcpu);
678 679 680

	void (*tlb_flush)(struct kvm_vcpu *vcpu);

A
Avi Kivity 已提交
681 682
	void (*run)(struct kvm_vcpu *vcpu);
	int (*handle_exit)(struct kvm_vcpu *vcpu);
683
	void (*skip_emulated_instruction)(struct kvm_vcpu *vcpu);
684 685
	void (*set_interrupt_shadow)(struct kvm_vcpu *vcpu, int mask);
	u32 (*get_interrupt_shadow)(struct kvm_vcpu *vcpu, int mask);
686 687
	void (*patch_hypercall)(struct kvm_vcpu *vcpu,
				unsigned char *hypercall_addr);
688
	void (*set_irq)(struct kvm_vcpu *vcpu);
689
	void (*set_nmi)(struct kvm_vcpu *vcpu);
690
	void (*queue_exception)(struct kvm_vcpu *vcpu, unsigned nr,
691 692
				bool has_error_code, u32 error_code,
				bool reinject);
A
Avi Kivity 已提交
693
	void (*cancel_injection)(struct kvm_vcpu *vcpu);
694
	int (*interrupt_allowed)(struct kvm_vcpu *vcpu);
695
	int (*nmi_allowed)(struct kvm_vcpu *vcpu);
J
Jan Kiszka 已提交
696 697
	bool (*get_nmi_mask)(struct kvm_vcpu *vcpu);
	void (*set_nmi_mask)(struct kvm_vcpu *vcpu, bool masked);
698
	void (*enable_nmi_window)(struct kvm_vcpu *vcpu);
699
	int (*enable_irq_window)(struct kvm_vcpu *vcpu);
700
	void (*update_cr8_intercept)(struct kvm_vcpu *vcpu, int tpr, int irr);
701 702 703 704
	int (*vm_has_apicv)(struct kvm *kvm);
	void (*hwapic_irr_update)(struct kvm_vcpu *vcpu, int max_irr);
	void (*hwapic_isr_update)(struct kvm *kvm, int isr);
	void (*load_eoi_exitmap)(struct kvm_vcpu *vcpu, u64 *eoi_exit_bitmap);
705
	void (*set_virtual_x2apic_mode)(struct kvm_vcpu *vcpu, bool set);
706 707
	void (*deliver_posted_interrupt)(struct kvm_vcpu *vcpu, int vector);
	void (*sync_pir_to_irr)(struct kvm_vcpu *vcpu);
708
	int (*set_tss_addr)(struct kvm *kvm, unsigned int addr);
709
	int (*get_tdp_level)(void);
710
	u64 (*get_mt_mask)(struct kvm_vcpu *vcpu, gfn_t gfn, bool is_mmio);
711
	int (*get_lpage_level)(void);
712
	bool (*rdtscp_supported)(void);
713
	bool (*invpcid_supported)(void);
714
	void (*adjust_tsc_offset)(struct kvm_vcpu *vcpu, s64 adjustment, bool host);
715

716 717
	void (*set_tdp_cr3)(struct kvm_vcpu *vcpu, unsigned long cr3);

718 719
	void (*set_supported_cpuid)(u32 func, struct kvm_cpuid_entry2 *entry);

720 721
	bool (*has_wbinvd_exit)(void);

722
	void (*set_tsc_khz)(struct kvm_vcpu *vcpu, u32 user_tsc_khz, bool scale);
W
Will Auld 已提交
723
	u64 (*read_tsc_offset)(struct kvm_vcpu *vcpu);
724 725
	void (*write_tsc_offset)(struct kvm_vcpu *vcpu, u64 offset);

726
	u64 (*compute_tsc_offset)(struct kvm_vcpu *vcpu, u64 target_tsc);
727
	u64 (*read_l1_tsc)(struct kvm_vcpu *vcpu, u64 host_tsc);
728

729
	void (*get_exit_info)(struct kvm_vcpu *vcpu, u64 *info1, u64 *info2);
730 731 732 733

	int (*check_intercept)(struct kvm_vcpu *vcpu,
			       struct x86_instruction_info *info,
			       enum x86_intercept_stage stage);
734
	void (*handle_external_intr)(struct kvm_vcpu *vcpu);
735 736
};

737
struct kvm_arch_async_pf {
738
	u32 token;
739
	gfn_t gfn;
X
Xiao Guangrong 已提交
740
	unsigned long cr3;
741
	bool direct_map;
742 743
};

744 745
extern struct kvm_x86_ops *kvm_x86_ops;

746 747 748 749 750 751 752 753 754 755 756
static inline void adjust_tsc_offset_guest(struct kvm_vcpu *vcpu,
					   s64 adjustment)
{
	kvm_x86_ops->adjust_tsc_offset(vcpu, adjustment, false);
}

static inline void adjust_tsc_offset_host(struct kvm_vcpu *vcpu, s64 adjustment)
{
	kvm_x86_ops->adjust_tsc_offset(vcpu, adjustment, true);
}

757 758 759 760 761 762
int kvm_mmu_module_init(void);
void kvm_mmu_module_exit(void);

void kvm_mmu_destroy(struct kvm_vcpu *vcpu);
int kvm_mmu_create(struct kvm_vcpu *vcpu);
int kvm_mmu_setup(struct kvm_vcpu *vcpu);
S
Sheng Yang 已提交
763
void kvm_mmu_set_mask_ptes(u64 user_mask, u64 accessed_mask,
764
		u64 dirty_mask, u64 nx_mask, u64 x_mask);
765 766 767

int kvm_mmu_reset_context(struct kvm_vcpu *vcpu);
void kvm_mmu_slot_remove_write_access(struct kvm *kvm, int slot);
768 769 770
void kvm_mmu_write_protect_pt_masked(struct kvm *kvm,
				     struct kvm_memory_slot *slot,
				     gfn_t gfn_offset, unsigned long mask);
771
void kvm_mmu_zap_all(struct kvm *kvm);
772
void kvm_mmu_zap_mmio_sptes(struct kvm *kvm);
773
unsigned int kvm_mmu_calculate_mmu_pages(struct kvm *kvm);
774 775
void kvm_mmu_change_mmu_pages(struct kvm *kvm, unsigned int kvm_nr_mmu_pages);

776
int load_pdptrs(struct kvm_vcpu *vcpu, struct kvm_mmu *mmu, unsigned long cr3);
777

778
int emulator_write_phys(struct kvm_vcpu *vcpu, gpa_t gpa,
779
			  const void *val, int bytes);
780
u8 kvm_get_guest_memory_type(struct kvm_vcpu *vcpu, gfn_t gfn);
781 782

extern bool tdp_enabled;
783

784 785
u64 vcpu_tsc_khz(struct kvm_vcpu *vcpu);

786 787 788 789 790 791 792
/* control of guest tsc rate supported? */
extern bool kvm_has_tsc_control;
/* minimum supported tsc_khz for guests */
extern u32  kvm_min_guest_tsc_khz;
/* maximum supported tsc_khz for guests */
extern u32  kvm_max_guest_tsc_khz;

793 794 795 796 797 798
enum emulation_result {
	EMULATE_DONE,       /* no further processing */
	EMULATE_DO_MMIO,      /* kvm_run filled with mmio request */
	EMULATE_FAIL,         /* can't emulate this instruction */
};

799 800
#define EMULTYPE_NO_DECODE	    (1 << 0)
#define EMULTYPE_TRAP_UD	    (1 << 1)
801
#define EMULTYPE_SKIP		    (1 << 2)
802
#define EMULTYPE_RETRY		    (1 << 3)
803
#define EMULTYPE_NO_REEXECUTE	    (1 << 4)
804 805
int x86_emulate_instruction(struct kvm_vcpu *vcpu, unsigned long cr2,
			    int emulation_type, void *insn, int insn_len);
806 807 808 809

static inline int emulate_instruction(struct kvm_vcpu *vcpu,
			int emulation_type)
{
810
	return x86_emulate_instruction(vcpu, 0, emulation_type, NULL, 0);
811 812
}

813
void kvm_enable_efer_bits(u64);
814
bool kvm_valid_efer(struct kvm_vcpu *vcpu, u64 efer);
815
int kvm_get_msr(struct kvm_vcpu *vcpu, u32 msr_index, u64 *data);
816
int kvm_set_msr(struct kvm_vcpu *vcpu, struct msr_data *msr);
817 818 819

struct x86_emulate_ctxt;

820
int kvm_fast_pio_out(struct kvm_vcpu *vcpu, int size, unsigned short port);
821 822
void kvm_emulate_cpuid(struct kvm_vcpu *vcpu);
int kvm_emulate_halt(struct kvm_vcpu *vcpu);
823
int kvm_emulate_wbinvd(struct kvm_vcpu *vcpu);
824

825
void kvm_get_segment(struct kvm_vcpu *vcpu, struct kvm_segment *var, int seg);
826
int kvm_load_segment_descriptor(struct kvm_vcpu *vcpu, u16 selector, int seg);
827
void kvm_vcpu_deliver_sipi_vector(struct kvm_vcpu *vcpu, unsigned int vector);
828

829 830
int kvm_task_switch(struct kvm_vcpu *vcpu, u16 tss_selector, int idt_index,
		    int reason, bool has_error_code, u32 error_code);
831

832
int kvm_set_cr0(struct kvm_vcpu *vcpu, unsigned long cr0);
833
int kvm_set_cr3(struct kvm_vcpu *vcpu, unsigned long cr3);
834
int kvm_set_cr4(struct kvm_vcpu *vcpu, unsigned long cr4);
A
Andre Przywara 已提交
835
int kvm_set_cr8(struct kvm_vcpu *vcpu, unsigned long cr8);
836 837
int kvm_set_dr(struct kvm_vcpu *vcpu, int dr, unsigned long val);
int kvm_get_dr(struct kvm_vcpu *vcpu, int dr, unsigned long *val);
838 839
unsigned long kvm_get_cr8(struct kvm_vcpu *vcpu);
void kvm_lmsw(struct kvm_vcpu *vcpu, unsigned long msw);
840
void kvm_get_cs_db_l_bits(struct kvm_vcpu *vcpu, int *db, int *l);
841
int kvm_set_xcr(struct kvm_vcpu *vcpu, u32 index, u64 xcr);
842 843

int kvm_get_msr_common(struct kvm_vcpu *vcpu, u32 msr, u64 *pdata);
844
int kvm_set_msr_common(struct kvm_vcpu *vcpu, struct msr_data *msr);
845

846 847
unsigned long kvm_get_rflags(struct kvm_vcpu *vcpu);
void kvm_set_rflags(struct kvm_vcpu *vcpu, unsigned long rflags);
A
Avi Kivity 已提交
848
bool kvm_rdpmc(struct kvm_vcpu *vcpu);
849

850 851
void kvm_queue_exception(struct kvm_vcpu *vcpu, unsigned nr);
void kvm_queue_exception_e(struct kvm_vcpu *vcpu, unsigned nr, u32 error_code);
852 853
void kvm_requeue_exception(struct kvm_vcpu *vcpu, unsigned nr);
void kvm_requeue_exception_e(struct kvm_vcpu *vcpu, unsigned nr, u32 error_code);
854
void kvm_inject_page_fault(struct kvm_vcpu *vcpu, struct x86_exception *fault);
855 856 857
int kvm_read_guest_page_mmu(struct kvm_vcpu *vcpu, struct kvm_mmu *mmu,
			    gfn_t gfn, void *data, int offset, int len,
			    u32 access);
858
void kvm_propagate_fault(struct kvm_vcpu *vcpu, struct x86_exception *fault);
859
bool kvm_require_cpl(struct kvm_vcpu *vcpu, int required_cpl);
860

861 862 863 864 865 866 867 868 869 870 871 872 873 874
static inline int __kvm_irq_line_state(unsigned long *irq_state,
				       int irq_source_id, int level)
{
	/* Logical OR for level trig interrupt */
	if (level)
		__set_bit(irq_source_id, irq_state);
	else
		__clear_bit(irq_source_id, irq_state);

	return !!(*irq_state);
}

int kvm_pic_set_irq(struct kvm_pic *pic, int irq, int irq_source_id, int level);
void kvm_pic_clear_all(struct kvm_pic *pic, int irq_source_id);
875

876 877
void kvm_inject_nmi(struct kvm_vcpu *vcpu);

878
int fx_init(struct kvm_vcpu *vcpu);
879

880
void kvm_mmu_flush_tlb(struct kvm_vcpu *vcpu);
881
void kvm_mmu_pte_write(struct kvm_vcpu *vcpu, gpa_t gpa,
882
		       const u8 *new, int bytes);
883
int kvm_mmu_unprotect_page(struct kvm *kvm, gfn_t gfn);
884 885 886 887
int kvm_mmu_unprotect_page_virt(struct kvm_vcpu *vcpu, gva_t gva);
void __kvm_mmu_free_some_pages(struct kvm_vcpu *vcpu);
int kvm_mmu_load(struct kvm_vcpu *vcpu);
void kvm_mmu_unload(struct kvm_vcpu *vcpu);
888
void kvm_mmu_sync_roots(struct kvm_vcpu *vcpu);
889
gpa_t translate_nested_gpa(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access);
890 891 892 893 894 895 896 897
gpa_t kvm_mmu_gva_to_gpa_read(struct kvm_vcpu *vcpu, gva_t gva,
			      struct x86_exception *exception);
gpa_t kvm_mmu_gva_to_gpa_fetch(struct kvm_vcpu *vcpu, gva_t gva,
			       struct x86_exception *exception);
gpa_t kvm_mmu_gva_to_gpa_write(struct kvm_vcpu *vcpu, gva_t gva,
			       struct x86_exception *exception);
gpa_t kvm_mmu_gva_to_gpa_system(struct kvm_vcpu *vcpu, gva_t gva,
				struct x86_exception *exception);
898 899 900

int kvm_emulate_hypercall(struct kvm_vcpu *vcpu);

901 902
int kvm_mmu_page_fault(struct kvm_vcpu *vcpu, gva_t gva, u32 error_code,
		       void *insn, int insn_len);
M
Marcelo Tosatti 已提交
903
void kvm_mmu_invlpg(struct kvm_vcpu *vcpu, gva_t gva);
904

905
void kvm_enable_tdp(void);
906
void kvm_disable_tdp(void);
907

908
int complete_pio(struct kvm_vcpu *vcpu);
909
bool kvm_check_iopl(struct kvm_vcpu *vcpu);
910

911 912 913 914 915
static inline gpa_t translate_gpa(struct kvm_vcpu *vcpu, gpa_t gpa, u32 access)
{
	return gpa;
}

916 917 918 919 920 921 922
static inline struct kvm_mmu_page *page_header(hpa_t shadow_page)
{
	struct page *page = pfn_to_page(shadow_page >> PAGE_SHIFT);

	return (struct kvm_mmu_page *)page_private(page);
}

923
static inline u16 kvm_read_ldt(void)
924 925 926 927 928 929
{
	u16 ldt;
	asm("sldt %0" : "=g"(ldt));
	return ldt;
}

930
static inline void kvm_load_ldt(u16 sel)
931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949
{
	asm("lldt %0" : : "rm"(sel));
}

#ifdef CONFIG_X86_64
static inline unsigned long read_msr(unsigned long msr)
{
	u64 value;

	rdmsrl(msr, value);
	return value;
}
#endif

static inline u32 get_rdx_init_val(void)
{
	return 0x600; /* P6 family */
}

950 951 952 953 954
static inline void kvm_inject_gp(struct kvm_vcpu *vcpu, u32 error_code)
{
	kvm_queue_exception_e(vcpu, GP_VECTOR, error_code);
}

955 956 957 958
#define TSS_IOPB_BASE_OFFSET 0x66
#define TSS_BASE_SIZE 0x68
#define TSS_IOPB_SIZE (65536 / 8)
#define TSS_REDIRECTION_SIZE (256 / 8)
959 960
#define RMODE_TSS_SIZE							\
	(TSS_BASE_SIZE + TSS_REDIRECTION_SIZE + TSS_IOPB_SIZE + 1)
961

962 963 964 965 966 967 968
enum {
	TASK_SWITCH_CALL = 0,
	TASK_SWITCH_IRET = 1,
	TASK_SWITCH_JMP = 2,
	TASK_SWITCH_GATE = 3,
};

969
#define HF_GIF_MASK		(1 << 0)
A
Alexander Graf 已提交
970 971
#define HF_HIF_MASK		(1 << 1)
#define HF_VINTR_MASK		(1 << 2)
972
#define HF_NMI_MASK		(1 << 3)
973
#define HF_IRET_MASK		(1 << 4)
974
#define HF_GUEST_MASK		(1 << 5) /* VCPU is in guest-mode */
975

976 977 978 979 980
/*
 * Hardware virtualization extension instructions may fault if a
 * reboot turns off virtualization while processes are running.
 * Trap the fault and ignore the instruction if that happens.
 */
981
asmlinkage void kvm_spurious_fault(void);
982

983
#define ____kvm_handle_fault_on_reboot(insn, cleanup_insn)	\
984
	"666: " insn "\n\t" \
985
	"668: \n\t"                           \
986
	".pushsection .fixup, \"ax\" \n" \
987
	"667: \n\t" \
988
	cleanup_insn "\n\t"		      \
989 990
	"cmpb $0, kvm_rebooting \n\t"	      \
	"jne 668b \n\t"      		      \
991
	__ASM_SIZE(push) " $666b \n\t"	      \
992
	"call kvm_spurious_fault \n\t"	      \
993
	".popsection \n\t" \
994
	_ASM_EXTABLE(666b, 667b)
995

996 997 998
#define __kvm_handle_fault_on_reboot(insn)		\
	____kvm_handle_fault_on_reboot(insn, "")

999 1000
#define KVM_ARCH_WANT_MMU_NOTIFIER
int kvm_unmap_hva(struct kvm *kvm, unsigned long hva);
1001
int kvm_unmap_hva_range(struct kvm *kvm, unsigned long start, unsigned long end);
1002
int kvm_age_hva(struct kvm *kvm, unsigned long hva);
A
Andrea Arcangeli 已提交
1003
int kvm_test_age_hva(struct kvm *kvm, unsigned long hva);
1004
void kvm_set_spte_hva(struct kvm *kvm, unsigned long hva, pte_t pte);
1005
int cpuid_maxphyaddr(struct kvm_vcpu *vcpu);
1006
int kvm_cpu_has_injectable_intr(struct kvm_vcpu *v);
1007 1008
int kvm_cpu_has_interrupt(struct kvm_vcpu *vcpu);
int kvm_arch_interrupt_allowed(struct kvm_vcpu *vcpu);
1009
int kvm_cpu_get_interrupt(struct kvm_vcpu *v);
1010
void kvm_vcpu_reset(struct kvm_vcpu *vcpu);
1011

A
Avi Kivity 已提交
1012
void kvm_define_shared_msr(unsigned index, u32 msr);
1013
void kvm_set_shared_msr(unsigned index, u64 val, u64 mask);
A
Avi Kivity 已提交
1014

J
Jan Kiszka 已提交
1015 1016
bool kvm_is_linear_rip(struct kvm_vcpu *vcpu, unsigned long linear_rip);

1017 1018 1019 1020
void kvm_arch_async_page_not_present(struct kvm_vcpu *vcpu,
				     struct kvm_async_pf *work);
void kvm_arch_async_page_present(struct kvm_vcpu *vcpu,
				 struct kvm_async_pf *work);
G
Gleb Natapov 已提交
1021 1022
void kvm_arch_async_page_ready(struct kvm_vcpu *vcpu,
			       struct kvm_async_pf *work);
1023
bool kvm_arch_can_inject_async_page_present(struct kvm_vcpu *vcpu);
1024 1025
extern bool kvm_find_async_pf_gfn(struct kvm_vcpu *vcpu, gfn_t gfn);

1026 1027
void kvm_complete_insn_gp(struct kvm_vcpu *vcpu, int err);

1028 1029 1030 1031 1032 1033 1034 1035
int kvm_is_in_guest(void);

void kvm_pmu_init(struct kvm_vcpu *vcpu);
void kvm_pmu_destroy(struct kvm_vcpu *vcpu);
void kvm_pmu_reset(struct kvm_vcpu *vcpu);
void kvm_pmu_cpuid_update(struct kvm_vcpu *vcpu);
bool kvm_pmu_msr(struct kvm_vcpu *vcpu, u32 msr);
int kvm_pmu_get_msr(struct kvm_vcpu *vcpu, u32 msr, u64 *data);
1036
int kvm_pmu_set_msr(struct kvm_vcpu *vcpu, struct msr_data *msr_info);
1037 1038 1039 1040
int kvm_pmu_read_pmc(struct kvm_vcpu *vcpu, unsigned pmc, u64 *data);
void kvm_handle_pmu_event(struct kvm_vcpu *vcpu);
void kvm_deliver_pmi(struct kvm_vcpu *vcpu);

H
H. Peter Anvin 已提交
1041
#endif /* _ASM_X86_KVM_HOST_H */