---
name: "vm_map_clean"
section: "9"
platform: "linux"
package: "freebsd-manpages"
version: "6.0-5"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/vm_map_clean"
---

# vm\_map\_clean(9)

push dirty pages to their pager

## NAME

**vm\_map\_clean** – push dirty pages to their pager

## SYNOPSIS

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

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

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

*int*\

**vm\_map\_clean**(*vm\_map\_t map*, *vm\_offset\_t start*, *vm\_offset\_t end*, *boolean\_t syncio*, *boolean\_t invalidate*);

## DESCRIPTION

The **vm\_map\_clean**() function forces any dirty cached pages in the range *start* to *end* within the *map* to be pushed to their underlying pager.

If *syncio* is TRUE, dirty pages are written synchronously.

If *invalidate* is TRUE, any cached pages are also freed.

The range provided must be contiguous, it MUST NOT contain holes. The range provided MUST NOT contain any sub-map entries.

## IMPLEMENTATION NOTES

This routine holds the *Giant* lock to prevent multiple entry.

## RETURN VALUES

The **vm\_map\_clean**() function returns KERN\_SUCCESS if successful.

Otherwise, KERN\_INVALID\_ADDRESS will be returned if the function encountered a sub-map entry; KERN\_INVALID\_ARGUMENT will be returned if the function encountered a hole in the region provided, or if an entry could not be found for the given start address.

## SEE ALSO

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

## AUTHORS

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