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  an  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)  ,  set_mempolicy(2)  ,  get_mempolicy(2)  ,  mbind(2) , sched_setaffinity(2) ,
       sched_getaffinity(2) , proc(5) , ftok(3) , shmat(2) , taskset(1)