xref: /freebsd/share/man/man9/pmap_unwire.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1*ce5bed4bSAlan Cox.\"
2*ce5bed4bSAlan Cox.\" Copyright (c) 2014 Alan L. Cox <alc@rice.edu>
3*ce5bed4bSAlan Cox.\" All rights reserved.
4*ce5bed4bSAlan Cox.\"
5*ce5bed4bSAlan Cox.\" Redistribution and use in source and binary forms, with or without
6*ce5bed4bSAlan Cox.\" modification, are permitted provided that the following conditions
7*ce5bed4bSAlan Cox.\" are met:
8*ce5bed4bSAlan Cox.\" 1. Redistributions of source code must retain the above copyright
9*ce5bed4bSAlan Cox.\"    notice, this list of conditions and the following disclaimer.
10*ce5bed4bSAlan Cox.\" 2. Redistributions in binary form must reproduce the above copyright
11*ce5bed4bSAlan Cox.\"    notice, this list of conditions and the following disclaimer in the
12*ce5bed4bSAlan Cox.\"    documentation and/or other materials provided with the distribution.
13*ce5bed4bSAlan Cox.\"
14*ce5bed4bSAlan Cox.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15*ce5bed4bSAlan Cox.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16*ce5bed4bSAlan Cox.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17*ce5bed4bSAlan Cox.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18*ce5bed4bSAlan Cox.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19*ce5bed4bSAlan Cox.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20*ce5bed4bSAlan Cox.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21*ce5bed4bSAlan Cox.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22*ce5bed4bSAlan Cox.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23*ce5bed4bSAlan Cox.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24*ce5bed4bSAlan Cox.\" SUCH DAMAGE.
25*ce5bed4bSAlan Cox.\"
26*ce5bed4bSAlan Cox.Dd July 17, 2014
27*ce5bed4bSAlan Cox.Dt PMAP_UNWIRE 9
28*ce5bed4bSAlan Cox.Os
29*ce5bed4bSAlan Cox.Sh NAME
30*ce5bed4bSAlan Cox.Nm pmap_unwire
31*ce5bed4bSAlan Cox.Nd unwire a range of virtual pages
32*ce5bed4bSAlan Cox.Sh SYNOPSIS
33*ce5bed4bSAlan Cox.In sys/param.h
34*ce5bed4bSAlan Cox.In vm/vm.h
35*ce5bed4bSAlan Cox.In vm/pmap.h
36*ce5bed4bSAlan Cox.Ft void
37*ce5bed4bSAlan Cox.Fo pmap_unwire
38*ce5bed4bSAlan Cox.Fa "pmap_t pmap" "vm_offset_t start" "vm_offset_t end"
39*ce5bed4bSAlan Cox.Fc
40*ce5bed4bSAlan Cox.Sh DESCRIPTION
41*ce5bed4bSAlan CoxThe function
42*ce5bed4bSAlan Cox.Fn pmap_unwire
43*ce5bed4bSAlan Coxremoves the wired attribute from each of the virtual-to-physical page mappings
44*ce5bed4bSAlan Coxwithin the virtual address range from
45*ce5bed4bSAlan Cox.Fa start
46*ce5bed4bSAlan Coxto
47*ce5bed4bSAlan Cox.Fa end
48*ce5bed4bSAlan Coxof the physical map
49*ce5bed4bSAlan Cox.Fa pmap .
50*ce5bed4bSAlan CoxEvery valid mapping within that range is required to have the wired attribute
51*ce5bed4bSAlan Coxset.
52*ce5bed4bSAlan CoxInvalid mappings are ignored, since they cannot have the wired attribute set.
53*ce5bed4bSAlan Cox.Sh NOTES
54*ce5bed4bSAlan CoxOnly the function
55*ce5bed4bSAlan Cox.Xr pmap_enter 9
56*ce5bed4bSAlan Coxcan be used to set the wired attribute of a virtual-to-physical page mapping.
57*ce5bed4bSAlan Cox.Sh SEE ALSO
58*ce5bed4bSAlan Cox.Xr pmap 9 ,
59*ce5bed4bSAlan Cox.Xr pmap_enter 9 ,
60*ce5bed4bSAlan Cox.Xr pmap_wired_count 9
61*ce5bed4bSAlan Cox.Sh AUTHORS
62*ce5bed4bSAlan CoxThis manual page was written by
63*ce5bed4bSAlan Cox.An Alan L. Cox Aq alc@rice.edu .
64