Manual: migratepages

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 ad‐
       dress 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 avail‐
       able.

       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  with‐
       out 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//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) , set_mempolicy(2) , get_mempolicy(2) , mbind(2) , sched_setaffinity(2) ,  sched_getaffin‐
       ity(2) , proc(5) , ftok(3) , shmat(2) , taskset(1)

SGI						  Jan 2005				     MIGRATEPAGES(8)