---
name: "pmap_map"
section: "9freebsd"
platform: "linux"
package: "freebsd-manpages"
version: "12.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pmap_map/9freebsd"
---

# pmap\_map(9freebsd)

map a physical memory range into kernel virtual address (KVA) space

## NAME

**pmap\_map** – map a physical memory range into kernel virtual address (KVA) space

## SYNOPSIS

**#include \<sys/param.h\>**

**#include \<vm/vm.h\>**

**#include \<vm/pmap.h\>**

*vm\_offset\_t*\

**pmap\_map**(*vm\_offset\_t \*virt*, *vm\_paddr\_t start*, *vm\_paddr\_t end*, *int prot*);

## DESCRIPTION

The **pmap\_map**() function maps a range of physical addresses into kernel virtual address (KVA) space, from *start* to *end*, with protection bits *prot*.

The value passed in *\*virt* is treated as a hint for the virtual address of the beginning of the mapping.

## IMPLEMENTATION NOTES

The *prot* argument is currently ignored by machine-dependent implementations.

Architectures which can support a direct mapped physical to virtual region can return the appropriate address within that region, leaving *\*virt* unchanged.

## RETURN VALUES

The **pmap\_map**() function returns the virtual address of the beginning of the mapping, if the mapping was successfully made; *\*virt* will also be updated with the first usable address after the mapped region.

If the function is unsuccessful, NULL is returned.

## SEE ALSO

[pmap(9)](/pmap/9.md)

## AUTHORS

This manual page was written by Bruce M Simpson ⟨*bms@spc.org*⟩.