sys/platform/pc64/include/pmap.h

   1 /*
   2  * Copyright (c) 1991 Regents of the University of California.
   3  * Copyright (c) 2003 Peter Wemm.
   4  * Copyright (c) 2008 The DragonFly Project.
   5  * All rights reserved.
   6  *
   7  * This code is derived from software contributed to Berkeley by
   8  * the Systems Programming Group of the University of Utah Computer
   9  * Science Department and William Jolitz of UUNET Technologies Inc.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions and the following disclaimer.
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in the
  18  *    documentation and/or other materials provided with the distribution.
  19  * 3. Neither the name of the University nor the names of its contributors
  20  *    may be used to endorse or promote products derived from this software
  21  *    without specific prior written permission.
  22  *
  23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33  * SUCH DAMAGE.
  34  *
  35  * Derived from hp300 version by Mike Hibler, this version by William
  36  * Jolitz uses a recursive map [a pde points to the page directory] to
  37  * map the page tables using the pagetables themselves. This is done to
  38  * reduce the impact on kernel virtual memory for lots of sparse address
  39  * space, and to reduce the cost of memory to each process.
  40  *
  41  * from: hp300: @(#)pmap.h      7.2 (Berkeley) 12/16/90
  42  * from: @(#)pmap.h     7.4 (Berkeley) 5/12/91
  43  * $FreeBSD: src/sys/i386/include/pmap.h,v 1.65.2.3 2001/10/03 07:15:37 peter Exp $
  44  */
  45
  46 #ifndef _MACHINE_PMAP_H_
  47 #define _MACHINE_PMAP_H_
  48
  49 #include <cpu/pmap.h>
  50
  51 /*
  52  * Pte related macros.  This is complicated by having to deal with
  53  * the sign extension of the 48th bit.
  54  */
  55 #define KVADDR(l4, l3, l2, l1) ( \
  56         ((unsigned long)-1 << 47) | \
  57         ((unsigned long)(l4) << PML4SHIFT) | \
  58         ((unsigned long)(l3) << PDPSHIFT) | \
  59         ((unsigned long)(l2) << PDRSHIFT) | \
  60         ((unsigned long)(l1) << PAGE_SHIFT))
  61
  62 #define UVADDR(l4, l3, l2, l1) ( \
  63         ((unsigned long)(l4) << PML4SHIFT) | \
  64         ((unsigned long)(l3) << PDPSHIFT) | \
  65         ((unsigned long)(l2) << PDRSHIFT) | \
  66         ((unsigned long)(l1) << PAGE_SHIFT))
  67
  68 /*
  69  * NKPML4E is the number of PML4E slots used for KVM.  Each slot represents
  70  * 512GB of KVM.  A number between 1 and 128 may be specified.  To support
  71  * the maximum machine configuration of 64TB we recommend around
  72  * 16 slots (8TB of KVM).
  73  *
  74  * NOTE: We no longer hardwire NKPT, it is calculated in create_pagetables()
  75  */
  76 #define NKPML4E         16
  77 /* NKPDPE defined in vmparam.h */
  78
  79 /*
  80  * NUPDPs       512 (256 user)          number of PDPs in user page table
  81  * NUPDs        512 * 512               number of PDs in user page table
  82  * NUPTs        512 * 512 * 512         number of PTs in user page table
  83  * NUPTEs       512 * 512 * 512 * 512   number of PTEs in user page table
  84  *
  85  * NUPDP_USER   number of PDPs reserved for userland
  86  * NUPTE_USER   number of PTEs reserved for userland (big number)
  87  */
  88 #define NUPDP_USER      (NPML4EPG/2)
  89 #define NUPDP_TOTAL     (NPML4EPG)
  90 #define NUPD_TOTAL      (NPDPEPG * NUPDP_TOTAL)
  91 #define NUPT_TOTAL      (NPDEPG * NUPD_TOTAL)
  92 #define NUPTE_TOTAL     ((vm_pindex_t)NPTEPG * NUPT_TOTAL)
  93 #define NUPTE_USER      ((vm_pindex_t)NPTEPG * NPDEPG * NPDPEPG * NUPDP_USER)
  94
  95 /*
  96  * Number of 512G DMAP PML4 slots.  There are 512 slots of which 256 are
  97  * used by the kernel.  Of those 256 we allow up to 128 to be used by the
  98  * DMAP (for 64TB of RAM), leaving 128 for the kernel and other incidentals.
  99  */
 100 #define NDMPML4E        128
 101
 102 /*
 103  * The *PML4I values control the layout of virtual memory.  Each PML4
 104  * entry represents 512G.
 105  */
 106 #define PML4PML4I       (NPML4EPG/2)    /* Index of recursive PML4 mapping */
 107
 108 #define KPML4I          (NPML4EPG-NKPML4E) /* Start of KVM */
 109 #define DMPML4I         (KPML4I-NDMPML4E) /* Next N*512GB down for DMAP */
 110
 111 /*
 112  * Make sure the kernel map and DMAP don't overflow the 256 PDP entries
 113  * we have available.  Minus one for the PML4PML4I.
 114  */
 115 #if NKPML4E + NDMPML4E >= 255
 116 #error "NKPML4E or NDMPML4E is too large"
 117 #endif
 118
 119 /*
 120  * The location of KERNBASE in the last PD of the kernel's KVM (KPML4I)
 121  * space.  Each PD represents 1GB.  The kernel must be placed here
 122  * for the compile/link options to work properly so absolute 32-bit
 123  * addressing can be used to access stuff.
 124  */
 125 #define KPDPI           (NPDPEPG-2)     /* kernbase at -2GB */
 126
 127 /*
 128  * per-CPU data assume ~64K x SMP_MAXCPU, say up to 256 cpus
 129  * in the future or 16MB of space.  Each PD represents 2MB so
 130  * use NPDEPG-8 to place the per-CPU data.
 131  */
 132 #define MPPML4I         (KPML4I + NKPML4E - 1)
 133 #define MPPDPI          KPDPI
 134 #define MPPTDI          (NPDEPG-8)
 135
 136 /*
 137  * XXX doesn't really belong here I guess...
 138  */
 139 #define ISA_HOLE_START  0xa0000
 140 #define ISA_HOLE_LENGTH (0x100000-ISA_HOLE_START)
 141
 142 #ifndef LOCORE
 143
 144 #ifndef _SYS_TYPES_H_
 145 #include <sys/types.h>
 146 #endif
 147 #ifndef _SYS_CPUMASK_H_
 148 #include <sys/cpumask.h>
 149 #endif
 150 #ifndef _SYS_QUEUE_H_
 151 #include <sys/queue.h>
 152 #endif
 153 #ifndef _SYS_TREE_H_
 154 #include <sys/tree.h>
 155 #endif
 156 #ifndef _SYS_SPINLOCK_H_
 157 #include <sys/spinlock.h>
 158 #endif
 159 #ifndef _SYS_THREAD_H_
 160 #include <sys/thread.h>
 161 #endif
 162 #ifndef _MACHINE_TYPES_H_
 163 #include <machine/types.h>
 164 #endif
 165 #ifndef _MACHINE_PARAM_H_
 166 #include <machine/param.h>
 167 #endif
 168
 169 /*
 170  * Address of current and alternate address space page table maps
 171  * and directories.
 172  */
 173 #ifdef _KERNEL
 174 #define addr_PTmap      (KVADDR(PML4PML4I, 0, 0, 0))
 175 #define addr_PDmap      (KVADDR(PML4PML4I, PML4PML4I, 0, 0))
 176 #define addr_PDPmap     (KVADDR(PML4PML4I, PML4PML4I, PML4PML4I, 0))
 177 #define addr_PML4map    (KVADDR(PML4PML4I, PML4PML4I, PML4PML4I, PML4PML4I))
 178 #define addr_PML4pml4e  (addr_PML4map + (PML4PML4I * sizeof(pml4_entry_t)))
 179 #define PTmap           ((pt_entry_t *)(addr_PTmap))
 180 #define PDmap           ((pd_entry_t *)(addr_PDmap))
 181 #define PDPmap          ((pd_entry_t *)(addr_PDPmap))
 182 #define PML4map         ((pd_entry_t *)(addr_PML4map))
 183 #define PML4pml4e       ((pd_entry_t *)(addr_PML4pml4e))
 184
 185 extern uint64_t KPDPphys;       /* phys addr of kernel level 3 */
 186 extern uint64_t KPML4phys;      /* physical address of kernel level 4 */
 187 #endif
 188
 189 /*
 190  * Pmap stuff
 191  */
 192 struct pmap;
 193 struct pv_entry;
 194 struct vm_page;
 195 struct vm_object;
 196 struct vmspace;
 197
 198 /*
 199  * vm_page structure extension for pmap.  Track the number of pmap mappings
 200  * for a managed page.  Unmanaged pages do not use this field.
 201  */
 202 struct md_page {
 203         long interlock_count;
 204         long writeable_count_unused;
 205 };
 206
 207 #define MD_PAGE_FREEABLE(m)     \
 208         (((m)->flags & (PG_MAPPED | PG_WRITEABLE)) == 0)
 209
 210 /*
 211  * vm_object's representing large mappings can contain embedded pmaps
 212  * to organize sharing at higher page table levels for PROT_READ and
 213  * PROT_READ|PROT_WRITE maps.
 214  */
 215 struct md_object {
 216         void *dummy_unused;
 217 };
 218
 219 /*
 220  * Each machine dependent implementation is expected to
 221  * keep certain statistics.  They may do this anyway they
 222  * so choose, but are expected to return the statistics
 223  * in the following structure.
 224  *
 225  * NOTE: We try to match the size of the pc32 pmap with the vkernel pmap
 226  * so the same utilities (like 'ps') can be used on both.
 227  */
 228 struct pmap_statistics {
 229         long resident_count;    /* # of pages mapped (total) */
 230         long wired_count;       /* # of pages wired */
 231 };
 232 typedef struct pmap_statistics *pmap_statistics_t;
 233
 234 struct pv_entry_rb_tree;
 235 RB_PROTOTYPE2(pv_entry_rb_tree, pv_entry, pv_entry,
 236               pv_entry_compare, vm_pindex_t);
 237
 238 /* Types of pmap */
 239 #define REGULAR_PMAP            0       /* Regular x86 */
 240 #define EPT_PMAP                1       /* Intel EPT */
 241 #define NPT_PMAP                2       /* AMD NPT/RVI */
 242
 243 /* Bits indexes in pmap_bits */
 244 enum {
 245         TYPE_IDX = 0,           /* Pmap type */
 246         PG_V_IDX,               /* Valid */
 247         PG_RW_IDX,              /* Read/Write */
 248         PG_U_IDX,               /* User/Supervisor */
 249         PG_A_IDX,               /* Accessed */
 250         PG_M_IDX,               /* Modified/Dirty */
 251         PG_PS_IDX,              /* Page size */
 252         PG_G_IDX,               /* Global */
 253         PG_W_IDX,               /* Wired */
 254         PG_MANAGED_IDX,         /* Managed */
 255         PG_N_IDX,               /* Non-cacheable */
 256         PG_NX_IDX,              /* Non-execute */
 257         PG_BITS_SIZE,
 258 };
 259
 260 #define PROTECTION_CODES_SIZE   8
 261 #define PAT_INDEX_SIZE          8
 262
 263 #define PM_PLACEMARKS           64              /* 16 @ 4 zones */
 264 #define PM_NOPLACEMARK          ((vm_pindex_t)-1)
 265 #define PM_PLACEMARK_WAKEUP     ((vm_pindex_t)0x8000000000000000LLU)
 266
 267 struct pmap {
 268         pml4_entry_t            *pm_pml4;       /* KVA of level 4 page table */
 269         pml4_entry_t            *pm_pml4_iso;   /* (isolated version) */
 270         struct pv_entry         *pm_pmlpv;      /* PV entry for pml4 */
 271         struct pv_entry         *pm_pmlpv_iso;  /* (isolated version) */
 272         TAILQ_ENTRY(pmap)       pm_pmnode;      /* list of pmaps */
 273         RB_HEAD(pv_entry_rb_tree, pv_entry) pm_pvroot;
 274         int                     pm_count;       /* reference count */
 275         cpulock_t               pm_active_lock; /* interlock */
 276         cpumask_t               pm_active;      /* active on cpus */
 277         int                     pm_flags;
 278         uint32_t                pm_softhold;
 279         struct pmap_statistics  pm_stats;       /* pmap statistics */
 280         struct spinlock         pm_spin;
 281         struct pv_entry         *pm_pvhint_pt;  /* pv_entry lookup hint */
 282         struct pv_entry         *pm_pvhint_unused;
 283         vm_pindex_t             pm_placemarks[PM_PLACEMARKS];
 284         uint64_t                pm_invgen;      /* pmap generation id */
 285         uint64_t                pmap_bits[PG_BITS_SIZE];
 286         uint64_t                protection_codes[PROTECTION_CODES_SIZE];
 287         pt_entry_t              pmap_cache_bits_pte[PAT_INDEX_SIZE];
 288         pt_entry_t              pmap_cache_bits_pde[PAT_INDEX_SIZE];
 289         pt_entry_t              pmap_cache_mask_pte;
 290         pt_entry_t              pmap_cache_mask_pde;
 291         int (*copyinstr)(const void *, void *, size_t, size_t *);
 292         int (*copyin)(const void *, void *, size_t);
 293         int (*copyout)(const void *, void *, size_t);
 294         int (*fubyte)(const uint8_t *);         /* returns int for -1 err */
 295         int (*subyte)(uint8_t *, uint8_t);
 296         int32_t (*fuword32)(const uint32_t *);
 297         int64_t (*fuword64)(const uint64_t *);
 298         int (*suword64)(uint64_t *, uint64_t);
 299         int (*suword32)(uint32_t *, int);
 300         uint32_t (*swapu32)(volatile uint32_t *, uint32_t v);
 301         uint64_t (*swapu64)(volatile uint64_t *, uint64_t v);
 302         uint32_t (*fuwordadd32)(volatile uint32_t *, uint32_t v);
 303         uint64_t (*fuwordadd64)(volatile uint64_t *, uint64_t v);
 304 };
 305
 306 #define PMAP_FLAG_SIMPLE        0x00000001
 307 #define PMAP_EMULATE_AD_BITS    0x00000002      /* emulate A/D bits for EPT */
 308 #define PMAP_HVM                0x00000004      /* hardware virtual machine */
 309 #define PMAP_SEGSHARED          0x00000008      /* segment shared opt */
 310 #define PMAP_MULTI              0x00000010      /* multi-threaded use */
 311
 312 #define pmap_resident_count(pmap)       \
 313         ((pmap)->pm_stats.resident_count)
 314 #define pmap_resident_tlnw_count(pmap)  \
 315         ((pmap)->pm_stats.resident_count - (pmap)->pm_stats.wired_count)
 316
 317 typedef struct pmap     *pmap_t;
 318
 319 #ifdef _KERNEL
 320 extern struct pmap      *kernel_pmap;
 321 #endif
 322
 323 /*
 324  * The pv_entry structure is used to track higher levels of the page table.
 325  * The leaf PTE is no longer tracked with this structure.
 326  */
 327 typedef struct pv_entry {
 328         pmap_t          pv_pmap;        /* pmap where mapping lies */
 329         vm_pindex_t     pv_pindex;      /* PTE, PT, PD, PDP, or PML4 */
 330         RB_ENTRY(pv_entry) pv_entry;
 331         struct vm_page  *pv_m;          /* page being mapped */
 332         u_int           pv_hold;        /* interlock action */
 333         u_int           pv_flags;
 334 #ifdef PMAP_DEBUG
 335         const char      *pv_func;
 336         int             pv_line;
 337         const char      *pv_func_lastfree;
 338         int             pv_line_lastfree;
 339 #endif
 340 } *pv_entry_t;
 341
 342 #define PV_HOLD_LOCKED          0x80000000U
 343 #define PV_HOLD_WAITING         0x40000000U
 344 #define PV_HOLD_UNUSED2000      0x20000000U
 345 #define PV_HOLD_MASK            0x1FFFFFFFU
 346
 347 #define PV_FLAG_UNUSED01        0x00000001U
 348 #define PV_FLAG_UNUSED02        0x00000002U
 349
 350 #ifdef  _KERNEL
 351
 352 extern caddr_t CADDR1;
 353 extern pt_entry_t *CMAP1;
 354 extern vm_paddr_t avail_end;
 355 extern vm_paddr_t avail_start;
 356 extern vm_offset_t clean_eva;
 357 extern vm_offset_t clean_sva;
 358 extern char *ptvmmap;           /* poor name! */
 359
 360 #ifndef __VM_PAGE_T_DEFINED__
 361 #define __VM_PAGE_T_DEFINED__
 362 typedef struct vm_page *vm_page_t;
 363 #endif
 364 #ifndef __VM_MEMATTR_T_DEFINED__
 365 #define __VM_MEMATTR_T_DEFINED__
 366 typedef char vm_memattr_t;
 367 #endif
 368
 369 void    pmap_release(struct pmap *pmap);
 370 void    pmap_interlock_wait (struct vmspace *);
 371 void    pmap_bootstrap (vm_paddr_t *);
 372 void    *pmap_mapbios(vm_paddr_t, vm_size_t);
 373 void    *pmap_mapdev (vm_paddr_t, vm_size_t);
 374 void    *pmap_mapdev_attr(vm_paddr_t, vm_size_t, int);
 375 void    *pmap_mapdev_uncacheable(vm_paddr_t, vm_size_t);
 376 void    pmap_page_set_memattr(vm_page_t m, vm_memattr_t ma);
 377 void    pmap_unmapdev (vm_offset_t, vm_size_t);
 378 struct vm_page *pmap_use_pt (pmap_t, vm_offset_t);
 379 void    pmap_set_opt (void);
 380 void    pmap_init_pat(void);
 381 void    pmap_invalidate_cache_pages(vm_page_t *pages, int count);
 382 void    pmap_invalidate_cache_range(vm_offset_t sva, vm_offset_t eva);
 383
 384 static __inline int
 385 pmap_emulate_ad_bits(pmap_t pmap) {
 386         return pmap->pm_flags & PMAP_EMULATE_AD_BITS;
 387 }
 388
 389 #endif /* _KERNEL */
 390
 391 #endif /* !LOCORE */
 392
 393 #endif /* !_MACHINE_PMAP_H_ */