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 2010-06-11 "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 .sp
  34 \fI\-lnuma\fP ¤È¥ê¥ó¥¯¤¹¤ë¡£
  35 .SH ÀâÌÀ
  36 .BR move_pages ()
  37 ¤Ï¡¢¥×¥í¥»¥¹
  38 .I pid
  39 ¤Î»ØÄê¤µ¤ì¤¿¥Ú¡¼¥¸
  40 .I pages
  41 ¤ò
  42 .I nodes
  43 ¤Ç»ØÄê¤µ¤ì¤¿¥á¥â¥ê¥Î¡¼¥É¤Ë°ÜÆ°¤¹¤ë¡£
  44 °ÜÆ°¤Î·ë²Ì¤Ï
  45 .I status
  46 ¤ËÈ¿±Ç¤µ¤ì¤ë¡£
  47 .I flags
  48 ¤Ç¤Ï°ÜÆ°¤µ¤ì¤ë¥Ú¡¼¥¸¤Ë´Ø¤¹¤ëÀ©Ìó¤ò»ØÄê¤¹¤ë¡£
  49
  50 .I pid
  51 ¤Ï¡¢°ÜÆ°¤µ¤ì¤ë¥Ú¡¼¥¸¤¬Â°¤¹¤ë¥×¥í¥»¥¹¤Î ID ¤Ç¤¢¤ë¡£
  52 ÊÌ¤Î¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Ë¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤¬ÆÃ¸¢
  53 .RB ( CAP_SYS_NICE )
  54 ¤ò»ý¤Ã¤Æ¤¤¤ë¤«¡¢¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Î¼Â¥æ¡¼¥¶ ID ¤«¼Â¸ú¥æ¡¼¥¶ ID ¤¬
  55 ¥Ú¡¼¥¸°ÜÆ°ÂÐ¾Ý¤Î¥×¥í¥»¥¹¤Î¼Â¥æ¡¼¥¶ ID ¤«ÊÝÂ¸ set-user-ID ¤Î¤É¤Á¤é¤«¤È
  56 °ìÃ×¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  57 .I pid
  58 ¤¬ 0 ¤Î¾ì¹ç¡¢
  59 .BR move_pages ()
  60 ¤Ï¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¡£
  61
  62 .I count
  63 ¤Ï°ÜÆ°¤¹¤ë¥Ú¡¼¥¸¿ô¤Ç¤¢¤ë¡£
  64 .I count
  65 ¤Ë¤è¤ê
  66 .IR pages ,
  67 .IR nodes ,
  68 .I status
  69 ¤Î 3 ¤Ä¤ÎÇÛÎó¤ÎÂç¤¤µ¤¬ÄêµÁ¤µ¤ì¤ë¡£
  70
  71 .I pages
  72 ¤Ï¡¢°ÜÆ°¤¹¤Ù¤¥Ú¡¼¥¸¤Ø¤Î¥Ý¥¤¥ó¥¿¤ÎÇÛÎó¤Ç¤¢¤ê¡¢
  73 ³Æ¥Ý¥¤¥ó¥¿¤Ï¥Ú¡¼¥¸¶³¦¤ËÂ·¤¨¤¿ÃÍ¤ò»ØÄê¤¹¤Ù¤¤Ç¤¢¤ë¡£
  74 .\" FIXME what if they are not aligned?
  75 .I pid
  76 ¤Ç»ØÄê¤µ¤ì¤¿¥×¥í¥»¥¹¤Ç¸«¤¨¤ë¥¢¥É¥ì¥¹¤ò»ØÄê¤¹¤ë¡£
  77
  78 .I nodes
  79 ¤Ï¡¢³Æ¥Ú¡¼¥¸¤Î´õË¾¤Î°ÜÆ°¾ì½ê¤ò¼¨¤¹À°¿ôÃÍ¤ÎÇÛÎó¤Ç¤¢¤ê¡¢
  80 ÇÛÎó¤Î³ÆÍ×ÁÇ¤Ï¥Î¡¼¥ÉÈÖ¹æ¤Ç¤¢¤ë¡£
  81 .I nodes
  82 ¤Ë¤Ï NULL ¤ò»ØÄê¤¹¤ë¤³¤È¤â¤Ç¤¡¢¤³¤Î¾ì¹ç¤Ë¤Ï
  83 .BR move_pages ()
  84 ¤Ï¤É¤Î¥Ú¡¼¥¸¤â°ÜÆ°¤·¤Ê¤¤¤¬¡¢³Æ¥Ú¡¼¥¸¤¬¸½ºßÇÛÃÖ¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤òÇÛÎó
  85 .I status
  86 ¤Ë³ÊÇ¼¤·¤ÆÊÖ¤¹¡£¤É¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ëÉ¬Í×¤¬¤¢¤ë¤«¤òÈ½ÃÇ¤¹¤ë¤¿¤á¤Ë¡¢
  87 ³Æ¥Ú¡¼¥¸¤Î¾õÂÖ¤Î¼èÆÀ¤¬É¬Í×¤Ê¾ì¹ç¤â¤¢¤ë¡£
  88
  89 .I status
  90 ¤Ï¡¢³Æ¥Ú¡¼¥¸¤Î¾õÂÖ¤òÉ½¤¹À°¿ôÃÍ¤ÎÇÛÎó¤Ç¤¢¤ë¡£
  91 ¤³¤ÎÇÛÎó¤ËÍ¸ú¤ÊÃÍ¤¬³ÊÇ¼¤µ¤ì¤ë¤Î¤Ï¡¢
  92 .BR move_pages ()
  93 ¤¬¥¨¥é¡¼¤òÊÖ¤µ¤Ê¤«¤Ã¤¿¾ì¹ç¤À¤±¤Ç¤¢¤ë¡£
  94
  95 .I flags
  96 ¤Ë¤Ï¡¢¤É¤Î¼ïÎà¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤«¤ò»ØÄê¤¹¤ë¡£
  97 .B MPOL_MF_MOVE
  98 ¤Ï¡¢¤½¤Î¥×¥í¥»¥¹¤¬ÇÓÂ¾Åª¤Ë»ÈÍÑ¤·¤Æ¤¤¤ë¥Ú¡¼¥¸¤À¤±¤ò°ÜÆ°¤¹¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
  99 .B MPOL_MF_MOVE_ALL
 100 ¤Ï¡¢Ê£¿ô¤Î¥×¥í¥»¥¹´Ö¤Ç¶¦Í¤µ¤ì¤Æ¤¤¤ë¥Ú¡¼¥¸¤â°ÜÆ°¤Ç¤¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
 101 .B MPOL_MF_MOVE_ALL
 102 ¤ò»ÈÍÑ¤¹¤ë¤¿¤á¤Ë¤Ï¡¢¤½¤Î¥×¥í¥»¥¹¤¬ÆÃ¸¢
 103 .RB ( CAP_SYS_NICE )
 104 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 105 .SH status ÇÛÎó¤Ë³ÊÇ¼¤µ¤ì¤ë¥Ú¡¼¥¸¾õÂÖ
 106 .I status
 107 ÇÛÎó¤Î³ÆÍ×ÁÇ¤È¤·¤Æ¡¢°Ê²¼¤ÎÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
 108 .TP
 109 .B 0..MAX_NUMNODES
 110 ¤½¤Î¥Ú¡¼¥¸¤¬ÇÛÃÖ¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤ò¼¨¤¹¡£
 111 .TP
 112 .B -EACCES
 113 ¤½¤Î¥Ú¡¼¥¸¤ÏÊ£¿ô¤Î¥×¥í¥»¥¹¤Ë¤è¤ê¥Þ¥Ã¥×¤µ¤ì¤Æ¤ª¤ê¡¢
 114 .B MPOL_MF_MOVE_ALL
 115 ¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¤Ë¤Î¤ß°ÜÆ°¤Ç¤¤ë¡£
 116 .TP
 117 .B -EBUSY
 118 ¤½¤Î¥Ú¡¼¥¸¤¬¸½ºß¥Ó¥¸¡¼¤Ç¤¢¤ê¡¢°ÜÆ°¤Ç¤¤Ê¤¤¡£¸å¤Ç¤â¤¦°ìÅÙ»î¤¹¤³¤È¡£
 119 ¤³¤Î¾õ¶·¤Ï¡¢¥Ú¡¼¥¸¤¬ I/O ¤Î¼Â¹ÔÃæ¤Ç¤¢¤Ã¤¿¤ê¡¢¥«¡¼¥Í¥ë¤ÎÂ¾¤Î¥µ¥Ö¥·¥¹¥Æ¥à
 120 ¤¬¤½¤Î¥Ú¡¼¥¸¤Ø¤Î»²¾È¤òÊÝ»ý¤·¤Æ¤¤¤ë¾ì¹ç¤ËÈ¯À¸¤¹¤ë¡£
 121 .TP
 122 .B -EFAULT
 123 ¤½¤Î¥Ú¡¼¥¸¤¬ zero page ¤Ç¤¢¤ë¤«¡¢¤½¤Î¥á¥â¥êÎÎ°è¤Ï¤½¤Î¥×¥í¥»¥¹¤Ë¤è¤ê
 124 ¥Þ¥Ã¥×¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 125 .TP
 126 .B -EIO
 127 ¥Ú¡¼¥¸¤ò½ñ¤Ìá¤¹ (write back) ¤³¤È¤¬¤Ç¤¤Ê¤¤¡£
 128 ¥Ú¡¼¥¸¤¬ dirty ¤Ç¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬ dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤Ç¤¤ë¤è¤¦¤Ê
 129 °ÜÆ°µ¡Ç½¤òÄó¶¡¤·¤Æ¤¤¤Ê¤¤¤¿¤á¡¢¤½¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Ë¤Ï¥Ú¡¼¥¸¤ò
 130 ½ñ¤Ìá¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 131 .TP
 132 .B -EINVAL
 133 dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤Ç¤¤Ê¤¤¡£
 134 ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬ dirty ¤Ê¥Ú¡¼¥¸¤ò°ÜÆ°¤¹¤ë¤¿¤á¤Îµ¡Ç½¤òÄó¶¡¤·¤Æ¤ª¤é¤º¡¢
 135 ¥Ú¡¼¥¸¤ò½ñ¤Ìá¤¹Ç½ÎÏ¤â¤Ê¤¤¡£
 136 .TP
 137 .B -ENOENT
 138 ¥Ú¡¼¥¸¤¬Â¸ºß¤·¤Ê¤¤¡£
 139 .TP
 140 .B -ENOMEM
 141 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Ç¥á¥â¥ê¤ò³ÎÊÝ¤¹¤ë¤³¤È¤¬¤Ç¤¤Ê¤¤¡£
 142 .SH ÊÖ¤êÃÍ
 143 À®¸ù¤¹¤ë¤È¡¢
 144 .BR move_pages ()
 145 ¤Ï 0 ¤òÊÖ¤¹¡£
 146 .\" FIXME Is the following quite true: does the wrapper in numactl
 147 .\" do the right thing?
 148 ¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
 149 .I errno
 150 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
 151 .SH ¥¨¥é¡¼
 152 .TP
 153 .B E2BIG
 154 °ÜÆ°¤¹¤Ù¤¥Ú¡¼¥¸¤¬Â¿²á¤®¤ë¡£
 155 .TP
 156 .B EACCES
 157 .\" FIXME Clarify "current cpuset".  Is that the cpuset of the caller
 158 .\" or the target?
 159 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Î¤¤¤º¤ì¤«¤¬¸½ºß¤Î CPU ½¸¹ç¤Ç¤Ïµö²Ä¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 160 .TP
 161 .B EFAULT
 162 ¥Ñ¥é¥á¡¼¥¿ÇÛÎó¤Ë¥¢¥¯¥»¥¹¤Ç¤¤Ê¤«¤Ã¤¿¡£
 163 .TP
 164 .B EINVAL
 165 .I flags
 166 ¤Ë
 167 .B MPOL_MF_MOVE
 168 ¤Ç¤â
 169 .B MPOL_MF_MOVE_ALL
 170 ¤Ç¤â¤Ê¤¤ÃÍ¤¬»ØÄê¤µ¤ì¤¿¤«¡¢¥«¡¼¥Í¥ë¥¹¥ì¥Ã¥É¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤µ¤»¤è¤¦¤È¤·¤¿¡£
 171 .TP
 172 .B ENODEV
 173 °ÜÆ°Àè¤Î¥Î¡¼¥É¤Î¤¤¤º¤ì¤«¤¬¥ª¥ó¥é¥¤¥ó¤Ç¤Ê¤¤¡£
 174 .TP
 175 .B ENOENT
 176 °ÜÆ°¤¬É¬Í×¤Ê¥Ú¡¼¥¸¤¬Á´¤¯¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¡£
 177 »ØÄê¤µ¤ì¤¿Á´¤Æ¤Î¥Ú¡¼¥¸¤¬¡¢¤¹¤Ç¤Ë°ÜÆ°Àè¤Î¥Î¡¼¥É¤ËÂ¸ºß¤¹¤ë¤«¡¢Â¸ºß¤·¤Ê¤¤¤«¡¢
 178 Ìµ¸ú¤Ê¥¢¥É¥ì¥¹¤Ç¤¢¤Ã¤¿¤«¡¢Ê£¿ô¤Î¥×¥í¥»¥¹¤Ë¤è¤Ã¤Æ¥Þ¥Ã¥×¤µ¤ì¤Æ¤¤¤Æ°ÜÆ°¤Ç¤
 179 ¤Ê¤«¤Ã¤¿¤«¡¢¤Î¤¤¤º¤ì¤«¤Ç¤¢¤Ã¤¿¡£
 180 .TP
 181 .B EPERM
 182 ¸Æ¤Ó½Ð¤·¸µ¤Ï
 183 .B MPOL_MF_MOVE_ALL
 184 ¤ò»ØÄê¤·¤¿¤¬¡¢½½Ê¬¤ÊÆÃ¸¢
 185 .RB ( CAP_SYS_NICE )
 186 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
 187 ¤Þ¤¿¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤¬Â¾¤Î¥æ¡¼¥¶¤ËÂ°¤¹¤ë¥×¥í¥»¥¹¤Î¥Ú¡¼¥¸¤ò°ÜÆ°¤·¤è¤¦¤È¤·¤¿¤¬¡¢
 188 ¤½¤ì¤ò¹Ô¤¨¤ë¤À¤±¤ÎÆÃ¸¢
 189 .RB ( CAP_SYS_NICE )
 190 ¤ò»ý¤Ã¤Æ¤¤¤Ê¤«¤Ã¤¿¡£
 191 .TP
 192 .B ESRCH
 193 ¥×¥í¥»¥¹¤¬Â¸ºß¤·¤Ê¤¤¡£
 194 .SH ¥Ð¡¼¥¸¥ç¥ó
 195 .BR move_pages ()
 196 ¤Ï¡¢¥Ð¡¼¥¸¥ç¥ó 2.6.18 ¤Ç½é¤á¤Æ Linux ¤ËÅÐ¾ì¤·¤¿¡£
 197 .SH ½àµò
 198 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¸ÇÍ¤Ç¤¢¤ë¡£
 199 .SH Ãí°Õ
 200 ¥é¥¤¥Ö¥é¥ê¤Ë¤è¤ë¥µ¥Ý¡¼¥È¤Ë¤Ä¤¤¤Æ¤Ï
 201 .BR numa (7)
 202 ¤ò»²¾È¡£
 203
 204 .\" FIXME Clarify "current cpuset".  Is that the cpuset of the caller
 205 .\" or the target?
 206 ¸½ºß¤Î CPU ½¸¹ç¤Çµö²Ä¤µ¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤Î½¸¹ç¤ò¼èÆÀ¤¹¤ë¤Ë¤Ï¡¢¥Õ¥é¥°
 207 .B MPOL_F_MEMS_ALLOWED
 208 ¤ò»ØÄê¤·¤Æ
 209 .BR get_mempolicy (2)
 210 ¤ò»ÈÍÑ¤¹¤ì¤Ð¤è¤¤¡£
 211 ¼èÆÀ¤·¤¿¾ðÊó¤Ï¡¢CPU ½¸¹ç¤Î¼êÆ°¤Þ¤¿¤Ï¼«Æ°¤Ç¤ÎºÆ¹½À®¤Ë¤è¤ê
 212 ¤¤¤Ä²¿»þÊÑ²½¤·¤Æ¤·¤Þ¤¦¤«Ê¬¤«¤é¤Ê¤¤¡£
 213
 214 ¤³¤Î´Ø¿ô¤ò»ÈÍÑ¤¹¤ë¤È¡¢¥Ú¡¼¥¸¤Î°ÌÃÖ (¥Î¡¼¥É) ¤¬
 215 »ØÄê¤µ¤ì¤¿¥¢¥É¥ì¥¹¤ËÂÐ¤·¤ÆÀßÄê¤µ¤ì¤¿¥á¥â¥ê¥Ý¥ê¥·¡¼
 216 .RB ( mbind (2)
 217 »²¾È) ¤ä»ØÄê¤µ¤ì¤¿¥×¥í¥»¥¹¤ËÂÐ¤·¤ÆÀßÄê¤µ¤ì¤¿¥á¥â¥ê¥Ý¥ê¥·¡¼
 218 .RB ( set_mempolicy (2)
 219 »²¾È) ¤Ë°ãÈ¿¤·¤Æ¤·¤Þ¤¦²ÄÇ½À¤¬¤¢¤ë¡£
 220 ¤Ä¤Þ¤ê¡¢¥á¥â¥ê¥Ý¥ê¥·¡¼¤Ï
 221 .BR move_pages ()
 222 ¤Ç»È¤ï¤ì¤ë°ÜÆ°Àè¥Î¡¼¥É¤òÀ©¸Â¤·¤Ê¤¤¤È¤¤¤¦¤³¤È¤Ç¤¢¤ë¡£
 223
 224 ¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë
 225 .I <numaif.h>
 226 ¤Ï glibc ¤Ë¤Ï´Þ¤Þ¤ì¤Æ¤ª¤é¤º¡¢
 227 .I libnuma-devel
 228 ¤«Æ±ÍÍ¤Î¥Ñ¥Ã¥±¡¼¥¸¤ò¥¤¥ó¥¹¥È¡¼¥ë¤¹¤ëÉ¬Í×¤¬¤¢¤ë¡£
 229 .SH ´ØÏ¢¹àÌÜ
 230 .BR get_mempolicy (2),
 231 .BR mbind (2),
 232 .BR set_mempolicy (2),
 233 .BR numa (3),
 234 .BR numa_maps (5),
 235 .BR cpuset (7),
 236 .BR numa (7),
 237 .BR migratepages (8),
 238 .BR numa_stat (8)