1MIGRATEPAGES(8)          Linux Administrator's Manual          MIGRATEPAGES(8)
2
3
4

NAME

6       migratepages - Migrate the physical location a processes pages
7

SYNOPSIS

9       migratepages pid from-nodes to-nodes
10

DESCRIPTION

12       migratepages  moves  the physical location of a processes pages without
13       any changes of the virtual address space of  the  process.  Moving  the
14       pages  allows  one  to change the distances of a process to its memory.
15       Performance may be optimized by moving a processes pages  to  the  node
16       where it is executing.
17
18       If  multiple nodes are specified for from-nodes or to-nodes then an at‐
19       tempt is made to preserve the relative location of each  page  in  each
20       nodeset.
21
22       For  example  if we move from nodes 2-5 to 7,9,12-13 then the preferred
23       mode of operation is to move pages from 2->7, 3->9,  4->12  and  5->13.
24       However, this is only posssible if enough memory is available.
25
26       Valid node specifiers
27
28              all                 All nodes
29              number              Node number
30              number1{,number2}   Node number1 and Node number2
31              number1-number2     Nodes from number1 to number2
32              ! nodes             Invert selection of the following specification.
33

NOTES

35       Requires  a  NUMA  policy  aware kernel with support for page migration
36       (linux 2.6.16 and later).
37
38       migratepages will only move pages that are not shared with  other  pro‐
39       cesses if called by a user without administrative priviledges (but with
40       the right to modify the process).
41
42       migratepages will move all pages if invoked from root (or a  user  with
43       administrative priviledges).
44
45

FILES

47       /proc/<pid>/numa_maps  for  information  about the NUMA memory use of a
48       process.
49
51       Copyright 2005-2006 Christoph  Lameter,  Silicon  Graphics,  Inc.   mi‐
52       gratepages is under the GNU General Public License, v.2
53
54

SEE ALSO

56       numactl(8)   ,   set_mempolicy(2)   ,  get_mempolicy(2)  ,  mbind(2)  ,
57       sched_setaffinity(2) ,  sched_getaffinity(2)  ,  proc(5)  ,  ftok(3)  ,
58       shmat(2) , taskset(1)
59
60
61
62
63SGI                                Jan 2005                    MIGRATEPAGES(8)
Impressum