pmap.h revision 1.72
1/* $NetBSD: pmap.h,v 1.72 2008/12/09 20:45:44 pooka Exp $ */
2
3/*-
4 * Copyright (c) 1998, 1999, 2000, 2001, 2007 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9 * NASA Ames Research Center and by Chris G. Demetriou.
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 *
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
31 */
32
33/*
34 * Copyright (c) 1991, 1993
35 *	The Regents of the University of California.  All rights reserved.
36 *
37 * This code is derived from software contributed to Berkeley by
38 * the Systems Programming Group of the University of Utah Computer
39 * Science Department.
40 *
41 * Redistribution and use in source and binary forms, with or without
42 * modification, are permitted provided that the following conditions
43 * are met:
44 * 1. Redistributions of source code must retain the above copyright
45 *    notice, this list of conditions and the following disclaimer.
46 * 2. Redistributions in binary form must reproduce the above copyright
47 *    notice, this list of conditions and the following disclaimer in the
48 *    documentation and/or other materials provided with the distribution.
49 * 3. Neither the name of the University nor the names of its contributors
50 *    may be used to endorse or promote products derived from this software
51 *    without specific prior written permission.
52 *
53 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
54 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
55 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
56 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
57 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
58 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
59 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
60 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
61 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
62 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
63 * SUCH DAMAGE.
64 *
65 *	@(#)pmap.h	8.1 (Berkeley) 6/10/93
66 */
67
68/*
69 * Copyright (c) 1987 Carnegie-Mellon University
70 *
71 * This code is derived from software contributed to Berkeley by
72 * the Systems Programming Group of the University of Utah Computer
73 * Science Department.
74 *
75 * Redistribution and use in source and binary forms, with or without
76 * modification, are permitted provided that the following conditions
77 * are met:
78 * 1. Redistributions of source code must retain the above copyright
79 *    notice, this list of conditions and the following disclaimer.
80 * 2. Redistributions in binary form must reproduce the above copyright
81 *    notice, this list of conditions and the following disclaimer in the
82 *    documentation and/or other materials provided with the distribution.
83 * 3. All advertising materials mentioning features or use of this software
84 *    must display the following acknowledgement:
85 *	This product includes software developed by the University of
86 *	California, Berkeley and its contributors.
87 * 4. Neither the name of the University nor the names of its contributors
88 *    may be used to endorse or promote products derived from this software
89 *    without specific prior written permission.
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
92 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
94 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
95 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
96 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
97 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
98 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
99 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
100 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
101 * SUCH DAMAGE.
102 *
103 *	@(#)pmap.h	8.1 (Berkeley) 6/10/93
104 */
105
106#ifndef	_PMAP_MACHINE_
107#define	_PMAP_MACHINE_
108
109#if defined(_KERNEL_OPT)
110#include "opt_multiprocessor.h"
111#endif
112
113#include <sys/mutex.h>
114#include <sys/queue.h>
115
116#include <machine/pte.h>
117
118/*
119 * Machine-dependent virtual memory state.
120 *
121 * If we ever support processor numbers higher than 63, we'll have to
122 * rethink the CPU mask.
123 *
124 * Note pm_asn and pm_asngen are arrays allocated in pmap_create().
125 * Their size is based on the PCS count from the HWRPB, and indexed
126 * by processor ID (from `whami').
127 *
128 * The kernel pmap is a special case; it gets statically-allocated
129 * arrays which hold enough for ALPHA_MAXPROCS.
130 */
131struct pmap_asn_info {
132	unsigned int		pma_asn;	/* address space number */
133	unsigned long		pma_asngen;	/* ASN generation number */
134};
135
136struct pmap {
137	TAILQ_ENTRY(pmap)	pm_list;	/* list of all pmaps */
138	pt_entry_t		*pm_lev1map;	/* level 1 map */
139	int			pm_count;	/* pmap reference count */
140	kmutex_t		pm_lock;	/* lock on pmap */
141	struct pmap_statistics	pm_stats;	/* pmap statistics */
142	unsigned long		pm_cpus;	/* mask of CPUs using pmap */
143	unsigned long		pm_needisync;	/* mask of CPUs needing isync */
144	struct pmap_asn_info	pm_asni[1];	/* ASN information */
145			/*	variable length		*/
146};
147
148/*
149 * Compute the sizeof of a pmap structure.  Subtract one because one
150 * ASN info structure is already included in the pmap structure itself.
151 */
152#define	PMAP_SIZEOF(x)							\
153	(ALIGN(sizeof(struct pmap) +					\
154	       (sizeof(struct pmap_asn_info) * ((x) - 1))))
155
156#define	PMAP_ASN_RESERVED	0	/* reserved for Lev1map users */
157
158/*
159 * For each struct vm_page, there is a list of all currently valid virtual
160 * mappings of that page.  An entry is a pv_entry_t, the list is pv_table.
161 */
162typedef struct pv_entry {
163	struct pv_entry	*pv_next;	/* next pv_entry on list */
164	struct pmap	*pv_pmap;	/* pmap where mapping lies */
165	vaddr_t		pv_va;		/* virtual address for mapping */
166	pt_entry_t	*pv_pte;	/* PTE that maps the VA */
167} *pv_entry_t;
168
169/* pvh_attrs */
170#define	PGA_MODIFIED		0x01		/* modified */
171#define	PGA_REFERENCED		0x02		/* referenced */
172
173/* pvh_usage */
174#define	PGU_NORMAL		0		/* free or normal use */
175#define	PGU_PVENT		1		/* PV entries */
176#define	PGU_L1PT		2		/* level 1 page table */
177#define	PGU_L2PT		3		/* level 2 page table */
178#define	PGU_L3PT		4		/* level 3 page table */
179
180#ifdef _KERNEL
181
182#include <sys/atomic.h>
183
184#ifndef _LKM
185#include "opt_dec_kn8ae.h"			/* XXX */
186
187#if defined(DEC_KN8AE)
188#define	_PMAP_MAY_USE_PROM_CONSOLE
189#endif
190
191#if defined(MULTIPROCESSOR)
192struct cpu_info;
193struct trapframe;
194
195void	pmap_do_reactivate(struct cpu_info *, struct trapframe *);
196
197void	pmap_tlb_shootdown(pmap_t, vaddr_t, pt_entry_t, u_long *);
198void	pmap_tlb_shootnow(u_long);
199void	pmap_do_tlb_shootdown(struct cpu_info *, struct trapframe *);
200#define	PMAP_TLB_SHOOTDOWN_CPUSET_DECL		u_long shootset = 0;
201#define	PMAP_TLB_SHOOTDOWN(pm, va, pte)					\
202	pmap_tlb_shootdown((pm), (va), (pte), &shootset)
203#define	PMAP_TLB_SHOOTNOW()						\
204	pmap_tlb_shootnow(shootset)
205#else
206#define	PMAP_TLB_SHOOTDOWN_CPUSET_DECL		/* nothing */
207#define	PMAP_TLB_SHOOTDOWN(pm, va, pte)		/* nothing */
208#define	PMAP_TLB_SHOOTNOW()			/* nothing */
209#endif /* MULTIPROCESSOR */
210#endif /* _LKM */
211
212#define	pmap_resident_count(pmap)	((pmap)->pm_stats.resident_count)
213#define	pmap_wired_count(pmap)		((pmap)->pm_stats.wired_count)
214
215#define	pmap_copy(dp, sp, da, l, sa)	/* nothing */
216#define	pmap_update(pmap)		/* nothing (yet) */
217
218static __inline void
219pmap_remove_all(struct pmap *pmap)
220{
221	/* Nothing. */
222}
223
224#define	pmap_is_referenced(pg)						\
225	(((pg)->mdpage.pvh_attrs & PGA_REFERENCED) != 0)
226#define	pmap_is_modified(pg)						\
227	(((pg)->mdpage.pvh_attrs & PGA_MODIFIED) != 0)
228
229#define	PMAP_STEAL_MEMORY		/* enable pmap_steal_memory() */
230#define	PMAP_GROWKERNEL			/* enable pmap_growkernel() */
231
232/*
233 * Alternate mapping hooks for pool pages.  Avoids thrashing the TLB.
234 */
235#define	PMAP_MAP_POOLPAGE(pa)		ALPHA_PHYS_TO_K0SEG((pa))
236#define	PMAP_UNMAP_POOLPAGE(va)		ALPHA_K0SEG_TO_PHYS((va))
237
238/*
239 * Other hooks for the pool allocator.
240 */
241#define	POOL_VTOPHYS(va)		ALPHA_K0SEG_TO_PHYS((vaddr_t) (va))
242
243bool	pmap_pageidlezero(paddr_t);
244#define	PMAP_PAGEIDLEZERO(pa)	pmap_pageidlezero((pa))
245
246paddr_t vtophys(vaddr_t);
247
248/* Machine-specific functions. */
249void	pmap_bootstrap(paddr_t, u_int, u_long);
250int	pmap_emulate_reference(struct lwp *, vaddr_t, int, int);
251#ifdef _PMAP_MAY_USE_PROM_CONSOLE
252int	pmap_uses_prom_console(void);
253#endif
254
255#define	pmap_pte_pa(pte)	(PG_PFNUM(*(pte)) << PGSHIFT)
256#define	pmap_pte_prot(pte)	(*(pte) & PG_PROT)
257#define	pmap_pte_w(pte)		(*(pte) & PG_WIRED)
258#define	pmap_pte_v(pte)		(*(pte) & PG_V)
259#define	pmap_pte_pv(pte)	(*(pte) & PG_PVLIST)
260#define	pmap_pte_asm(pte)	(*(pte) & PG_ASM)
261#define	pmap_pte_exec(pte)	(*(pte) & PG_EXEC)
262
263#define	pmap_pte_set_w(pte, v)						\
264do {									\
265	if (v)								\
266		*(pte) |= PG_WIRED;					\
267	else								\
268		*(pte) &= ~PG_WIRED;					\
269} while (0)
270
271#define	pmap_pte_w_chg(pte, nw)	((nw) ^ pmap_pte_w(pte))
272
273#define	pmap_pte_set_prot(pte, np)					\
274do {									\
275	*(pte) &= ~PG_PROT;						\
276	*(pte) |= (np);							\
277} while (0)
278
279#define	pmap_pte_prot_chg(pte, np) ((np) ^ pmap_pte_prot(pte))
280
281static __inline pt_entry_t *pmap_l2pte(pmap_t, vaddr_t, pt_entry_t *);
282static __inline pt_entry_t *pmap_l3pte(pmap_t, vaddr_t, pt_entry_t *);
283
284#define	pmap_l1pte(pmap, v)						\
285	(&(pmap)->pm_lev1map[l1pte_index((vaddr_t)(v))])
286
287static __inline pt_entry_t *
288pmap_l2pte(pmap, v, l1pte)
289	pmap_t pmap;
290	vaddr_t v;
291	pt_entry_t *l1pte;
292{
293	pt_entry_t *lev2map;
294
295	if (l1pte == NULL) {
296		l1pte = pmap_l1pte(pmap, v);
297		if (pmap_pte_v(l1pte) == 0)
298			return (NULL);
299	}
300
301	lev2map = (pt_entry_t *)ALPHA_PHYS_TO_K0SEG(pmap_pte_pa(l1pte));
302	return (&lev2map[l2pte_index(v)]);
303}
304
305static __inline pt_entry_t *
306pmap_l3pte(pmap, v, l2pte)
307	pmap_t pmap;
308	vaddr_t v;
309	pt_entry_t *l2pte;
310{
311	pt_entry_t *l1pte, *lev2map, *lev3map;
312
313	if (l2pte == NULL) {
314		l1pte = pmap_l1pte(pmap, v);
315		if (pmap_pte_v(l1pte) == 0)
316			return (NULL);
317
318		lev2map = (pt_entry_t *)ALPHA_PHYS_TO_K0SEG(pmap_pte_pa(l1pte));
319		l2pte = &lev2map[l2pte_index(v)];
320		if (pmap_pte_v(l2pte) == 0)
321			return (NULL);
322	}
323
324	lev3map = (pt_entry_t *)ALPHA_PHYS_TO_K0SEG(pmap_pte_pa(l2pte));
325	return (&lev3map[l3pte_index(v)]);
326}
327
328/*
329 * Macros for locking pmap structures.
330 *
331 * Note that we if we access the kernel pmap in interrupt context, it
332 * is only to update statistics.  Since stats are updated using atomic
333 * operations, locking the kernel pmap is not necessary.  Therefore,
334 * it is not necessary to block interrupts when locking pmap strucutres.
335 */
336#define	PMAP_LOCK(pmap)		mutex_enter(&(pmap)->pm_lock)
337#define	PMAP_UNLOCK(pmap)	mutex_exit(&(pmap)->pm_lock)
338
339/*
340 * Macro for processing deferred I-stream synchronization.
341 *
342 * The pmap module may defer syncing the user I-stream until the
343 * return to userspace, since the IMB PALcode op can be quite
344 * expensive.  Since user instructions won't be executed until
345 * the return to userspace, this can be deferred until userret().
346 */
347#define	PMAP_USERRET(pmap)						\
348do {									\
349	u_long cpu_mask = (1UL << cpu_number());			\
350									\
351	if ((pmap)->pm_needisync & cpu_mask) {				\
352		atomic_and_ulong(&(pmap)->pm_needisync,	~cpu_mask);	\
353		alpha_pal_imb();					\
354	}								\
355} while (0)
356
357#endif /* _KERNEL */
358
359#endif /* _PMAP_MACHINE_ */
360