xref: /dragonfly/sys/vm/vm_page.h (revision e96fb831)
1 /*
2  * Copyright (c) 1991, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * This code is derived from software contributed to Berkeley by
6  * The Mach Operating System project at Carnegie-Mellon University.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. All advertising materials mentioning features or use of this software
17  *    must display the following acknowledgement:
18  *	This product includes software developed by the University of
19  *	California, Berkeley and its contributors.
20  * 4. Neither the name of the University nor the names of its contributors
21  *    may be used to endorse or promote products derived from this software
22  *    without specific prior written permission.
23  *
24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34  * SUCH DAMAGE.
35  *
36  *	from: @(#)vm_page.h	8.2 (Berkeley) 12/13/93
37  *
38  *
39  * Copyright (c) 1987, 1990 Carnegie-Mellon University.
40  * All rights reserved.
41  *
42  * Authors: Avadis Tevanian, Jr., Michael Wayne Young
43  *
44  * Permission to use, copy, modify and distribute this software and
45  * its documentation is hereby granted, provided that both the copyright
46  * notice and this permission notice appear in all copies of the
47  * software, derivative works or modified versions, and any portions
48  * thereof, and that both notices appear in supporting documentation.
49  *
50  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
51  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
52  * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
53  *
54  * Carnegie Mellon requests users of this software to return to
55  *
56  *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
57  *  School of Computer Science
58  *  Carnegie Mellon University
59  *  Pittsburgh PA 15213-3890
60  *
61  * any improvements or extensions that they make and grant Carnegie the
62  * rights to redistribute these changes.
63  *
64  * $FreeBSD: src/sys/vm/vm_page.h,v 1.75.2.8 2002/03/06 01:07:09 dillon Exp $
65  */
66 
67 /*
68  *	Resident memory system definitions.
69  */
70 
71 #ifndef	_VM_VM_PAGE_H_
72 #define	_VM_VM_PAGE_H_
73 
74 #ifndef _SYS_TYPES_H_
75 #include <sys/types.h>
76 #endif
77 #ifndef _SYS_TREE_H_
78 #include <sys/tree.h>
79 #endif
80 #ifndef _MACHINE_PMAP_H_
81 #include <machine/pmap.h>
82 #endif
83 #ifndef _VM_PMAP_H_
84 #include <vm/pmap.h>
85 #endif
86 #include <machine/atomic.h>
87 
88 #ifdef _KERNEL
89 
90 #ifndef _SYS_SYSTM_H_
91 #include <sys/systm.h>
92 #endif
93 #ifndef _SYS_THREAD2_H_
94 #include <sys/thread2.h>
95 #endif
96 
97 #ifdef __x86_64__
98 #include <machine/vmparam.h>
99 #endif
100 
101 #endif
102 
103 typedef enum vm_page_event { VMEVENT_NONE, VMEVENT_COW } vm_page_event_t;
104 
105 struct vm_page_action {
106 	LIST_ENTRY(vm_page_action) entry;
107 	struct vm_page		*m;
108 	vm_page_event_t		event;
109 	void			(*func)(struct vm_page *,
110 					struct vm_page_action *);
111 	void			*data;
112 };
113 
114 typedef struct vm_page_action *vm_page_action_t;
115 
116 /*
117  *	Management of resident (logical) pages.
118  *
119  *	A small structure is kept for each resident
120  *	page, indexed by page number.  Each structure
121  *	is an element of several lists:
122  *
123  *		A hash table bucket used to quickly
124  *		perform object/offset lookups
125  *
126  *		A list of all pages for a given object,
127  *		so they can be quickly deactivated at
128  *		time of deallocation.
129  *
130  *		An ordered list of pages due for pageout.
131  *
132  *	In addition, the structure contains the object
133  *	and offset to which this page belongs (for pageout),
134  *	and sundry status bits.
135  *
136  *	Fields in this structure are locked either by the lock on the
137  *	object that the page belongs to (O) or by the lock on the page
138  *	queues (P).
139  *
140  *	The 'valid' and 'dirty' fields are distinct.  A page may have dirty
141  *	bits set without having associated valid bits set.  This is used by
142  *	NFS to implement piecemeal writes.
143  */
144 
145 TAILQ_HEAD(pglist, vm_page);
146 
147 struct vm_object;
148 
149 int rb_vm_page_compare(struct vm_page *, struct vm_page *);
150 
151 struct vm_page_rb_tree;
152 RB_PROTOTYPE2(vm_page_rb_tree, vm_page, rb_entry, rb_vm_page_compare, vm_pindex_t);
153 
154 struct vm_page {
155 	TAILQ_ENTRY(vm_page) pageq;	/* vm_page_queues[] list (P)	*/
156 	RB_ENTRY(vm_page) rb_entry;	/* Red-Black tree based at object */
157 
158 	struct vm_object *object;	/* which object am I in (O,P)*/
159 	vm_pindex_t pindex;		/* offset into object (O,P) */
160 	vm_paddr_t phys_addr;		/* physical address of page */
161 	struct md_page md;		/* machine dependant stuff */
162 	u_short	queue;			/* page queue index */
163 	u_short	pc;			/* page color */
164 	u_char	act_count;		/* page usage count */
165 	u_char	busy;			/* page busy count */
166 	u_char	unused01;
167 	u_char	unused02;
168 	u_int32_t flags;		/* see below */
169 	u_int	wire_count;		/* wired down maps refs (P) */
170 	int 	hold_count;		/* page hold count */
171 
172 	/*
173 	 * NOTE that these must support one bit per DEV_BSIZE in a page!!!
174 	 * so, on normal X86 kernels, they must be at least 8 bits wide.
175 	 */
176 	u_char	valid;			/* map of valid DEV_BSIZE chunks */
177 	u_char	dirty;			/* map of dirty DEV_BSIZE chunks */
178 
179 	int	ku_pagecnt;		/* kmalloc helper */
180 #ifdef VM_PAGE_DEBUG
181 	const char *busy_func;
182 	int	busy_line;
183 #endif
184 };
185 
186 #ifdef VM_PAGE_DEBUG
187 #define VM_PAGE_DEBUG_EXT(name)	name ## _debug
188 #define VM_PAGE_DEBUG_ARGS	, const char *func, int lineno
189 #else
190 #define VM_PAGE_DEBUG_EXT(name)	name
191 #define VM_PAGE_DEBUG_ARGS
192 #endif
193 
194 #ifndef __VM_PAGE_T_DEFINED__
195 #define __VM_PAGE_T_DEFINED__
196 typedef struct vm_page *vm_page_t;
197 #endif
198 
199 /*
200  * Page coloring parameters.  We use generous parameters designed to
201  * statistically spread pages over available cpu cache space.  This has
202  * become less important over time as cache associativity is higher
203  * in modern times but we still use the core algorithm to help reduce
204  * lock contention between cpus.
205  *
206  * Page coloring cannot be disabled.
207  */
208 
209 #define PQ_PRIME1 31	/* Prime number somewhat less than PQ_HASH_SIZE */
210 #define PQ_PRIME2 23	/* Prime number somewhat less than PQ_HASH_SIZE */
211 #define PQ_L2_SIZE 256	/* A number of colors opt for 1M cache */
212 
213 #if 0
214 #define PQ_PRIME1 31	/* Prime number somewhat less than PQ_HASH_SIZE */
215 #define PQ_PRIME2 23	/* Prime number somewhat less than PQ_HASH_SIZE */
216 #define PQ_L2_SIZE 128	/* A number of colors opt for 512K cache */
217 
218 #define PQ_PRIME1 13	/* Prime number somewhat less than PQ_HASH_SIZE */
219 #define PQ_PRIME2 7	/* Prime number somewhat less than PQ_HASH_SIZE */
220 #define PQ_L2_SIZE 64	/* A number of colors opt for 256K cache */
221 
222 #define PQ_PRIME1 9	/* Produces a good PQ_L2_SIZE/3 + PQ_PRIME1 */
223 #define PQ_PRIME2 5	/* Prime number somewhat less than PQ_HASH_SIZE */
224 #define PQ_L2_SIZE 32	/* A number of colors opt for 128k cache */
225 
226 #define PQ_PRIME1 5	/* Prime number somewhat less than PQ_HASH_SIZE */
227 #define PQ_PRIME2 3	/* Prime number somewhat less than PQ_HASH_SIZE */
228 #define PQ_L2_SIZE 16	/* A reasonable number of colors (opt for 64K cache) */
229 #endif
230 
231 #define PQ_L2_MASK	(PQ_L2_SIZE - 1)
232 
233 #define PQ_NONE		0
234 #define PQ_FREE		(1 + 0*PQ_L2_SIZE)
235 #define PQ_INACTIVE	(1 + 1*PQ_L2_SIZE)
236 #define PQ_ACTIVE	(1 + 2*PQ_L2_SIZE)
237 #define PQ_CACHE	(1 + 3*PQ_L2_SIZE)
238 #define PQ_HOLD		(1 + 4*PQ_L2_SIZE)
239 #define PQ_COUNT	(1 + 5*PQ_L2_SIZE)
240 
241 /*
242  * Scan support
243  */
244 struct vm_map;
245 
246 struct rb_vm_page_scan_info {
247 	vm_pindex_t	start_pindex;
248 	vm_pindex_t	end_pindex;
249 	int		limit;
250 	int		desired;
251 	int		error;
252 	int		pagerflags;
253 	vm_offset_t	addr;
254 	vm_pindex_t	backing_offset_index;
255 	struct vm_object *object;
256 	struct vm_object *backing_object;
257 	struct vm_page	*mpte;
258 	struct pmap	*pmap;
259 	struct vm_map	*map;
260 };
261 
262 int rb_vm_page_scancmp(struct vm_page *, void *);
263 
264 struct vpgqueues {
265 	struct pglist pl;
266 	int	*cnt;
267 	int	lcnt;
268 	int	flipflop;	/* probably not the best place */
269 	struct spinlock spin;
270 	char	unused[64 - sizeof(struct pglist) -
271 			sizeof(int *) - sizeof(int) * 2];
272 };
273 
274 extern struct vpgqueues vm_page_queues[PQ_COUNT];
275 
276 /*
277  * These are the flags defined for vm_page.
278  *
279  *  PG_UNMANAGED (used by OBJT_PHYS) indicates that the page is
280  *  not under PV management but otherwise should be treated as a
281  *  normal page.  Pages not under PV management cannot be paged out
282  *  via the object/vm_page_t because there is no knowledge of their
283  *  pte mappings, nor can they be removed from their objects via
284  *  the object, and such pages are also not on any PQ queue.  The
285  *  PG_MAPPED and PG_WRITEABLE flags are not applicable.
286  *
287  *  PG_MAPPED only applies to managed pages, indicating whether the page
288  *  is mapped onto one or more pmaps.  A page might still be mapped to
289  *  special pmaps in an unmanaged fashion, for example when mapped into a
290  *  buffer cache buffer, without setting PG_MAPPED.
291  *
292  *  PG_WRITEABLE indicates that there may be a writeable managed pmap entry
293  *  somewhere, and that the page can be dirtied by hardware at any time
294  *  and may have to be tested for that.  The modified bit in unmanaged
295  *  mappings or in the special clean map is not tested.
296  *
297  *  PG_SWAPPED indicates that the page is backed by a swap block.  Any
298  *  VM object type other than OBJT_DEFAULT can have swap-backed pages now.
299  *
300  *  PG_SBUSY is set when m->busy != 0.  PG_SBUSY and m->busy are only modified
301  *  when the page is PG_BUSY.
302  */
303 #define	PG_BUSY		0x00000001	/* page is in transit (O) */
304 #define	PG_WANTED	0x00000002	/* someone is waiting for page (O) */
305 #define PG_WINATCFLS	0x00000004	/* flush dirty page on inactive q */
306 #define	PG_FICTITIOUS	0x00000008	/* physical page doesn't exist (O) */
307 #define	PG_WRITEABLE	0x00000010	/* page is writeable */
308 #define PG_MAPPED	0x00000020	/* page is mapped (managed) */
309 #define	PG_ZERO		0x00000040	/* page is zeroed */
310 #define PG_REFERENCED	0x00000080	/* page has been referenced */
311 #define PG_CLEANCHK	0x00000100	/* page will be checked for cleaning */
312 #define PG_SWAPINPROG	0x00000200	/* swap I/O in progress on page	     */
313 #define PG_NOSYNC	0x00000400	/* do not collect for syncer */
314 #define PG_UNMANAGED	0x00000800	/* No PV management for page */
315 #define PG_MARKER	0x00001000	/* special queue marker page */
316 #define PG_RAM		0x00002000	/* read ahead mark */
317 #define PG_SWAPPED	0x00004000	/* backed by swap */
318 #define PG_NOTMETA	0x00008000	/* do not back with swap */
319 #define PG_ACTIONLIST	0x00010000	/* lookaside action list present */
320 #define PG_SBUSY	0x00020000	/* soft-busy also set */
321 
322 /*
323  * Misc constants.
324  */
325 
326 #define ACT_DECLINE		1
327 #define ACT_ADVANCE		3
328 #define ACT_INIT		5
329 #define ACT_MAX			64
330 
331 #ifdef _KERNEL
332 /*
333  * Each pageable resident page falls into one of four lists:
334  *
335  *	free
336  *		Available for allocation now.
337  *
338  * The following are all LRU sorted:
339  *
340  *	cache
341  *		Almost available for allocation. Still in an
342  *		object, but clean and immediately freeable at
343  *		non-interrupt times.
344  *
345  *	inactive
346  *		Low activity, candidates for reclamation.
347  *		This is the list of pages that should be
348  *		paged out next.
349  *
350  *	active
351  *		Pages that are "active" i.e. they have been
352  *		recently referenced.
353  *
354  *	zero
355  *		Pages that are really free and have been pre-zeroed
356  *
357  */
358 
359 extern int vm_page_zero_count;
360 extern struct vm_page *vm_page_array;	/* First resident page in table */
361 extern int vm_page_array_size;		/* number of vm_page_t's */
362 extern long first_page;			/* first physical page number */
363 
364 #define VM_PAGE_TO_PHYS(entry)	\
365 		((entry)->phys_addr)
366 
367 #define PHYS_TO_VM_PAGE(pa)	\
368 		(&vm_page_array[atop(pa) - first_page])
369 
370 /*
371  *	Functions implemented as macros
372  */
373 
374 static __inline void
375 vm_page_flag_set(vm_page_t m, unsigned int bits)
376 {
377 	atomic_set_int(&(m)->flags, bits);
378 }
379 
380 static __inline void
381 vm_page_flag_clear(vm_page_t m, unsigned int bits)
382 {
383 	atomic_clear_int(&(m)->flags, bits);
384 }
385 
386 /*
387  * Wakeup anyone waiting for the page after potentially unbusying
388  * (hard or soft) or doing other work on a page that might make a
389  * waiter ready.  The setting of PG_WANTED is integrated into the
390  * related flags and it can't be set once the flags are already
391  * clear, so there should be no races here.
392  */
393 
394 static __inline void
395 vm_page_flash(vm_page_t m)
396 {
397 	if (m->flags & PG_WANTED) {
398 		vm_page_flag_clear(m, PG_WANTED);
399 		wakeup(m);
400 	}
401 }
402 
403 #if PAGE_SIZE == 4096
404 #define VM_PAGE_BITS_ALL 0xff
405 #endif
406 
407 /*
408  * Note: the code will always use nominally free pages from the free list
409  * before trying other flag-specified sources.
410  *
411  * At least one of VM_ALLOC_NORMAL|VM_ALLOC_SYSTEM|VM_ALLOC_INTERRUPT
412  * must be specified.  VM_ALLOC_RETRY may only be specified if VM_ALLOC_NORMAL
413  * is also specified.
414  */
415 #define VM_ALLOC_NORMAL		0x0001	/* ok to use cache pages */
416 #define VM_ALLOC_SYSTEM		0x0002	/* ok to exhaust most of free list */
417 #define VM_ALLOC_INTERRUPT	0x0004	/* ok to exhaust entire free list */
418 #define	VM_ALLOC_ZERO		0x0008	/* req pre-zero'd memory if avail */
419 #define	VM_ALLOC_QUICK		0x0010	/* like NORMAL but do not use cache */
420 #define VM_ALLOC_FORCE_ZERO	0x0020	/* zero page even if already valid */
421 #define VM_ALLOC_NULL_OK	0x0040	/* ok to return NULL on collision */
422 #define	VM_ALLOC_RETRY		0x0080	/* indefinite block (vm_page_grab()) */
423 #define VM_ALLOC_USE_GD		0x0100	/* use per-gd cache */
424 
425 void vm_page_queue_spin_lock(vm_page_t);
426 void vm_page_queues_spin_lock(u_short);
427 void vm_page_and_queue_spin_lock(vm_page_t);
428 
429 void vm_page_queue_spin_unlock(vm_page_t);
430 void vm_page_queues_spin_unlock(u_short);
431 void vm_page_and_queue_spin_unlock(vm_page_t m);
432 
433 void vm_page_io_finish(vm_page_t m);
434 void vm_page_io_start(vm_page_t m);
435 void vm_page_wakeup(vm_page_t m);
436 void vm_page_hold(vm_page_t);
437 void vm_page_unhold(vm_page_t);
438 void vm_page_activate (vm_page_t);
439 void vm_page_pcpu_cache(void);
440 vm_page_t vm_page_alloc (struct vm_object *, vm_pindex_t, int);
441 vm_page_t vm_page_alloc_contig(vm_paddr_t low, vm_paddr_t high,
442                      unsigned long alignment, unsigned long boundary,
443 		     unsigned long size);
444 vm_page_t vm_page_grab (struct vm_object *, vm_pindex_t, int);
445 void vm_page_cache (vm_page_t);
446 int vm_page_try_to_cache (vm_page_t);
447 int vm_page_try_to_free (vm_page_t);
448 void vm_page_dontneed (vm_page_t);
449 void vm_page_deactivate (vm_page_t);
450 void vm_page_deactivate_locked (vm_page_t);
451 int vm_page_insert (vm_page_t, struct vm_object *, vm_pindex_t);
452 vm_page_t vm_page_lookup (struct vm_object *, vm_pindex_t);
453 vm_page_t VM_PAGE_DEBUG_EXT(vm_page_lookup_busy_wait)(
454 		struct vm_object *, vm_pindex_t, int, const char *
455 		VM_PAGE_DEBUG_ARGS);
456 vm_page_t VM_PAGE_DEBUG_EXT(vm_page_lookup_busy_try)(
457 		struct vm_object *, vm_pindex_t, int, int *
458 		VM_PAGE_DEBUG_ARGS);
459 void vm_page_remove (vm_page_t);
460 void vm_page_rename (vm_page_t, struct vm_object *, vm_pindex_t);
461 void vm_page_startup (void);
462 void vm_page_unmanage (vm_page_t);
463 void vm_page_unwire (vm_page_t, int);
464 void vm_page_wire (vm_page_t);
465 void vm_page_unqueue (vm_page_t);
466 void vm_page_unqueue_nowakeup (vm_page_t);
467 vm_page_t vm_page_next (vm_page_t);
468 void vm_page_set_validclean (vm_page_t, int, int);
469 void vm_page_set_validdirty (vm_page_t, int, int);
470 void vm_page_set_valid (vm_page_t, int, int);
471 void vm_page_set_dirty (vm_page_t, int, int);
472 void vm_page_clear_dirty (vm_page_t, int, int);
473 void vm_page_set_invalid (vm_page_t, int, int);
474 int vm_page_is_valid (vm_page_t, int, int);
475 void vm_page_test_dirty (vm_page_t);
476 int vm_page_bits (int, int);
477 vm_page_t vm_page_list_find(int basequeue, int index, boolean_t prefer_zero);
478 void vm_page_zero_invalid(vm_page_t m, boolean_t setvalid);
479 void vm_page_free_toq(vm_page_t m);
480 void vm_page_free_contig(vm_page_t m, unsigned long size);
481 vm_page_t vm_page_free_fromq_fast(void);
482 void vm_page_event_internal(vm_page_t, vm_page_event_t);
483 void vm_page_dirty(vm_page_t m);
484 void vm_page_register_action(vm_page_action_t action, vm_page_event_t event);
485 void vm_page_unregister_action(vm_page_action_t action);
486 void vm_page_sleep_busy(vm_page_t m, int also_m_busy, const char *msg);
487 void VM_PAGE_DEBUG_EXT(vm_page_busy_wait)(vm_page_t m, int also_m_busy, const char *wmsg VM_PAGE_DEBUG_ARGS);
488 int VM_PAGE_DEBUG_EXT(vm_page_busy_try)(vm_page_t m, int also_m_busy VM_PAGE_DEBUG_ARGS);
489 
490 #ifdef VM_PAGE_DEBUG
491 
492 #define vm_page_lookup_busy_wait(object, pindex, alsob, msg)		\
493 	vm_page_lookup_busy_wait_debug(object, pindex, alsob, msg,	\
494 					__func__, __LINE__)
495 
496 #define vm_page_lookup_busy_try(object, pindex, alsob, errorp)		\
497 	vm_page_lookup_busy_try_debug(object, pindex, alsob, errorp,	\
498 					__func__, __LINE__)
499 
500 #define vm_page_busy_wait(m, alsob, msg)				\
501 	vm_page_busy_wait_debug(m, alsob, msg, __func__, __LINE__)
502 
503 #define vm_page_busy_try(m, alsob)					\
504 	vm_page_busy_try_debug(m, alsob, __func__, __LINE__)
505 
506 #endif
507 
508 /*
509  * Reduce the protection of a page.  This routine never raises the
510  * protection and therefore can be safely called if the page is already
511  * at VM_PROT_NONE (it will be a NOP effectively ).
512  *
513  * VM_PROT_NONE will remove all user mappings of a page.  This is often
514  * necessary when a page changes state (for example, turns into a copy-on-write
515  * page or needs to be frozen for write I/O) in order to force a fault, or
516  * to force a page's dirty bits to be synchronized and avoid hardware
517  * (modified/accessed) bit update races with pmap changes.
518  *
519  * Since 'prot' is usually a constant, this inline usually winds up optimizing
520  * out the primary conditional.
521  *
522  * WARNING: VM_PROT_NONE can block, but will loop until all mappings have
523  * been cleared.  Callers should be aware that other page related elements
524  * might have changed, however.
525  */
526 static __inline void
527 vm_page_protect(vm_page_t m, int prot)
528 {
529 	KKASSERT(m->flags & PG_BUSY);
530 	if (prot == VM_PROT_NONE) {
531 		if (m->flags & (PG_WRITEABLE|PG_MAPPED)) {
532 			pmap_page_protect(m, VM_PROT_NONE);
533 			/* PG_WRITEABLE & PG_MAPPED cleared by call */
534 		}
535 	} else if ((prot == VM_PROT_READ) && (m->flags & PG_WRITEABLE)) {
536 		pmap_page_protect(m, VM_PROT_READ);
537 		/* PG_WRITEABLE cleared by call */
538 	}
539 }
540 
541 /*
542  * Zero-fill the specified page.  The entire contents of the page will be
543  * zero'd out.
544  */
545 static __inline boolean_t
546 vm_page_zero_fill(vm_page_t m)
547 {
548 	pmap_zero_page(VM_PAGE_TO_PHYS(m));
549 	return (TRUE);
550 }
551 
552 /*
553  * Copy the contents of src_m to dest_m.  The pages must be stable but spl
554  * and other protections depend on context.
555  */
556 static __inline void
557 vm_page_copy(vm_page_t src_m, vm_page_t dest_m)
558 {
559 	pmap_copy_page(VM_PAGE_TO_PHYS(src_m), VM_PAGE_TO_PHYS(dest_m));
560 	dest_m->valid = VM_PAGE_BITS_ALL;
561 	dest_m->dirty = VM_PAGE_BITS_ALL;
562 }
563 
564 /*
565  * Free a page.  The page must be marked BUSY.
566  *
567  * Always clear PG_ZERO when freeing a page, which ensures the flag is not
568  * set unless we are absolutely certain the page is zerod.  This is
569  * particularly important when the vm_page_alloc*() code moves pages from
570  * PQ_CACHE to PQ_FREE.
571  */
572 static __inline void
573 vm_page_free(vm_page_t m)
574 {
575 	vm_page_flag_clear(m, PG_ZERO);
576 	vm_page_free_toq(m);
577 }
578 
579 /*
580  * Free a page to the zerod-pages queue.  The caller must ensure that the
581  * page has been zerod.
582  */
583 static __inline void
584 vm_page_free_zero(vm_page_t m)
585 {
586 #ifdef PMAP_DEBUG
587 #ifdef PHYS_TO_DMAP
588 	char *p = (char *)PHYS_TO_DMAP(VM_PAGE_TO_PHYS(m));
589 	int i;
590 
591 	for (i = 0; i < PAGE_SIZE; i++) {
592 		if (p[i] != 0) {
593 			panic("non-zero page in vm_page_free_zero()");
594 		}
595 	}
596 #endif
597 #endif
598 	vm_page_flag_set(m, PG_ZERO);
599 	vm_page_free_toq(m);
600 }
601 
602 /*
603  * Set page to not be dirty.  Note: does not clear pmap modify bits .
604  */
605 static __inline void
606 vm_page_undirty(vm_page_t m)
607 {
608 	m->dirty = 0;
609 }
610 
611 #endif				/* _KERNEL */
612 #endif				/* !_VM_VM_PAGE_H_ */
613