---
name: "migratepages"
section: "8"
platform: "linux"
package: "numactl"
version: "2.0.19-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/migratepages"
---

# migratepages(8)

Migrate the physical location a processes pages

## NAME

migratepages - Migrate the physical location a processes pages

## SYNOPSIS

**migratepages** pid from-nodes to-nodes

## DESCRIPTION

**migratepages** moves the physical location of a processes pages without any changes of the virtual address space of the process. Moving the pages allows one to change the distances of a process to its memory. Performance may be optimized by moving a processes pages to the node where it is executing.

If multiple nodes are specified for from-nodes or to-nodes then an attempt is made to preserve the relative location of each page in each nodeset.

For example if we move from nodes 2-5 to 7,9,12-13 then the preferred mode of operation is to move pages from 2-\>7, 3-\>9, 4-\>12 and 5-\>13. However, this is only posssible if enough memory is available.

- Valid node specifiers

  | | |
  | --- | --- |
  | all | All nodes |
  | number | Node number |
  | number1{,number2} | Node number1 and Node number2 |
  | number1-number2 | Nodes from number1 to number2 |
  | ! nodes | Invert selection of the following specification. |

## NOTES

Requires a NUMA policy aware kernel with support for page migration (linux 2.6.16 and later).

migratepages will only move pages that are not shared with other processes if called by a user without administrative priviledges (but with the right to modify the process).

migratepages will move all pages if invoked from root (or a user with administrative priviledges).

## FILES

*/proc/\<pid\>/numa\_maps* for information about the NUMA memory use of a process.

## COPYRIGHT

Copyright 2005-2006 Christoph Lameter, Silicon Graphics, Inc. migratepages is under the GNU General Public License, v.2

## SEE ALSO

*[numactl(8)](/numactl/8.md)* , *[set\_mempolicy(2)](/set_mempolicy/2.md)* , *[get\_mempolicy(2)](/get_mempolicy/2.md)* , *[mbind(2)](/mbind/2.md)* , *[sched\_setaffinity(2)](/sched_setaffinity/2.md)* ,  *[sched\_getaffinity(2)](/sched_getaffinity/2.md)* , *[proc(5)](/proc/5.md)* ,  *[ftok(3)](/ftok/3.md)* , *[shmat(2)](/shmat/2.md)* , *[taskset(1)](/taskset/1.md)*