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

# vm\_map\_unlock\_read(9freebsd)

vm\_map locking macros

Part of [vm\_map\_lock(9freebsd)](/vm_map_lock/9freebsd.md).

## NAME

**vm\_map\_lock**, **vm\_map\_unlock**, **vm\_map\_lock\_read**, **vm\_map\_unlock\_read**, **vm\_map\_trylock**, **vm\_map\_trylock\_read**, **vm\_map\_lock\_upgrade**, **vm\_map\_lock\_downgrade** – vm\_map locking macros

## SYNOPSIS

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

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

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

*void*\

**vm\_map\_lock**(*vm\_map\_t map*);

*void*\

**vm\_map\_unlock**(*vm\_map\_t map*);

*void*\

**vm\_map\_lock\_read**(*vm\_map\_t map*);

*void*\

**vm\_map\_unlock\_read**(*vm\_map\_t map*);

*int*\

**vm\_map\_trylock**(*vm\_map\_t map*);

*int*\

**vm\_map\_trylock\_read**(*vm\_map\_t map*);

*int*\

**vm\_map\_lock\_upgrade**(*vm\_map\_t map*);

*int*\

**vm\_map\_lock\_downgrade**(*vm\_map\_t map*);

## DESCRIPTION

The **vm\_map\_lock**() macro obtains an exclusive lock on *map*.

The **vm\_map\_unlock**() macro releases an exclusive lock on *map*.

The **vm\_map\_lock\_read**() macro obtains a read-lock on *map*.

The **vm\_map\_unlock\_read**() macro releases a read-lock on *map*.

The **vm\_map\_trylock**() macro attempts to obtain an exclusive lock on *map*. It returns FALSE if the lock cannot be immediately acquired; otherwise return TRUE with the lock acquired.

The **vm\_map\_trylock\_read**() macro attempts to obtain a read-lock on *map*. It returns FALSE if the lock cannot be immediately acquired; otherwise return TRUE with the lock acquired.

The **vm\_map\_lock\_upgrade**() macro attempts to atomically upgrade a read-lock on *map* to an exclusive lock.

The **vm\_map\_lock\_downgrade**() macro attempts to downgrade an exclusive lock on *map* to a read-lock.

## IMPLEMENTATION NOTES

Currently, all of the locking macros implement their locks as sleep locks.

## SEE ALSO

[vm\_map(9)](/vm_map/9.md)

## AUTHORS

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