err.no Git - linux-2.6/blob - drivers/kvm/kvm.h

   1 #ifndef __KVM_H
   2 #define __KVM_H
   3
   4 /*
   5  * This work is licensed under the terms of the GNU GPL, version 2.  See
   6  * the COPYING file in the top-level directory.
   7  */
   8
   9 #include <linux/types.h>
  10 #include <linux/list.h>
  11 #include <linux/mutex.h>
  12 #include <linux/spinlock.h>
  13 #include <linux/mm.h>
  14
  15 #include "vmx.h"
  16 #include <linux/kvm.h>
  17
  18 #define CR0_PE_MASK (1ULL << 0)
  19 #define CR0_TS_MASK (1ULL << 3)
  20 #define CR0_NE_MASK (1ULL << 5)
  21 #define CR0_WP_MASK (1ULL << 16)
  22 #define CR0_NW_MASK (1ULL << 29)
  23 #define CR0_CD_MASK (1ULL << 30)
  24 #define CR0_PG_MASK (1ULL << 31)
  25
  26 #define CR3_WPT_MASK (1ULL << 3)
  27 #define CR3_PCD_MASK (1ULL << 4)
  28
  29 #define CR3_RESEVED_BITS 0x07ULL
  30 #define CR3_L_MODE_RESEVED_BITS (~((1ULL << 40) - 1) | 0x0fe7ULL)
  31 #define CR3_FLAGS_MASK ((1ULL << 5) - 1)
  32
  33 #define CR4_VME_MASK (1ULL << 0)
  34 #define CR4_PSE_MASK (1ULL << 4)
  35 #define CR4_PAE_MASK (1ULL << 5)
  36 #define CR4_PGE_MASK (1ULL << 7)
  37 #define CR4_VMXE_MASK (1ULL << 13)
  38
  39 #define KVM_GUEST_CR0_MASK \
  40         (CR0_PG_MASK | CR0_PE_MASK | CR0_WP_MASK | CR0_NE_MASK \
  41          | CR0_NW_MASK | CR0_CD_MASK)
  42 #define KVM_VM_CR0_ALWAYS_ON \
  43         (CR0_PG_MASK | CR0_PE_MASK | CR0_WP_MASK | CR0_NE_MASK)
  44 #define KVM_GUEST_CR4_MASK \
  45         (CR4_PSE_MASK | CR4_PAE_MASK | CR4_PGE_MASK | CR4_VMXE_MASK | CR4_VME_MASK)
  46 #define KVM_PMODE_VM_CR4_ALWAYS_ON (CR4_VMXE_MASK | CR4_PAE_MASK)
  47 #define KVM_RMODE_VM_CR4_ALWAYS_ON (CR4_VMXE_MASK | CR4_PAE_MASK | CR4_VME_MASK)
  48
  49 #define INVALID_PAGE (~(hpa_t)0)
  50 #define UNMAPPED_GVA (~(gpa_t)0)
  51
  52 #define KVM_MAX_VCPUS 1
  53 #define KVM_MEMORY_SLOTS 4
  54 #define KVM_NUM_MMU_PAGES 256
  55
  56 #define FX_IMAGE_SIZE 512
  57 #define FX_IMAGE_ALIGN 16
  58 #define FX_BUF_SIZE (2 * FX_IMAGE_SIZE + FX_IMAGE_ALIGN)
  59
  60 #define DE_VECTOR 0
  61 #define DF_VECTOR 8
  62 #define TS_VECTOR 10
  63 #define NP_VECTOR 11
  64 #define SS_VECTOR 12
  65 #define GP_VECTOR 13
  66 #define PF_VECTOR 14
  67
  68 #define SELECTOR_TI_MASK (1 << 2)
  69 #define SELECTOR_RPL_MASK 0x03
  70
  71 #define IOPL_SHIFT 12
  72
  73 /*
  74  * Address types:
  75  *
  76  *  gva - guest virtual address
  77  *  gpa - guest physical address
  78  *  gfn - guest frame number
  79  *  hva - host virtual address
  80  *  hpa - host physical address
  81  *  hfn - host frame number
  82  */
  83
  84 typedef unsigned long  gva_t;
  85 typedef u64            gpa_t;
  86 typedef unsigned long  gfn_t;
  87
  88 typedef unsigned long  hva_t;
  89 typedef u64            hpa_t;
  90 typedef unsigned long  hfn_t;
  91
  92 struct kvm_mmu_page {
  93         struct list_head link;
  94         hpa_t page_hpa;
  95         unsigned long slot_bitmap; /* One bit set per slot which has memory
  96                                     * in this shadow page.
  97                                     */
  98         int global;              /* Set if all ptes in this page are global */
  99         u64 *parent_pte;
 100 };
 101
 102 struct vmcs {
 103         u32 revision_id;
 104         u32 abort;
 105         char data[0];
 106 };
 107
 108 #define vmx_msr_entry kvm_msr_entry
 109
 110 struct kvm_vcpu;
 111
 112 /*
 113  * x86 supports 3 paging modes (4-level 64-bit, 3-level 64-bit, and 2-level
 114  * 32-bit).  The kvm_mmu structure abstracts the details of the current mmu
 115  * mode.
 116  */
 117 struct kvm_mmu {
 118         void (*new_cr3)(struct kvm_vcpu *vcpu);
 119         int (*page_fault)(struct kvm_vcpu *vcpu, gva_t gva, u32 err);
 120         void (*inval_page)(struct kvm_vcpu *vcpu, gva_t gva);
 121         void (*free)(struct kvm_vcpu *vcpu);
 122         gpa_t (*gva_to_gpa)(struct kvm_vcpu *vcpu, gva_t gva);
 123         hpa_t root_hpa;
 124         int root_level;
 125         int shadow_root_level;
 126 };
 127
 128 struct kvm_guest_debug {
 129         int enabled;
 130         unsigned long bp[4];
 131         int singlestep;
 132 };
 133
 134 enum {
 135         VCPU_REGS_RAX = 0,
 136         VCPU_REGS_RCX = 1,
 137         VCPU_REGS_RDX = 2,
 138         VCPU_REGS_RBX = 3,
 139         VCPU_REGS_RSP = 4,
 140         VCPU_REGS_RBP = 5,
 141         VCPU_REGS_RSI = 6,
 142         VCPU_REGS_RDI = 7,
 143 #ifdef CONFIG_X86_64
 144         VCPU_REGS_R8 = 8,
 145         VCPU_REGS_R9 = 9,
 146         VCPU_REGS_R10 = 10,
 147         VCPU_REGS_R11 = 11,
 148         VCPU_REGS_R12 = 12,
 149         VCPU_REGS_R13 = 13,
 150         VCPU_REGS_R14 = 14,
 151         VCPU_REGS_R15 = 15,
 152 #endif
 153         NR_VCPU_REGS
 154 };
 155
 156 enum {
 157         VCPU_SREG_CS,
 158         VCPU_SREG_DS,
 159         VCPU_SREG_ES,
 160         VCPU_SREG_FS,
 161         VCPU_SREG_GS,
 162         VCPU_SREG_SS,
 163         VCPU_SREG_TR,
 164         VCPU_SREG_LDTR,
 165 };
 166
 167 struct kvm_vcpu {
 168         struct kvm *kvm;
 169         union {
 170                 struct vmcs *vmcs;
 171                 struct vcpu_svm *svm;
 172         };
 173         struct mutex mutex;
 174         int   cpu;
 175         int   launched;
 176         int interrupt_window_open;
 177         unsigned long irq_summary; /* bit vector: 1 per word in irq_pending */
 178 #define NR_IRQ_WORDS KVM_IRQ_BITMAP_SIZE(unsigned long)
 179         unsigned long irq_pending[NR_IRQ_WORDS];
 180         unsigned long regs[NR_VCPU_REGS]; /* for rsp: vcpu_load_rsp_rip() */
 181         unsigned long rip;      /* needs vcpu_load_rsp_rip() */
 182
 183         unsigned long cr0;
 184         unsigned long cr2;
 185         unsigned long cr3;
 186         unsigned long cr4;
 187         unsigned long cr8;
 188         u64 pdptrs[4]; /* pae */
 189         u64 shadow_efer;
 190         u64 apic_base;
 191         int nmsrs;
 192         struct vmx_msr_entry *guest_msrs;
 193         struct vmx_msr_entry *host_msrs;
 194
 195         struct list_head free_pages;
 196         struct kvm_mmu_page page_header_buf[KVM_NUM_MMU_PAGES];
 197         struct kvm_mmu mmu;
 198
 199         struct kvm_guest_debug guest_debug;
 200
 201         char fx_buf[FX_BUF_SIZE];
 202         char *host_fx_image;
 203         char *guest_fx_image;
 204
 205         int mmio_needed;
 206         int mmio_read_completed;
 207         int mmio_is_write;
 208         int mmio_size;
 209         unsigned char mmio_data[8];
 210         gpa_t mmio_phys_addr;
 211
 212         struct {
 213                 int active;
 214                 u8 save_iopl;
 215                 struct kvm_save_segment {
 216                         u16 selector;
 217                         unsigned long base;
 218                         u32 limit;
 219                         u32 ar;
 220                 } tr, es, ds, fs, gs;
 221         } rmode;
 222 };
 223
 224 struct kvm_memory_slot {
 225         gfn_t base_gfn;
 226         unsigned long npages;
 227         unsigned long flags;
 228         struct page **phys_mem;
 229         unsigned long *dirty_bitmap;
 230 };
 231
 232 struct kvm {
 233         spinlock_t lock; /* protects everything except vcpus */
 234         int nmemslots;
 235         struct kvm_memory_slot memslots[KVM_MEMORY_SLOTS];
 236         struct list_head active_mmu_pages;
 237         struct kvm_vcpu vcpus[KVM_MAX_VCPUS];
 238         int memory_config_version;
 239         int busy;
 240         unsigned long rmap_overflow;
 241 };
 242
 243 struct kvm_stat {
 244         u32 pf_fixed;
 245         u32 pf_guest;
 246         u32 tlb_flush;
 247         u32 invlpg;
 248
 249         u32 exits;
 250         u32 io_exits;
 251         u32 mmio_exits;
 252         u32 signal_exits;
 253         u32 irq_window_exits;
 254         u32 halt_exits;
 255         u32 request_irq_exits;
 256         u32 irq_exits;
 257 };
 258
 259 struct descriptor_table {
 260         u16 limit;
 261         unsigned long base;
 262 } __attribute__((packed));
 263
 264 struct kvm_arch_ops {
 265         int (*cpu_has_kvm_support)(void);          /* __init */
 266         int (*disabled_by_bios)(void);             /* __init */
 267         void (*hardware_enable)(void *dummy);      /* __init */
 268         void (*hardware_disable)(void *dummy);
 269         int (*hardware_setup)(void);               /* __init */
 270         void (*hardware_unsetup)(void);            /* __exit */
 271
 272         int (*vcpu_create)(struct kvm_vcpu *vcpu);
 273         void (*vcpu_free)(struct kvm_vcpu *vcpu);
 274
 275         struct kvm_vcpu *(*vcpu_load)(struct kvm_vcpu *vcpu);
 276         void (*vcpu_put)(struct kvm_vcpu *vcpu);
 277
 278         int (*set_guest_debug)(struct kvm_vcpu *vcpu,
 279                                struct kvm_debug_guest *dbg);
 280         int (*get_msr)(struct kvm_vcpu *vcpu, u32 msr_index, u64 *pdata);
 281         int (*set_msr)(struct kvm_vcpu *vcpu, u32 msr_index, u64 data);
 282         u64 (*get_segment_base)(struct kvm_vcpu *vcpu, int seg);
 283         void (*get_segment)(struct kvm_vcpu *vcpu,
 284                             struct kvm_segment *var, int seg);
 285         void (*set_segment)(struct kvm_vcpu *vcpu,
 286                             struct kvm_segment *var, int seg);
 287         void (*get_cs_db_l_bits)(struct kvm_vcpu *vcpu, int *db, int *l);
 288         void (*decache_cr0_cr4_guest_bits)(struct kvm_vcpu *vcpu);
 289         void (*set_cr0)(struct kvm_vcpu *vcpu, unsigned long cr0);
 290         void (*set_cr0_no_modeswitch)(struct kvm_vcpu *vcpu,
 291                                       unsigned long cr0);
 292         void (*set_cr3)(struct kvm_vcpu *vcpu, unsigned long cr3);
 293         void (*set_cr4)(struct kvm_vcpu *vcpu, unsigned long cr4);
 294         void (*set_efer)(struct kvm_vcpu *vcpu, u64 efer);
 295         void (*get_idt)(struct kvm_vcpu *vcpu, struct descriptor_table *dt);
 296         void (*set_idt)(struct kvm_vcpu *vcpu, struct descriptor_table *dt);
 297         void (*get_gdt)(struct kvm_vcpu *vcpu, struct descriptor_table *dt);
 298         void (*set_gdt)(struct kvm_vcpu *vcpu, struct descriptor_table *dt);
 299         unsigned long (*get_dr)(struct kvm_vcpu *vcpu, int dr);
 300         void (*set_dr)(struct kvm_vcpu *vcpu, int dr, unsigned long value,
 301                        int *exception);
 302         void (*cache_regs)(struct kvm_vcpu *vcpu);
 303         void (*decache_regs)(struct kvm_vcpu *vcpu);
 304         unsigned long (*get_rflags)(struct kvm_vcpu *vcpu);
 305         void (*set_rflags)(struct kvm_vcpu *vcpu, unsigned long rflags);
 306
 307         void (*invlpg)(struct kvm_vcpu *vcpu, gva_t addr);
 308         void (*tlb_flush)(struct kvm_vcpu *vcpu);
 309         void (*inject_page_fault)(struct kvm_vcpu *vcpu,
 310                                   unsigned long addr, u32 err_code);
 311
 312         void (*inject_gp)(struct kvm_vcpu *vcpu, unsigned err_code);
 313
 314         int (*run)(struct kvm_vcpu *vcpu, struct kvm_run *run);
 315         int (*vcpu_setup)(struct kvm_vcpu *vcpu);
 316         void (*skip_emulated_instruction)(struct kvm_vcpu *vcpu);
 317 };
 318
 319 extern struct kvm_stat kvm_stat;
 320 extern struct kvm_arch_ops *kvm_arch_ops;
 321
 322 #define kvm_printf(kvm, fmt ...) printk(KERN_DEBUG fmt)
 323 #define vcpu_printf(vcpu, fmt...) kvm_printf(vcpu->kvm, fmt)
 324
 325 int kvm_init_arch(struct kvm_arch_ops *ops, struct module *module);
 326 void kvm_exit_arch(void);
 327
 328 void kvm_mmu_destroy(struct kvm_vcpu *vcpu);
 329 int kvm_mmu_create(struct kvm_vcpu *vcpu);
 330 int kvm_mmu_setup(struct kvm_vcpu *vcpu);
 331
 332 int kvm_mmu_reset_context(struct kvm_vcpu *vcpu);
 333 void kvm_mmu_slot_remove_write_access(struct kvm *kvm, int slot);
 334
 335 hpa_t gpa_to_hpa(struct kvm_vcpu *vcpu, gpa_t gpa);
 336 #define HPA_MSB ((sizeof(hpa_t) * 8) - 1)
 337 #define HPA_ERR_MASK ((hpa_t)1 << HPA_MSB)
 338 static inline int is_error_hpa(hpa_t hpa) { return hpa >> HPA_MSB; }
 339 hpa_t gva_to_hpa(struct kvm_vcpu *vcpu, gva_t gva);
 340
 341 void kvm_emulator_want_group7_invlpg(void);
 342
 343 extern hpa_t bad_page_address;
 344
 345 static inline struct page *gfn_to_page(struct kvm_memory_slot *slot, gfn_t gfn)
 346 {
 347         return slot->phys_mem[gfn - slot->base_gfn];
 348 }
 349
 350 struct kvm_memory_slot *gfn_to_memslot(struct kvm *kvm, gfn_t gfn);
 351 void mark_page_dirty(struct kvm *kvm, gfn_t gfn);
 352
 353 enum emulation_result {
 354         EMULATE_DONE,       /* no further processing */
 355         EMULATE_DO_MMIO,      /* kvm_run filled with mmio request */
 356         EMULATE_FAIL,         /* can't emulate this instruction */
 357 };
 358
 359 int emulate_instruction(struct kvm_vcpu *vcpu, struct kvm_run *run,
 360                         unsigned long cr2, u16 error_code);
 361 void realmode_lgdt(struct kvm_vcpu *vcpu, u16 size, unsigned long address);
 362 void realmode_lidt(struct kvm_vcpu *vcpu, u16 size, unsigned long address);
 363 void realmode_lmsw(struct kvm_vcpu *vcpu, unsigned long msw,
 364                    unsigned long *rflags);
 365
 366 unsigned long realmode_get_cr(struct kvm_vcpu *vcpu, int cr);
 367 void realmode_set_cr(struct kvm_vcpu *vcpu, int cr, unsigned long value,
 368                      unsigned long *rflags);
 369
 370 struct x86_emulate_ctxt;
 371
 372 int emulate_invlpg(struct kvm_vcpu *vcpu, gva_t address);
 373 int emulate_clts(struct kvm_vcpu *vcpu);
 374 int emulator_get_dr(struct x86_emulate_ctxt* ctxt, int dr,
 375                     unsigned long *dest);
 376 int emulator_set_dr(struct x86_emulate_ctxt *ctxt, int dr,
 377                     unsigned long value);
 378
 379 void set_cr0(struct kvm_vcpu *vcpu, unsigned long cr0);
 380 void set_cr3(struct kvm_vcpu *vcpu, unsigned long cr0);
 381 void set_cr4(struct kvm_vcpu *vcpu, unsigned long cr0);
 382 void set_cr8(struct kvm_vcpu *vcpu, unsigned long cr0);
 383 void lmsw(struct kvm_vcpu *vcpu, unsigned long msw);
 384
 385 int kvm_get_msr_common(struct kvm_vcpu *vcpu, u32 msr, u64 *pdata);
 386 int kvm_set_msr_common(struct kvm_vcpu *vcpu, u32 msr, u64 data);
 387
 388 void fx_init(struct kvm_vcpu *vcpu);
 389
 390 void load_msrs(struct vmx_msr_entry *e, int n);
 391 void save_msrs(struct vmx_msr_entry *e, int n);
 392 void kvm_resched(struct kvm_vcpu *vcpu);
 393
 394 int kvm_read_guest(struct kvm_vcpu *vcpu,
 395                gva_t addr,
 396                unsigned long size,
 397                void *dest);
 398
 399 int kvm_write_guest(struct kvm_vcpu *vcpu,
 400                 gva_t addr,
 401                 unsigned long size,
 402                 void *data);
 403
 404 unsigned long segment_base(u16 selector);
 405
 406 static inline struct page *_gfn_to_page(struct kvm *kvm, gfn_t gfn)
 407 {
 408         struct kvm_memory_slot *slot = gfn_to_memslot(kvm, gfn);
 409         return (slot) ? slot->phys_mem[gfn - slot->base_gfn] : NULL;
 410 }
 411
 412 static inline int is_long_mode(struct kvm_vcpu *vcpu)
 413 {
 414 #ifdef CONFIG_X86_64
 415         return vcpu->shadow_efer & EFER_LME;
 416 #else
 417         return 0;
 418 #endif
 419 }
 420
 421 static inline int is_pae(struct kvm_vcpu *vcpu)
 422 {
 423         return vcpu->cr4 & CR4_PAE_MASK;
 424 }
 425
 426 static inline int is_pse(struct kvm_vcpu *vcpu)
 427 {
 428         return vcpu->cr4 & CR4_PSE_MASK;
 429 }
 430
 431 static inline int is_paging(struct kvm_vcpu *vcpu)
 432 {
 433         return vcpu->cr0 & CR0_PG_MASK;
 434 }
 435
 436 static inline int memslot_id(struct kvm *kvm, struct kvm_memory_slot *slot)
 437 {
 438         return slot - kvm->memslots;
 439 }
 440
 441 static inline struct kvm_mmu_page *page_header(hpa_t shadow_page)
 442 {
 443         struct page *page = pfn_to_page(shadow_page >> PAGE_SHIFT);
 444
 445         return (struct kvm_mmu_page *)page->private;
 446 }
 447
 448 static inline u16 read_fs(void)
 449 {
 450         u16 seg;
 451         asm ("mov %%fs, %0" : "=g"(seg));
 452         return seg;
 453 }
 454
 455 static inline u16 read_gs(void)
 456 {
 457         u16 seg;
 458         asm ("mov %%gs, %0" : "=g"(seg));
 459         return seg;
 460 }
 461
 462 static inline u16 read_ldt(void)
 463 {
 464         u16 ldt;
 465         asm ("sldt %0" : "=g"(ldt));
 466         return ldt;
 467 }
 468
 469 static inline void load_fs(u16 sel)
 470 {
 471         asm ("mov %0, %%fs" : : "rm"(sel));
 472 }
 473
 474 static inline void load_gs(u16 sel)
 475 {
 476         asm ("mov %0, %%gs" : : "rm"(sel));
 477 }
 478
 479 #ifndef load_ldt
 480 static inline void load_ldt(u16 sel)
 481 {
 482         asm ("lldt %0" : : "g"(sel));
 483 }
 484 #endif
 485
 486 static inline void get_idt(struct descriptor_table *table)
 487 {
 488         asm ("sidt %0" : "=m"(*table));
 489 }
 490
 491 static inline void get_gdt(struct descriptor_table *table)
 492 {
 493         asm ("sgdt %0" : "=m"(*table));
 494 }
 495
 496 static inline unsigned long read_tr_base(void)
 497 {
 498         u16 tr;
 499         asm ("str %0" : "=g"(tr));
 500         return segment_base(tr);
 501 }
 502
 503 #ifdef CONFIG_X86_64
 504 static inline unsigned long read_msr(unsigned long msr)
 505 {
 506         u64 value;
 507
 508         rdmsrl(msr, value);
 509         return value;
 510 }
 511 #endif
 512
 513 static inline void fx_save(void *image)
 514 {
 515         asm ("fxsave (%0)":: "r" (image));
 516 }
 517
 518 static inline void fx_restore(void *image)
 519 {
 520         asm ("fxrstor (%0)":: "r" (image));
 521 }
 522
 523 static inline void fpu_init(void)
 524 {
 525         asm ("finit");
 526 }
 527
 528 static inline u32 get_rdx_init_val(void)
 529 {
 530         return 0x600; /* P6 family */
 531 }
 532
 533 #define ASM_VMX_VMCLEAR_RAX       ".byte 0x66, 0x0f, 0xc7, 0x30"
 534 #define ASM_VMX_VMLAUNCH          ".byte 0x0f, 0x01, 0xc2"
 535 #define ASM_VMX_VMRESUME          ".byte 0x0f, 0x01, 0xc3"
 536 #define ASM_VMX_VMPTRLD_RAX       ".byte 0x0f, 0xc7, 0x30"
 537 #define ASM_VMX_VMREAD_RDX_RAX    ".byte 0x0f, 0x78, 0xd0"
 538 #define ASM_VMX_VMWRITE_RAX_RDX   ".byte 0x0f, 0x79, 0xd0"
 539 #define ASM_VMX_VMWRITE_RSP_RDX   ".byte 0x0f, 0x79, 0xd4"
 540 #define ASM_VMX_VMXOFF            ".byte 0x0f, 0x01, 0xc4"
 541 #define ASM_VMX_VMXON_RAX         ".byte 0xf3, 0x0f, 0xc7, 0x30"
 542
 543 #define MSR_IA32_TIME_STAMP_COUNTER             0x010
 544
 545 #define TSS_IOPB_BASE_OFFSET 0x66
 546 #define TSS_BASE_SIZE 0x68
 547 #define TSS_IOPB_SIZE (65536 / 8)
 548 #define TSS_REDIRECTION_SIZE (256 / 8)
 549 #define RMODE_TSS_SIZE (TSS_BASE_SIZE + TSS_REDIRECTION_SIZE + TSS_IOPB_SIZE + 1)
 550
 551 #ifdef CONFIG_X86_64
 552
 553 /*
 554  * When emulating 32-bit mode, cr3 is only 32 bits even on x86_64.  Therefore
 555  * we need to allocate shadow page tables in the first 4GB of memory, which
 556  * happens to fit the DMA32 zone.
 557  */
 558 #define GFP_KVM_MMU (GFP_KERNEL | __GFP_DMA32)
 559
 560 #else
 561
 562 #define GFP_KVM_MMU GFP_KERNEL
 563
 564 #endif
 565
 566 #endif