sync with OpenBSD -current

share/man/man9/pmap.9

@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pmap.9,v 1.20 2023/04/13 15:23:21 miod Exp $
+.\"	$OpenBSD: pmap.9,v 1.21 2025/01/19 22:14:45 kettenis Exp $
 .\"
 .\" Copyright (c) 2001, 2002, 2003 CubeSoft Communications, Inc.
 .\" <http://www.csoft.org>
@@ -24,7 +24,7 @@
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: April 13 2023 $
+.Dd $Mdocdate: January 19 2025 $
 .Dt PMAP_INIT 9
 .Os
 .Sh NAME
@@ -49,6 +49,7 @@
 .Nm pmap_growkernel ,
 .Nm pmap_update ,
 .Nm pmap_collect ,
+.Nm pmap_populate ,
 .Nm pmap_virtual_space
 .Nd machine dependent interface to the MMU
 .Sh SYNOPSIS
@@ -364,6 +365,8 @@ it contains no valid mappings.
 .Ft void
 .Fn pmap_collect "pmap_t pmap"
 .Ft void
+.Fn pmap_populate "pmap_t pmap" "vaddr_t va"
+.Ft void
 .Fn pmap_virtual_space "vaddr_t *vstartp" "vaddr_t *vendp"
 .nr nS 0
 .Pp
@@ -384,6 +387,14 @@ function notifies the
 module to force processing of all delayed actions for all pmaps.
 .Pp
 The
+.Fn pmap_populate
+function makes sure the resources necessary for mapping the specified
+virtual address
+.Fa va
+are allocated in the target physical map
+.Fa pmap .
+.Pp
+The
 .Fn pmap_collect
 function informs the
 .Nm pmap