MIGRATEPAGES(8) Linux Administrator's Manual MIGRATEPAGES(8)
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 at-
tempt 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. mi-
gratepages is under the GNU General Public License, v.2
SEE ALSO
numactl(8) , set_mempolicy(2) , get_mempolicy(2) , mbind(2) ,
sched_setaffinity(2) , sched_getaffinity(2) , proc(5) , ftok(3) ,
shmat(2) , taskset(1)
SGI Jan 2005 MIGRATEPAGES(8)
Generated by dwww version 1.16 on Tue Dec 16 16:27:13 CET 2025.