1/*-
2 * Copyright (c) 2014 Andrew Turner
3 * Copyright (c) 2014-2015 The FreeBSD Foundation
4 * All rights reserved.
5 *
6 * This software was developed by Andrew Turner under
7 * sponsorship from the FreeBSD Foundation.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 *    notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 *    notice, this list of conditions and the following disclaimer in the
16 *    documentation and/or other materials provided with the distribution.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * SUCH DAMAGE.
29 *
30 * $FreeBSD$
31 */
32
33#ifndef _MACHINE_PTE_H_
34#define _MACHINE_PTE_H_
35
36#ifndef LOCORE
37typedef	uint64_t	pd_entry_t;		/* page directory entry */
38typedef	uint64_t	pt_entry_t;		/* page table entry */
39#endif
40
41/* Block and Page attributes */
42/* TODO: Add the upper attributes */
43#define	ATTR_MASK_H	UINT64_C(0xfff0000000000000)
44#define	ATTR_MASK_L	UINT64_C(0x0000000000000fff)
45#define	ATTR_MASK	(ATTR_MASK_H | ATTR_MASK_L)
46/* Bits 58:55 are reserved for software */
47#define	ATTR_SW_DIRTY	(1UL << 56)
48#define	ATTR_UXN	(1UL << 54)
49#define	ATTR_PXN	(1UL << 53)
50#define	ATTR_XN		(ATTR_PXN | ATTR_UXN)
51#define	ATTR_CONTIGUOUS	(1UL << 52)
52#define	ATTR_DBM	(1UL << 51)
53#define	ATTR_nG		(1 << 11)
54#define	ATTR_AF		(1 << 10)
55#define	ATTR_SH(x)	((x) << 8)
56#define	 ATTR_SH_MASK	ATTR_SH(3)
57#define	 ATTR_SH_NS	0		/* Non-shareable */
58#define	 ATTR_SH_OS	2		/* Outer-shareable */
59#define	 ATTR_SH_IS	3		/* Inner-shareable */
60#define	ATTR_AP_RW_BIT	(1 << 7)
61#define	ATTR_AP(x)	((x) << 6)
62#define	 ATTR_AP_MASK	ATTR_AP(3)
63#define	 ATTR_AP_RW	(0 << 1)
64#define	 ATTR_AP_RO	(1 << 1)
65#define	 ATTR_AP_USER	(1 << 0)
66#define	ATTR_NS		(1 << 5)
67#define	ATTR_IDX(x)	((x) << 2)
68#define	ATTR_IDX_MASK	(7 << 2)
69
70#define	ATTR_DEFAULT	(ATTR_AF | ATTR_SH(ATTR_SH_IS))
71
72#define	ATTR_DESCR_MASK	3
73
74/* Level 0 table, 512GiB per entry */
75#define	L0_SHIFT	39
76#define	L0_SIZE		(1ul << L0_SHIFT)
77#define	L0_OFFSET	(L0_SIZE - 1ul)
78#define	L0_INVAL	0x0 /* An invalid address */
79	/* 0x1 Level 0 doesn't support block translation */
80	/* 0x2 also marks an invalid address */
81#define	L0_TABLE	0x3 /* A next-level table */
82
83/* Level 1 table, 1GiB per entry */
84#define	L1_SHIFT	30
85#define	L1_SIZE 	(1 << L1_SHIFT)
86#define	L1_OFFSET 	(L1_SIZE - 1)
87#define	L1_INVAL	L0_INVAL
88#define	L1_BLOCK	0x1
89#define	L1_TABLE	L0_TABLE
90
91/* Level 2 table, 2MiB per entry */
92#define	L2_SHIFT	21
93#define	L2_SIZE 	(1 << L2_SHIFT)
94#define	L2_OFFSET 	(L2_SIZE - 1)
95#define	L2_INVAL	L1_INVAL
96#define	L2_BLOCK	L1_BLOCK
97#define	L2_TABLE	L1_TABLE
98
99#define	L2_BLOCK_MASK	UINT64_C(0xffffffe00000)
100
101/* Level 3 table, 4KiB per entry */
102#define	L3_SHIFT	12
103#define	L3_SIZE 	(1 << L3_SHIFT)
104#define	L3_OFFSET 	(L3_SIZE - 1)
105#define	L3_SHIFT	12
106#define	L3_INVAL	0x0
107	/* 0x1 is reserved */
108	/* 0x2 also marks an invalid address */
109#define	L3_PAGE		0x3
110
111#define	L0_ENTRIES_SHIFT 9
112#define	L0_ENTRIES	(1 << L0_ENTRIES_SHIFT)
113#define	L0_ADDR_MASK	(L0_ENTRIES - 1)
114
115#define	Ln_ENTRIES_SHIFT 9
116#define	Ln_ENTRIES	(1 << Ln_ENTRIES_SHIFT)
117#define	Ln_ADDR_MASK	(Ln_ENTRIES - 1)
118#define	Ln_TABLE_MASK	((1 << 12) - 1)
119
120#define	pmap_l0_index(va)	(((va) >> L0_SHIFT) & L0_ADDR_MASK)
121#define	pmap_l1_index(va)	(((va) >> L1_SHIFT) & Ln_ADDR_MASK)
122#define	pmap_l2_index(va)	(((va) >> L2_SHIFT) & Ln_ADDR_MASK)
123#define	pmap_l3_index(va)	(((va) >> L3_SHIFT) & Ln_ADDR_MASK)
124
125#endif /* !_MACHINE_PTE_H_ */
126
127/* End of pte.h */
128