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

# vm\_page\_rename(9freebsd)

move a page

## NAME

**vm\_page\_rename** – move a page

## SYNOPSIS

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

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

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

*void*\

**vm\_page\_rename**(*vm\_page\_t m*, *vm\_object\_t new\_object*, *vm\_pindex\_t new\_pindex*);

## DESCRIPTION

The **vm\_page\_rename**() function removes a page from one object, and adds it to another at the given page index. The page is added to the given object, and is removed from the object that is currently associated with. If the page is currently on the cache queue it will be deactivated unless it is wired or unmanaged, in which case the deactivation will fail. The entire page is marked as dirty after the move.

The arguments to **vm\_page\_rename**() are:

- *m*

  The page to move.

- *new\_object*

  The object the page should be inserted into.

- *new\_pindex*

  The page index into *new\_object* at which the new page should be inserted.

## AUTHORS

This manual page was written by Chad David ⟨*davidc@acns.ab.ca*⟩.