manual/LDP_man-pages/release/man2/move_pages.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" This manpage is Copyright (C) 2006 Silicon Graphics, Inc.
   4 .\"                               Christoph Lameter
   5 .\"
   6 .\" Permission is granted to make and distribute verbatim copies of this
   7 .\" manual provided the copyright notice and this permission notice are
   8 .\" preserved on all copies.
   9 .\"
  10 .\" Permission is granted to copy and distribute modified versions of this
  11 .\" manual under the conditions for verbatim copying, provided that the
  12 .\" entire resulting derived work is distributed under the terms of a
  13 .\" permission notice identical to this one.
  14 .\"
  15 .\" FIXME Should programs normally be using this API directly, or should
  16 .\" they rather be using interfaces in the numactl package?
  17 .\" (e.g., compare with recommendation in mbind(2)).
  18 .\"
  19 .\" Japanese Version Copyright (c) 2008  Akihiro MOTOKI
  20 .\"         all rights reserved.
  21 .\" Translated 2008-10-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  22 .\"
  23 .TH MOVE_PAGES 2 2008-10-06 "Linux" "Linux Programmer's Manual"
  24 .SH Ì¾Á°
  25 move_pages \- ¤¢¤ë¥×¥í¥»¥¹¤Î¸Ä¡¹¤Î¥Ú¡¼¥¸¤òÊÌ¤Î¥Î¡¼¥É¤Ë°ÜÆ°¤¹¤ë
  26 .SH ½ñ¼°
  27 .nf
  28 .B #include <numaif.h>
  29 .sp
  30 .BI "long move_pages(int " pid ", unsigned long count, void **" pages ,
  31 .BI "                const int *" nodes ", int *" status ", int " flags );
  32 .fi
  33 .SH ÀâÌÀ
  34 .BR move_pages ()
  35 ¤Ï¡¢¥×¥í¥»¥¹
  36 .I pid
  37 ¤Î»ØÄê¤µ¤ì¤¿¥Ú¡¼¥¸
  38 .I pages
  39 ¤ò
  40 .I nodes
  41 ¤Ç»ØÄê¤µ¤ì¤¿¥á¥â¥ê¥Î¡¼¥É¤Ë°ÜÆ°¤¹¤ë¡£
  42 °ÜÆ°¤Î·ë²Ì¤Ï
  43 .I status
  44 ¤ËÈ¿±Ç¤µ¤ì¤ë¡£
  45 .I flags
  46 ¤Ç¤Ï°ÜÆ°¤µ¤ì¤ë¥Ú¡¼¥¸¤Ë´Ø¤¹¤ëÀ©Ìó¤ò»ØÄê¤¹¤ë¡£
  47
  48 .I pid
  49 ¤Ï¡¢°ÜÆ°¤µ¤ì¤ë¥Ú¡¼¥¸¤¬Â°¤¹¤ë¥×¥í¥»¥¹¤Î ID ¤Ç¤¢¤ë¡£
  50 ÊÌ¤Î¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Ë¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤¬ÆÃ¸¢
  51 .RB ( CAP_SYS_NICE )
  52 ¤ò»ý¤Ã¤Æ¤¤¤ë¤«¡¢¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Î¼Â¥æ¡¼¥¶ ID ¤«¼Â¸ú¥æ¡¼¥¶ ID ¤¬
  53 ¥Ú¡¼¥¸°ÜÆ°ÂÐ¾Ý¤Î¥×¥í¥»¥¹¤Î¼Â¥æ¡¼¥¶ ID ¤«ÊÝÂ¸ set-user-ID ¤Î¤É¤Á¤é¤«¤È
  54 °ìÃ×¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  55 .I pid
  56 ¤¬ 0 ¤Î¾ì¹ç¡¢
  57 .BR move_pages ()
  58 ¤Ï¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¡£
  59
  60 .I count
  61 ¤Ï°ÜÆ°¤¹¤ë¥Ú¡¼¥¸¿ô¤Ç¤¢¤ë¡£
  62 .I count
  63 ¤Ë¤è¤ê
  64 .IR pages ,
  65 .IR nodes ,
  66 .I status
  67 ¤Î 3 ¤Ä¤ÎÇÛÎó¤ÎÂç¤¤µ¤¬ÄêµÁ¤µ¤ì¤ë¡£
  68
  69 .I pages
  70 ¤Ï¡¢°ÜÆ°¤¹¤Ù¤¥Ú¡¼¥¸¤Ø¤Î¥Ý¥¤¥ó¥¿¤ÎÇÛÎó¤Ç¤¢¤ê¡¢
  71 ³Æ¥Ý¥¤¥ó¥¿¤Ï¥Ú¡¼¥¸¶³¦¤ËÂ·¤¨¤¿ÃÍ¤ò»ØÄê¤¹¤Ù¤¤Ç¤¢¤ë¡£
  72 .\" FIXME what if they are not aligned?
  73 .I pid
  74 ¤Ç»ØÄê¤µ¤ì¤¿¥×¥í¥»¥¹¤Ç¸«¤¨¤ë¥¢¥É¥ì¥¹¤ò»ØÄê¤¹¤ë¡£
  75
  76 .I nodes
  77 ¤Ï¡¢³Æ¥Ú¡¼¥¸¤Î´õË¾¤Î°ÜÆ°¾ì½ê¤ò¼¨¤¹À°¿ôÃÍ¤ÎÇÛÎó¤Ç¤¢¤ê¡¢
  78 ÇÛÎó¤Î³ÆÍ×ÁÇ¤Ï¥Î¡¼¥ÉÈÖ¹æ¤Ç¤¢¤ë¡£
  79 .I nodes
  80 ¤Ë¤Ï NULL ¤ò»ØÄê¤¹¤ë¤³¤È¤â¤Ç¤¡¢¤³¤Î¾ì¹ç¤Ë¤Ï
  81 .BR move_pages ()
  82 ¤Ï¤É¤Î¥Ú¡¼¥¸¤â°ÜÆ°¤·¤Ê¤¤¤¬¡¢³Æ¥Ú¡¼¥¸¤¬¸½ºßÇÛÃÖ¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤òÇÛÎó
  83 .I status
  84 ¤Ë³ÊÇ¼¤·¤ÆÊÖ¤¹¡£¤É¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ëÉ¬Í×¤¬¤¢¤ë¤«¤òÈ½ÃÇ¤¹¤ë¤¿¤á¤Ë¡¢
  85 ³Æ¥Ú¡¼¥¸¤Î¾õÂÖ¤Î¼èÆÀ¤¬É¬Í×¤Ê¾ì¹ç¤â¤¢¤ë¡£
  86
  87 .I status
  88 ¤Ï¡¢³Æ¥Ú¡¼¥¸¤Î¾õÂÖ¤òÉ½¤¹À°¿ôÃÍ¤ÎÇÛÎó¤Ç¤¢¤ë¡£
  89 ¤³¤ÎÇÛÎó¤ËÍ¸ú¤ÊÃÍ¤¬³ÊÇ¼¤µ¤ì¤ë¤Î¤Ï¡¢
  90 .BR move_pages ()
  91 ¤¬¥¨¥é¡¼¤òÊÖ¤µ¤Ê¤«¤Ã¤¿¾ì¹ç¤À¤±¤Ç¤¢¤ë¡£
  92
  93 .I flags
  94 ¤Ë¤Ï¡¢¤É¤Î¼ïÎà¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤«¤ò»ØÄê¤¹¤ë¡£
  95 .B MPOL_MF_MOVE
  96 ¤Ï¡¢¤½¤Î¥×¥í¥»¥¹¤¬ÇÓÂ¾Åª¤Ë»ÈÍÑ¤·¤Æ¤¤¤ë¥Ú¡¼¥¸¤À¤±¤ò°ÜÆ°¤¹¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
  97 .B MPOL_MF_MOVE_ALL
  98 ¤Ï¡¢Ê£¿ô¤Î¥×¥í¥»¥¹´Ö¤Ç¶¦Í¤µ¤ì¤Æ¤¤¤ë¥Ú¡¼¥¸¤â°ÜÆ°¤Ç¤¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
  99 .B MPOL_MF_MOVE_ALL
 100 ¤ò»ÈÍÑ¤¹¤ë¤¿¤á¤Ë¤Ï¡¢¤½¤Î¥×¥í¥»¥¹¤¬ÆÃ¸¢
 101 .RB ( CAP_SYS_NICE )
 102 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 103 .SH status ÇÛÎó¤Ë³ÊÇ¼¤µ¤ì¤ë¥Ú¡¼¥¸¾õÂÖ
 104 .I status
 105 ÇÛÎó¤Î³ÆÍ×ÁÇ¤È¤·¤Æ¡¢°Ê²¼¤ÎÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
 106 .TP
 107 .B 0..MAX_NUMNODES
 108 ¤½¤Î¥Ú¡¼¥¸¤¬ÇÛÃÖ¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤ò¼¨¤¹¡£
 109 .TP
 110 .B -EACCES
 111 ¤½¤Î¥Ú¡¼¥¸¤ÏÊ£¿ô¤Î¥×¥í¥»¥¹¤Ë¤è¤ê¥Þ¥Ã¥×¤µ¤ì¤Æ¤ª¤ê¡¢
 112 .B MPOL_MF_MOVE_ALL
 113 ¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¤Ë¤Î¤ß°ÜÆ°¤Ç¤¤ë¡£
 114 .TP
 115 .B -EBUSY
 116 ¤½¤Î¥Ú¡¼¥¸¤¬¸½ºß¥Ó¥¸¡¼¤Ç¤¢¤ê¡¢°ÜÆ°¤Ç¤¤Ê¤¤¡£¸å¤Ç¤â¤¦°ìÅÙ»î¤¹¤³¤È¡£
 117 ¤³¤Î¾õ¶·¤Ï¡¢¥Ú¡¼¥¸¤¬ I/O ¤Î¼Â¹ÔÃæ¤Ç¤¢¤Ã¤¿¤ê¡¢¥«¡¼¥Í¥ë¤ÎÂ¾¤Î¥µ¥Ö¥·¥¹¥Æ¥à
 118 ¤¬¤½¤Î¥Ú¡¼¥¸¤Ø¤Î»²¾È¤òÊÝ»ý¤·¤Æ¤¤¤ë¾ì¹ç¤ËÈ¯À¸¤¹¤ë¡£
 119 .TP
 120 .B -EFAULT
 121 ¤½¤Î¥Ú¡¼¥¸¤¬ zero page ¤Ç¤¢¤ë¤«¡¢¤½¤Î¥á¥â¥êÎÎ°è¤Ï¤½¤Î¥×¥í¥»¥¹¤Ë¤è¤ê
 122 ¥Þ¥Ã¥×¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 123 .TP
 124 .B -EIO
 125 ¥Ú¡¼¥¸¤ò½ñ¤Ìá¤¹ (write back) ¤³¤È¤¬¤Ç¤¤Ê¤¤¡£
 126 ¥Ú¡¼¥¸¤¬ dirty ¤Ç¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬ dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤Ç¤¤ë¤è¤¦¤Ê
 127 °ÜÆ°µ¡Ç½¤òÄó¶¡¤·¤Æ¤¤¤Ê¤¤¤¿¤á¡¢¤½¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Ë¤Ï¥Ú¡¼¥¸¤ò
 128 ½ñ¤Ìá¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 129 .TP
 130 .B -EINVAL
 131 dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤Ç¤¤Ê¤¤¡£
 132 ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬ dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Îµ¡Ç½¤òÄó¶¡¤·¤Æ¤ª¤é¤º¡¢
 133 ¥Ú¡¼¥¸¤ò½ñ¤Ìá¤¹Ç½ÎÏ¤â¤Ê¤¤¡£
 134 .TP
 135 .B -ENOENT
 136 ¥Ú¡¼¥¸¤¬Â¸ºß¤·¤Ê¤¤¡£
 137 .TP
 138 .B -ENOMEM
 139 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Ç¥á¥â¥ê¤ò³ÎÊÝ¤¹¤ë¤³¤È¤¬¤Ç¤¤Ê¤¤¡£
 140 .SH ÊÖ¤êÃÍ
 141 À®¸ù¤¹¤ë¤È¡¢
 142 .BR move_pages ()
 143 ¤Ï 0 ¤òÊÖ¤¹¡£
 144 .\" FIXME Is the following quite true: does the wrapper in numactl
 145 .\" do the right thing?
 146 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
 147 .I errno
 148 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
 149 .SH ¥¨¥é¡¼
 150 .TP
 151 .B E2BIG
 152 °ÜÆ°¤¹¤Ù¤¥Ú¡¼¥¸¤¬Â¿²á¤®¤ë¡£
 153 .TP
 154 .B EACCES
 155 .\" FIXME Clarify "current cpuset".  Is that the cpuset of the caller
 156 .\" or the target?
 157 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Î¤¤¤º¤ì¤«¤¬¸½ºß¤Î CPU ½¸¹ç¤Ç¤Ïµö²Ä¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 158 .TP
 159 .B EFAULT
 160 ¥Ñ¥é¥á¡¼¥¿ÇÛÎó¤Ë¥¢¥¯¥»¥¹¤Ç¤¤Ê¤«¤Ã¤¿¡£
 161 .TP
 162 .B EINVAL
 163 .I flags
 164 ¤Ë
 165 .B MPOL_MF_MOVE
 166 ¤Ç¤â
 167 .B MPOL_MF_MOVE_ALL
 168 ¤Ç¤â¤Ê¤¤ÃÍ¤¬»ØÄê¤µ¤ì¤¿¤«¡¢¥«¡¼¥Í¥ë¥¹¥ì¥Ã¥É¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤µ¤»¤è¤¦¤È¤·¤¿¡£
 169 .TP
 170 .B ENODEV
 171 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Î¤¤¤º¤ì¤«¤¬¥ª¥ó¥é¥¤¥ó¤Ç¤Ê¤¤¡£
 172 .TP
 173 .B ENOENT
 174 °ÜÆ°¤¬É¬Í×¤Ê¥Ú¡¼¥¸¤¬Á´¤¯¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¡£
 175 »ØÄê¤µ¤ì¤¿Á´¤Æ¤Î¥Ú¡¼¥¸¤¬¡¢¤¹¤Ç¤Ë°ÜÆ°Àè¤Î¥Î¡¼¥É¤ËÂ¸ºß¤¹¤ë¤«¡¢Â¸ºß¤·¤Ê¤¤¤«¡¢
 176 Ìµ¸ú¤Ê¥¢¥É¥ì¥¹¤Ç¤¢¤Ã¤¿¤«¡¢Ê£¿ô¤Î¥×¥í¥»¥¹¤Ë¤è¤Ã¤Æ¥Þ¥Ã¥×¤µ¤ì¤Æ¤¤¤Æ°ÜÆ°¤Ç¤
 177 ¤Ê¤«¤Ã¤¿¤«¡¢¤Î¤¤¤º¤ì¤«¤Ç¤¢¤Ã¤¿¡£
 178 .TP
 179 .B EPERM
 180 ¸Æ¤Ó½Ð¤·¸µ¤Ï
 181 .B MPOL_MF_MOVE_ALL
 182 ¤ò»ØÄê¤·¤¿¤¬¡¢½½Ê¬¤ÊÆÃ¸¢
 183 .RB ( CAP_SYS_NICE )
 184 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
 185 ¤Þ¤¿¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤¬Â¾¤Î¥æ¡¼¥¶¤ËÂ°¤¹¤ë¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤·¤è¤¦¤È¤·¤¿¤¬¡¢
 186 ¤½¤ì¤ò¹Ô¤¨¤ë¤À¤±¤ÎÆÃ¸¢
 187 .RB ( CAP_SYS_NICE )
 188 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤«¤Ã¤¿¡£
 189 .TP
 190 .B ESRCH
 191 ¥×¥í¥»¥¹¤¬Â¸ºß¤·¤Ê¤¤¡£
 192 .SH ¥Ð¡¼¥¸¥ç¥ó
 193 .BR move_pages ()
 194 ¤Ï¡¢¥Ð¡¼¥¸¥ç¥ó 2.6.18 ¤Ç½é¤á¤Æ Linux ¤ËÅÐ¾ì¤·¤¿¡£
 195 .SH ½àµò
 196 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¸ÇÍ¤Ç¤¢¤ë¡£
 197 .SH Ãí°Õ
 198 ¥é¥¤¥Ö¥é¥ê¤Ë¤è¤ë¥µ¥Ý¡¼¥È¤Ë¤Ä¤¤¤Æ¤Ï
 199 .BR numa (7)
 200 ¤ò»²¾È¡£
 201
 202 .\" FIXME Clarify "current cpuset".  Is that the cpuset of the caller
 203 .\" or the target?
 204 ¸½ºß¤Î CPU ½¸¹ç¤Çµö²Ä¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤Î½¸¹ç¤ò¼èÆÀ¤¹¤ë¤Ë¤Ï¡¢¥Õ¥é¥°
 205 .B MPOL_F_MEMS_ALLOWED
 206 ¤ò»ØÄê¤·¤Æ
 207 .BR get_mempolicy (2)
 208 ¤ò»ÈÍÑ¤¹¤ì¤Ð¤è¤¤¡£
 209 ¼èÆÀ¤·¤¿¾ðÊó¤Ï¡¢CPU ½¸¹ç¤Î¼êÆ°¤Þ¤¿¤Ï¼«Æ°¤Ç¤ÎºÆ¹½À®¤Ë¤è¤ê
 210 ¤¤¤Ä²¿»þÊÑ²½¤·¤Æ¤·¤Þ¤¦¤«Ê¬¤«¤é¤Ê¤¤¡£
 211
 212 ¤³¤Î´Ø¿ô¤ò»ÈÍÑ¤¹¤ë¤È¡¢¥Ú¡¼¥¸¤Î°ÌÃÖ (¥Î¡¼¥É) ¤¬
 213 »ØÄê¤µ¤ì¤¿¥¢¥É¥ì¥¹¤ËÂÐ¤·¤ÆÀßÄê¤µ¤ì¤¿¥á¥â¥ê¥Ý¥ê¥·¡¼
 214 .RB ( mbind (2)
 215 »²¾È) ¤ä»ØÄê¤µ¤ì¤¿¥×¥í¥»¥¹¤ËÂÐ¤·¤ÆÀßÄê¤µ¤ì¤¿¥á¥â¥ê¥Ý¥ê¥·¡¼
 216 .RB ( set_mempolicy (2)
 217 »²¾È) ¤Ë°ãÈ¿¤·¤Æ¤·¤Þ¤¦²ÄÇ½À¤¬¤¢¤ë¡£
 218 ¤Ä¤Þ¤ê¡¢¥á¥â¥ê¥Ý¥ê¥·¡¼¤Ï
 219 .BR move_pages ()
 220 ¤Ç»È¤ï¤ì¤ë°ÜÆ°Àè¥Î¡¼¥É¤òÀ©¸Â¤·¤Ê¤¤¤È¤¤¤¦¤³¤È¤Ç¤¢¤ë¡£
 221 .SH ´ØÏ¢¹àÌÜ
 222 .BR get_mempolicy (2),
 223 .BR mbind (2),
 224 .BR set_mempolicy (2),
 225 .BR numa (3),
 226 .BR numa_maps (5),
 227 .BR cpuset (7),
 228 .BR numa (7),
 229 .BR migratepages (8),
 230 .BR numa_stat (8)