xref: /dragonfly/sys/platform/pc64/include/pmap.h (revision 9bbbdb7e3226d49e14a8b3e4974a01202d69aca2)
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
pmap_emulate_ad_bits(pmap_t pmap)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_ */
394