Enabling X2APIC
[akaros.git] / kern / arch / x86 / ros / mmu64.h
1 #pragma once
2
3 #ifndef ROS_INC_ARCH_MMU_H
4 #error "Do not include include ros/arch/mmu64.h directly"
5 #endif
6
7 #ifndef __ASSEMBLER__
8 #include <ros/common.h>
9 typedef unsigned long kpte_t;
10 typedef unsigned long epte_t;
11
12 typedef kpte_t* pte_t;
13
14 typedef struct x86_pgdir {
15         kpte_t  *kpte;
16         uint64_t eptp;
17 } pgdir_t;
18 #endif
19
20 /* Virtual memory map:                                  Virt Addresses
21  *                                                      perms: kernel/user
22  *
23  *                     +------------------------------+ 0xffffffffffffffff -+
24  *                     |                              |                     |
25  *                     |   Mapped to lowmem, unused   | RW/--               |
26  *                     |                              |                     |
27  *  "end" symbol  -->  +------------------------------+        PML3_PTE_REACH
28  *                     |                              |                     |
29  *                     |  Kernel link/load location   |                     |
30  *                     |    (mapped to 0, physical)   |                     |
31  *                     |                              |                     |
32  * KERN_LOAD_ADDR -->  +------------------------------+ 0xffffffffc0000000 -+
33  *                     |                              |
34  *                     |            IOAPIC            | RW/--  APIC_SIZE (1MB)
35  *                     |                              |
36  *   IOAPIC_BASE  -->  +------------------------------+ 0xffffffffbff00000
37  *                     |                              |
38  *                     |                              | RW/--  APIC_SIZE (1MB)
39  *                     |                              |
40  *   KERN_DYN_TOP -->  +------------------------------+ 0xffffffffbfe00000
41  *                     |   Kernel Dynamic Mappings    |
42  *                     |              .               |
43  *                     :              .               :
44  *                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ RW/--
45  *                     :                              :
46  *                     |          Unmapped            | --/--
47  *                     |                              |
48  *                     |  Kernel static linking limit |
49  *                     +------------------------------+ 0xffffffff80000000
50  *                     |                              |
51  *                     |                              |
52  *                     |                              |
53  *  VPT_TOP    ----->  +------------------------------+ 0xffffff0000000000 -+
54  *                     |                              |                     |
55  *                     |                              |                     |
56  *                     |  Cur. Page Table (Kern. RW)  | RW/--  P4ML_PTE_REACH
57  *                     |                              |                     |
58  *                     |                              |                     |
59  *    VPT,     ----->  +------------------------------+ 0xfffffe8000000000 -+
60  *  KERN_VMAP_TOP      |                              |
61  *                     :              .               :
62  *                     :              .               :
63  *                     :              .               :
64  *                     |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~| RW/--
65  *                     |                              | RW/--
66  *                     |                              | RW/--
67  *                     |                              | RW/--
68  *                     |   Remapped Physical Memory   | RW/--
69  *                     |                              | RW/--
70  *                     |                              | RW/--
71  *                     |                              | RW/--
72  *    KERNBASE  ---->  +------------------------------+ 0xffff800000000000
73  *                     |                              |
74  *                     |                              |
75  *                     |                              |
76  *                     |   Non-canonical addresses    |
77  *                     |         (unusable)           |
78  *                     |                              |
79  *                     |                              |
80  * ULIM (not canon) -> +------------------------------+ 0x0000800000000000 -+
81  *                     +     Highest user address     + 0x00007fffffffffff  |
82  *                     |                              |                     |
83  *                     |  Cur. Page Table (User R-)   | R-/R-  PML4_PTE_REACH
84  *                     |                              |                     |
85  *    UVPT      ---->  +------------------------------+ 0x00007f8000000000 -+
86  *                     | Unmapped (expandable region) |                     |
87  *                     |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|                     |
88  *                     |     Per-Process R/O Info     | R-/R-  PML2_PTE_REACH
89  *                     |         (procinfo)           |                     |
90  * UWLIM, UINFO ---->  +------------------------------+ 0x00007f7fffe00000 -+
91  *                     | Unmapped (expandable region) |                     |
92  *                     |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|                     |
93  *                     |     Per-Process R/W Data     | RW/RW  PML2_PTE_REACH
94  *                     |         (procdata)           |                     |
95  *    UDATA     ---->  +------------------------------+ 0x00007f7fffc00000 -+
96  *                     |                              |
97  *                     |    Global Shared R/W Data    | RW/RW  PGSIZE
98  *                     |                              |
99  * UMAPTOP, UGDATA ->  +------------------------------+ 0x00007f7fffbff000
100  *    USTACKTOP        |                              |
101  *                     |      Normal User Stack       | RW/RW 256 * PGSIZE
102  *                     |                              |
103  *                     +------------------------------+ 0x00007f7fffaff000
104  *                     |                              |
105  *                     |        Empty Memory          |
106  *                     |                              |
107  *                     .                              .
108  *                     .                              .
109  *    BRK_END   ---->  +------------------------------+ 0x0000400000000000
110  *                     .                              .
111  *                     .                              .
112  *                     |                              |
113  *                     |        Empty Memory          |
114  *                     |                              |
115  *                     |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
116  *                     |                              |
117  *                     |     Program Data & Heap      |
118  *                     |                              |
119  *                     +------------------------------+ 0x0000000000400000
120  *                     .                              .
121  *                     .                              .
122  *                     |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
123  *                     |                              |
124  *                     |       ld.so (Dynamic)        |
125  *                     |                              |
126  * MMAP_LD_FIXED_VA    +------------------------------+ 0x0000000000100000
127  *                     |                              |
128  *                     |                              |
129  *                     |                              |
130  * MMAP_LOWEST_VA      +------------------------------+ 0x0000000000001000
131  *                     |                              |
132  *                     |       Empty Memory (*)       |
133  *                     |                              |
134  *                     +------------------------------+ 0x0000000000000000
135  */
136
137 /* Physical Mapping symbols:
138  * At IOPHYSMEM (640K) there is a 384K hole for I/O.  From the kernel,
139  * IOPHYSMEM can be addressed at KERNBASE + IOPHYSMEM.  The hole ends
140  * at physical address EXTPHYSMEM. */
141 #define IOPHYSMEM               0x0A0000
142 #define VGAPHYSMEM              0x0A0000
143 #define DEVPHYSMEM              0x0C0000
144 #define BIOSPHYSMEM             0x0F0000
145 #define EXTPHYSMEM              0x100000
146
147 /* Kernel Virtual Memory Mapping */
148
149 /* The kernel needs to be loaded in the top 2 GB of memory, since we compile it
150  * with -mcmodel=kernel (helps with relocations).  We're actually loading it in
151  * the top 1 GB. */
152 #define KERN_LOAD_ADDR  0xffffffffc0000000
153 /* Static kernel mappings */
154 #define APIC_SIZE               0x100000
155 #define IOAPIC_BASE             (KERN_LOAD_ADDR - APIC_SIZE)
156 /* All arches must define this, which is the lower limit of their static
157  * mappings, and where the dynamic mappings will start. */
158 #define KERN_DYN_TOP    IOAPIC_BASE
159
160 /* Virtual page table.  Every PML4 has a PTE at the slot (PML4(VPT))
161  * corresponding to VPT that points to that PML4's base.  In essence, the 512
162  * GB chunk of the VA space from VPT..VPT_TOP is a window into the paging
163  * structure.
164  *
165  * The VPT needs to be aligned on 39 bits.
166  *
167  * Ex: Say the VPT's entry in 9 bits is "9v".  If you construct a VA from:
168  * 9v9v9v9v000, the paging hardware will recurse 4 times, with the end result
169  * being the PML4.  That virtual address will map to the PML4 itself.
170  *
171  * If you want to see a specific PML3, figure out which entry it is in the
172  * PML4 (using PML3(va)), say 9 bits = "9X".  The VA 9v9v9v9X000 will map to
173  * that PML3. */
174 #define VPT_TOP                 0xffffff0000000000
175 #define VPT                             (VPT_TOP - PML4_PTE_REACH)
176 /* Helper to return the current outer pgdir via the VPT mapping. */
177 #define VPD (VPT + ((VPT & 0x0000ffffffffffff) >> 9) +                         \
178                    ((VPT & 0x0000ffffffffffff) >> 18) +                        \
179                    ((VPT & 0x0000ffffffffffff) >> 27))
180 #define vpd VPD
181
182 /* Top of the kernel virtual mapping area (KERNBASE) */
183 #define KERN_VMAP_TOP   (VPT)
184 /* Base of the physical memory map. This maps from 0 physical to max_paddr */
185 #define KERNBASE        0xffff800000000000
186
187 /* Highest user address: 0x00007fffffffffff: 1 zero, 47 ones, sign extended.
188  * From here down to UWLIM is User Read-only */
189 #define ULIM            0x0000800000000000
190 /* Same as VPT but read-only for users */
191 #define UVPT                    (ULIM - PML4_PTE_REACH)
192 /* Arbitrary boundary between the break and the start of
193  * memory returned by calls to mmap with addr = 0 */
194 #define BRK_END                 0x0000400000000000
195
196 /* **************************************** */
197 /* Page table constants, macros, etc */
198
199 /* A linear address 'la' has a five-part structure as follows:
200  *
201  * +-----9------+-----9------+-----9------+-----9------+---------12----------+
202  * | PML4 bits  | PML3 bits  | PML2 bits  | PML1 bits  |     Page offset     |
203  * |   offset   |   offset   |   offset   |   offset   |                     |
204  * +------------+------------+------------+------------+---------------------+
205  *  \ PML4(la) / \ PML3(la) / \ PML2(la) / \ PML1(la) / \---- PGOFF(la) ----/
206  *  \------------------ LA2PPN(la) -------------------/
207  *
208  * The PMLx, PGOFF, and LA2PPN macros decompose linear addresses as shown.
209  * To construct a linear address la from these, use:
210  * PGADDR(PML4(la), PML3(la), PML2(la), PML1(la), PGOFF(la)).
211  * Careful, that's arch- and bit-specific.
212  *
213  * I'd somewhat like it if we started counting from the outer-most PT, though
214  * amd coined the term PML4 for the outermost, instead of PML1.  Incidentally,
215  * they also don't use numbers other than PML4, sticking with names like PDP. */
216
217 #define PML4_SHIFT              39
218 #define PML3_SHIFT              30
219 #define PML2_SHIFT              21
220 #define PML1_SHIFT              12
221 #define BITS_PER_PML    9
222
223 /* PTE reach is the amount of VM an entry can map, either as a jumbo or as
224  * further page tables.  I'd like to write these as shifts, but I can't please
225  * both the compiler and the assembler. */
226 #define PML4_PTE_REACH  (0x0000008000000000)    /* No jumbos available */
227 #define PML3_PTE_REACH  (0x0000000040000000)    /* 1 GB jumbos available */
228 #define PML2_PTE_REACH  (0x0000000000200000)    /* 2 MB jumbos available */
229 #define PML1_PTE_REACH  (0x0000000000001000)    /* aka, PGSIZE */
230
231 /* Reach is the amount of VM a table can map, counting all of its entries.
232  * Note that a PML(n)_PTE is a PML(n-1) table. */
233 #define PML3_REACH              (PML4_PTE_REACH)
234 #define PML2_REACH              (PML3_PTE_REACH)
235 #define PML1_REACH              (PML2_PTE_REACH)
236
237 /* PMLx(la, shift) gives the 9 bits specifying the la's entry in the PML
238  * corresponding to shift.  PMLn(la) gives the 9 bits for PML4, etc. */
239 #define PMLx(la, shift) (((uintptr_t)(la) >> (shift)) & 0x1ff)
240 #define PML4(la)                PMLx(la, PML4_SHIFT)
241 #define PML3(la)                PMLx(la, PML3_SHIFT)
242 #define PML2(la)                PMLx(la, PML2_SHIFT)
243 #define PML1(la)                PMLx(la, PML1_SHIFT)
244
245 /* Common kernel helpers */
246 #define PGSHIFT                 PML1_SHIFT
247 #define PGSIZE                  PML1_PTE_REACH
248 #define LA2PPN(la)              ((uintptr_t)(la) >> PGSHIFT)
249 #define PTE2PPN(pte)    LA2PPN(pte)
250 #define PGOFF(la)               ((uintptr_t)(la) & (PGSIZE - 1))
251 #define NPTENTRIES              512
252
253 /* This is used in places (procinfo) meaning "size of smallest jumbo page" */
254 #define PTSIZE PML2_PTE_REACH
255
256 /* Page table/directory entry flags. */
257
258 /* Some things to be careful of:  Global and PAT only apply to the last PTE in
259  * a chain: so either a PTE in PML1, or a Jumbo PTE in PML2 or 3.  When PAT
260  * applies, which bit we use depends on whether we are jumbo or not.  For PML1,
261  * PAT is bit 8.  For jumbo PTEs (and only when they are for a jumbo page), we
262  * use bit 12. */
263 #define PTE_P                   0x001   /* Present */
264 #define PTE_W                   0x002   /* Writeable */
265 #define PTE_U                   0x004   /* User */
266 #define PTE_PWT                 0x008   /* Write-Through */
267 #define PTE_PCD                 0x010   /* Cache-Disable */
268 #define PTE_A                   0x020   /* Accessed */
269 #define PTE_D                   0x040   /* Dirty */
270 #define PTE_PS                  0x080   /* Page Size */
271 #define PTE_PAT                 0x080   /* Page attribute table */
272 #define PTE_G                   0x100   /* Global Page */
273 #define PTE_JPAT                0x800   /* Jumbo PAT */
274 #define PTE_NOCACHE             (PTE_PWT | PTE_PCD)
275
276 /* Permissions fields and common access modes.  These should be read as 'just
277  * kernel or user too' and 'RO or RW'.  USER_RO means read-only for everyone. */
278 #define PTE_PERM                (PTE_W | PTE_U | PTE_P)
279 #define PTE_KERN_RW             (PTE_W | PTE_P)
280 #define PTE_KERN_RO             PTE_P
281 #define PTE_USER_RW             (PTE_W | PTE_U | PTE_P)
282 #define PTE_USER_RO             (PTE_U | PTE_P)
283 #define PTE_NONE                0
284
285 /* The PTE/translation part of a PTE/virtual(linear) address.  It's used
286  * frequently to be the page address of a virtual address.  Note this doesn't
287  * work on jumbo PTEs due to the reserved bits.  Jumbo's don't have a PTE_ADDR
288  * in them - just a base address of wherever they point. */
289 #define PTE_ADDR(pte)   ((physaddr_t) (pte) & ~(PGSIZE - 1))
290 /* More meaningful macro, same as PTE_ADDR */
291 #define PG_ADDR(la)     ((uintptr_t)(la) & ~(PGSIZE - 1))
292
293 /* we must guarantee that for any PTE, exactly one of the following is true */
294 #define PAGE_PRESENT(pte) ((pte) & PTE_P)
295 #define PAGE_UNMAPPED(pte) ((pte) == 0)
296 #define PAGE_PAGED_OUT(pte) (0) /* Need to use an OS reserved PTE bit */
297
298
299 /* **************************************** */
300 /* Segmentation */
301
302 /* Global descriptor numbers */
303 #define GD_NULL                 0x00    /* NULL descriptor */
304 #define GD_KT                   0x08    /* kernel text */
305 #define GD_KD                   0x10    /* kernel data */
306 /* syscall/sysret wants UD before UT, but KT before KD.  it really wants UT32,
307  * UD, UT64.  anyways... */
308 #define GD_UD                   0x18    /* user data */
309 #define GD_UT                   0x20    /* user text */
310 #define GD_TSS                  0x28    /* Task segment selector */
311 #define GD_TSS2                 0x30    /* Placeholder, TSS is 2-descriptors wide */
312 /* These two aren't in the GDT yet (might never be) */
313 #define GD_LDT                  0x38    /* Local descriptor table */
314 #define GD_LDT2                 0x40    /* Placeholder */
315
316 #ifdef __ASSEMBLER__
317
318 /* Macros to build GDT entries in assembly. */
319 #define SEG_NULL                                                \
320         .word 0, 0;                                             \
321         .byte 0, 0, 0, 0
322
323 /* 64 bit code segment.  This is for long mode, no compatibility.  If we want
324  * to support 32 bit apps later, we'll want to adjust this. */
325 #define SEG_CODE_64(dpl)                                                    \
326         .word 0, 0;                                                             \
327         .byte 0;                                                                \
328         .byte (((1/*p*/) << 7) | ((dpl) << 5) | 0x18 | ((0/*c*/) << 2));        \
329         .byte (((0/*d*/) << 6) | ((1/*l*/) << 5));                              \
330         .byte 0;
331
332 /* 64 bit data segment.  These are pretty much completely ignored (except if we
333  * use them for fs/gs, or compatibility mode */
334 #define SEG_DATA_64(dpl)                                                    \
335         .word 0xffff, 0;                                                        \
336         .byte 0;                                                                \
337         .byte (0x92 | ((dpl) << 5));                                            \
338         .byte 0x8f;                                                             \
339         .byte 0;
340
341 /* System segments (TSS/LDT) are twice as long as usual (16 bytes). */
342 #define SEG_SYS_64(type, base, lim, dpl)                                       \
343         .word ((lim) & 0xffff);                                                    \
344         .word ((base) & 0xffff);                                                   \
345         .byte (((base) >> 16) & 0xff);                                             \
346         .byte ((1 << 7) | ((dpl) << 5) | (type));                                  \
347         .byte (((1/*g*/) << 7) | (((lim) >> 16) & 0xf));                           \
348         .byte (((base) >> 24) & 0xff);                                             \
349         .quad ((base) >> 32);                                                      \
350         .quad 0;
351
352 /* Default segment (32 bit style).  Would work for fs/gs, if needed */
353 #define SEG(type, base, lim)                                                \
354         .word (((lim) >> 12) & 0xffff);                                         \
355         .word ((base) & 0xffff);                                                \
356         .byte (((base) >> 16) & 0xff);                                          \
357         .byte (0x90 | (type));                                                  \
358         .byte (0xC0 | (((lim) >> 28) & 0xf));                                   \
359         .byte (((base) >> 24) & 0xff)
360
361 #else   // not __ASSEMBLER__
362
363 /* Legacy Segment Descriptor (used for 64 bit data and code) */
364 typedef struct Segdesc {
365         unsigned sd_lim_15_0 : 16;  // Low bits of segment limit
366         unsigned sd_base_15_0 : 16; // Low bits of segment base address
367         unsigned sd_base_23_16 : 8; // Middle bits of segment base address
368         unsigned sd_type : 4;       // Segment type (see STS_ constants)
369         unsigned sd_s : 1;          // 0 = system, 1 = application
370         unsigned sd_dpl : 2;        // Descriptor Privilege Level
371         unsigned sd_p : 1;          // Present
372         unsigned sd_lim_19_16 : 4;  // High bits of segment limit
373         unsigned sd_avl : 1;        // Unused (available for software use)
374         unsigned sd_rsv1 : 1;       // Reserved
375         unsigned sd_db : 1;         // 0 = 16-bit segment, 1 = 32-bit segment
376         unsigned sd_g : 1;          // Granularity: limit scaled by 4K when set
377         unsigned sd_base_31_24 : 8; // High bits of segment base address
378 } segdesc_t;
379
380 /* Lower half is similar (more ignored, etc)  to a legacy system descriptor */
381 struct x86_sysseg64 {
382         unsigned sd_lim_15_0 : 16;      /* Low bits of segment limit */
383         unsigned sd_base_15_0 : 16;     /* Low bits of segment base address */
384         unsigned sd_base_23_16 : 8;     /* Middle bits of segment base address */
385         unsigned sd_type : 4;           /* Segment type (see STS_ constants) */
386         unsigned sd_s : 1;                      /* 0 = system, 1 = application */
387         unsigned sd_dpl : 2;            /* Descriptor Privilege Level */
388         unsigned sd_p : 1;                      /* Present */
389         unsigned sd_lim_19_16 : 4;      /* High bits of segment limit */
390         unsigned sd_avl : 1;            /* Unused (available for software use) */
391         unsigned sd_rsv2 : 2;           /* Reserved */
392         unsigned sd_g : 1;                      /* Granularity: limit scaled by 4K when set */
393         unsigned sd_base_31_24 : 8;     /* 24-31 bits of segment base address */
394         unsigned sd_base_63_32;         /* top 32 bits of the base */
395         unsigned sd_reserved;           /* some parts must be zero, just zero it all */
396 };
397 typedef struct x86_sysseg64 syssegdesc_t;
398
399 /* G(ranularity) determines if the limit is shifted */
400 #define __SEG_SYS64(type, base, lim, dpl, g)                                   \
401 { ((lim) >> ((g) * 12)) & 0xffff, (base) & 0xffff, ((base) >> 16) & 0xff,      \
402     type, 0, dpl, 1, (unsigned) (lim) >> 28, 0, 0, (g),                        \
403     ((unsigned) (base) >> 24) & 0xff,                                          \
404     ((unsigned long) (base) >> 32), 0 }
405
406 /* Normal system segment descriptor (LDT or TSS). (limit is scaled by 4k) */
407 #define SEG_SYS64(type, base, lim, dpl)                                        \
408         __SEG_SYS64(type, base, lim, dpl, 1)
409
410 /* Smaller system segment descriptor (LDT or TSS). */
411 #define SEG_SYS64_SMALL(type, base, lim, dpl)                                  \
412         __SEG_SYS64(type, base, lim, dpl, 0)
413
414 #define SEG_SYS_SMALL(type, base, lim, dpl) \
415         SEG_SYS64_SMALL(type, base, lim, dpl)
416
417 /* 64 bit task state segment (AMD 2:12.2.5) */
418 typedef struct taskstate {
419         uint32_t                                        ts_rsv1;        /* reserved / ignored */
420         uint64_t                                        ts_rsp0;        /* stack ptr in ring 0 */
421         uint64_t                                        ts_rsp1;        /* stack ptr in ring 1 */
422         uint64_t                                        ts_rsp2;        /* stack ptr in ring 2 */
423         uint64_t                                        ts_rsv2;        /* reserved / ignored */
424         uint64_t                                        ts_ist1;        /* IST stacks: unconditional rsp */
425         uint64_t                                        ts_ist2;        /* check AMD 2:8.9.4 for info */
426         uint64_t                                        ts_ist3;
427         uint64_t                                        ts_ist4;
428         uint64_t                                        ts_ist5;
429         uint64_t                                        ts_ist6;
430         uint64_t                                        ts_ist7;
431         uint64_t                                        ts_rsv3;        /* reserved / ignored */
432         uint16_t                                        ts_rsv4;        /* reserved / ignored */
433         uint16_t                                        ts_iobm;        /* IO base map (offset) */
434 } __attribute__((packed)) taskstate_t;
435
436 /* 64 bit gate descriptors for interrupts and traps */
437 typedef struct Gatedesc {
438         unsigned gd_off_15_0 : 16;      /* low 16 bits of offset in segment */
439         unsigned gd_ss : 16;            /* segment selector */
440         unsigned gd_ist : 3;            /* interrupt stack table selector (0 = none) */
441         unsigned gd_rsv1 : 5;           /* ignored */
442         unsigned gd_type : 4;           /* type(STS_{TG,IG32,TG32}) */
443         unsigned gd_s : 1;                      /* must be 0 (system) */
444         unsigned gd_dpl : 2;            /* DPL - highest ring allowed to use this */
445         unsigned gd_p : 1;                      /* Present */
446         unsigned gd_off_31_16 : 16;     /* 16-31 bits of offset in segment */
447         unsigned gd_off_63_32;          /* top 32 bits of offset */
448         unsigned gd_rsv2;                       /* reserved / unsused */
449 } gatedesc_t;
450
451 /* Set up an IST-capable 64 bit interrupt/trap gate descriptor.  IST selects a
452  * stack pointer from the interrupt-stack table (in TSS) that will be loaded
453  * unconditionally when we hit this gate  - regardless of privelege change. */
454 #define SETGATE64(gate, istrap, sel, off, dpl, ist)                            \
455 {                                                                              \
456         (gate).gd_off_15_0 = (uintptr_t) (off) & 0xffff;                           \
457         (gate).gd_ss = (sel);                                                      \
458         (gate).gd_ist = (ist);                                                     \
459         (gate).gd_rsv1 = 0;                                                        \
460         (gate).gd_type = (istrap) ? STS_TG32 : STS_IG32;                           \
461         (gate).gd_s = 0;                                                           \
462         (gate).gd_dpl = (dpl);                                                     \
463         (gate).gd_p = 1;                                                           \
464         (gate).gd_off_31_16 = (uintptr_t) (off) >> 16;                             \
465         (gate).gd_off_63_32 = (uintptr_t) (off) >> 32;                             \
466         (gate).gd_rsv2 = 0;                                                        \
467 }
468
469 /* Set up a normal, 64 bit interrupt/trap gate descriptor.
470  * - istrap: 1 for a trap (= exception) gate, 0 for an interrupt gate.
471  *   - interrupt gates automatically disable interrupts (cli)
472  * - sel: Code segment selector for interrupt/trap handler
473  * - off: Offset in code segment for interrupt/trap handler (address)
474  * - dpl: Descriptor Privilege Level -
475  *        the privilege level required for software to invoke
476  *        this interrupt/trap gate explicitly using an int instruction. */
477 #define SETGATE(gate, istrap, sel, off, dpl)                                   \
478         SETGATE64(gate, istrap, sel, off, dpl, 0)
479
480 // Pseudo-descriptors used for LGDT, LLDT and LIDT instructions.
481 typedef struct Pseudodesc {
482         uint16_t pd_lim;                // Limit
483         uintptr_t pd_base;              // Base address
484 } __attribute__ ((packed)) pseudodesc_t;
485
486 #endif /* !__ASSEMBLER__ */
487
488 // Application segment type bits
489 #define STA_X           0x8         // Executable segment
490 #define STA_E           0x4         // Expand down (non-executable segments)
491 #define STA_C           0x4         // Conforming code segment (executable only)
492 #define STA_W           0x2         // Writeable (non-executable segments)
493 #define STA_R           0x2         // Readable (executable segments)
494 #define STA_A           0x1         // Accessed
495
496 /* System segment type bits.  All other types are reserved/illegal.  The '32' is
497  * mostly a legacy naming - the bits work for both 64 and 32. */
498 #define STS_LDT         0x2             /* 64-bit Local Descriptor Table  */
499 #define STS_T32A        0x9             /* Available 64-bit TSS */
500 #define STS_T32B        0xB             /* Busy 64-bit TSS */
501 #define STS_CG32        0xC             /* 64-bit Call Gate */
502 #define STS_IG32        0xE             /* 64-bit Interrupt Gate */
503 #define STS_TG32        0xF             /* 64-bit Trap Gate */
504
505 #define SEG_COUNT       7               /* Number of GDT segments */
506 /* TODO: Probably won't use this */
507 #define LDT_SIZE        (8192 * sizeof(segdesc_t))
508
509 /* TLS 'syscall', coupled to trapentry64.S.  Needed a non-canon 'addr' */
510 #define FASTCALL_SETFSBASE 0xf0f0000000000001