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

   1 .\" Copyright 2003,2004 Andi Kleen, SuSE Labs.
   2 .\" and Copyright 2007 Lee Schermerhorn, Hewlett Packard
   3 .\"
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.
  17 .\"
  18 .\" Formatted or processed versions of this manual, if unaccompanied by
  19 .\" the source, must acknowledge the copyright and authors of this work.
  20 .\"
  21 .\" 2006-02-03, mtk, substantial wording changes and other improvements
  22 .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
  23 .\"     more precise specification of behavior.
  24 .\"
  25 .\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI
  26 .\"         all rights reserved.
  27 .\" Translated 2006-08-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.39
  28 .\" Updated 2008-02-13, Akihiro MOTOKI, LDP v2.77
  29 .\" Updated 2008-08-06, Akihiro MOTOKI, LDP v3.05
  30 .\" Updated 2008-08-21, Akihiro MOTOKI, LDP v3.07
  31 .\" Updated 2008-11-19, Akihiro MOTOKI, LDP v3.13
  32 .\"
  33 .TH GET_MEMPOLICY 2 2008-08-15 Linux "Linux Programmer's Manual"
  34 .SH Ì¾Á°
  35 get_mempolicy \- ¥×¥í¥»¥¹¤Î NUMA ¥á¥â¥ê¤Î¥Ý¥ê¥·¡¼¤ò¼èÆÀ¤¹¤ë
  36 .SH ½ñ¼°
  37 .nf
  38 .B "#include <numaif.h>"
  39 .sp
  40 .BI "int get_mempolicy(int *" mode ", unsigned long *" nodemask ,
  41 .BI "                  unsigned long " maxnode ", unsigned long " addr ,
  42 .BI "                  unsigned long " flags );
  43 .sp
  44 \fI\-lnuma\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
  45 .fi
  46 .SH ÀâÌÀ
  47 .BR get_mempolicy ()
  48 ¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤â¤·¤¯¤Ï»ØÄê¤µ¤ì¤¿¥á¥â¥ê¥¢¥É¥ì¥¹¤Î
  49 NUMA ¥Ý¥ê¥·¡¼¤ò
  50 .I flags
  51 ¤ÎÀßÄê¤Ë½¾¤Ã¤Æ¼èÆÀ¤¹¤ë¡£
  52
  53 NUMA (ÈóÂÐ¾Î¥á¥â¥ê¥¢¥¯¥»¥¹) ¥Þ¥·¥ó¤Ç¤Ï¡¢CPU ¤Ë¤è¤ê
  54 ¥á¥â¥ê¥³¥ó¥È¥í¡¼¥é¤¬°Û¤Ê¤ê¡¢µ÷Î¥¤â°Û¤Ê¤Ã¤Æ¤¤¤ë¡£
  55 ¥á¥â¥ê¥Ý¥ê¥·¡¼¤Ï¡¢¤É¤Î¥Î¡¼¥É¤«¤é¥á¥â¥ê¤ò¤½¤Î¥×¥í¥»¥¹¤Ë
  56 ³ä¤êÅö¤Æ¤ë¤«¤òÄê¤á¤ë¤â¤Î¤Ç¤¢¤ë¡£
  57
  58 .I flags
  59 ¤Ë 0 ¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢
  60 .RB ( set_mempolicy (2)
  61 ¤ÇÀßÄê¤µ¤ì¤¿)
  62 ¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥Ç¥Õ¥©¥ë¥È¥Ý¥ê¥·¡¼¤Ë´Ø¤¹¤ë¾ðÊó¤òÊÖ¤¹¡£
  63 ÊÖ¤µ¤ì¤¿¥Ý¥ê¥·¡¼
  64 .RI [ mode
  65 ¤È
  66 .IR nodemask ]
  67 ¤ò
  68 .BR set_mempolicy (2)
  69 ¤ËÅÏ¤¹¤³¤È¤Ç¡¢¤½¤Î¥×¥í¥»¥¹¤Î¥Ý¥ê¥·¡¼¤ò
  70 .BR get_mempolicy ()
  71 ¤ò¸Æ¤Ó½Ð¤·¤¿»þÅÀ¤Î¾õÂÖ¤ËÌá¤¹¤³¤È¤¬¤Ç¤¤ë¡£
  72
  73 .I flags
  74 ¤Ë
  75 .B MPOL_F_MEMS_ALLOWED
  76 (Linux 2.6.24 °Ê¹ß¤ÇÍøÍÑ²ÄÇ½) ¤ò»ØÄê¤¹¤ë¤È¡¢
  77 .I mode
  78 °ú¤¿ô¤ÏÌµ»ë¤µ¤ì¡¢
  79 ¤½¤Î¥×¥í¥»¥¹¤¬¤½¤Î¸å¤Î
  80 .BR mbind (2)
  81 ¤ä
  82 .BR set_mempolicy (2)
  83 ¤Ç
  84 .RI [ "¥â¡¼¥É¥Õ¥é¥°"
  85 ¤¬»ØÄê¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë ] »ØÄê¤Ç¤¤ë¥Î¡¼¥É (¥á¥â¥ê) ¤Î½¸¹ç¤¬
  86 .I nodemask
  87 ¤ËÊÖ¤µ¤ì¤ë¡£
  88 .B MPOL_F_MEMS_ALLOWED
  89 ¤ò¡¢
  90 .B MPOL_F_ADDR
  91 ¤ä
  92 .B MPOL_F_NODE
  93 ¤ÈÆ±»þ¤Ë»ØÄê¤¹¤ë¤³¤È¤Ï¤Ç¤¤Ê¤¤¡£
  94
  95 .I flags
  96 ¤Ë
  97 .B MPOL_F_ADDR
  98 ¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢
  99 .I addr
 100 ¤Ç»ØÄê¤µ¤ì¤¿¥á¥â¥ê¥¢¥É¥ì¥¹¤ËÅ¬ÍÑ¤µ¤ì¤Æ¤¤¤ë¥Ý¥ê¥·¡¼¤Ë´Ø¤¹¤ë¾ðÊó¤òÊÖ¤¹¡£
 101 .BR mbind (2)
 102 ¤ä
 103 .BR numa (3)
 104 ¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¥Ø¥ë¥Ñ¡¼´Ø¿ô¤ò»È¤Ã¤Æ¡¢
 105 .I addr
 106 ¤ò´Þ¤à¥á¥â¥êÎÎ°è¤ËÂÐ¤¹¤ë¥Ý¥ê¥·¡¼¤¬ÀßÄê¤µ¤ì¤Æ¤¤¤¿¾ì¹ç¤Ë¤Ï¡¢
 107 ÊÖ¤µ¤ì¤ë¥Ý¥ê¥·¡¼¤Ï¥×¥í¥»¥¹¤Î¥Ç¥Õ¥©¥ë¥È¥Ý¥ê¥·¡¼¤È°ã¤¦¤³¤È¤¬¤¢¤ë¡£
 108
 109 .I mode
 110 °ú¤¿ô¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç¡¢
 111 .BR get_mempolicy ()
 112 ¤ÏÍ×µá¤µ¤ì¤¿ NUMA ¥Ý¥ê¥·¡¼¤Î¥â¡¼¥É¤ÈÄÉ²Ã¤Î
 113 .I "¥â¡¼¥É¥Õ¥é¥°"
 114 ¤ò
 115 .I mode
 116 ¤¬»Ø¤¹¾ì½ê¤Ë³ÊÇ¼¤¹¤ë¡£
 117 .I nodemask
 118 ¤¬ NULL °Ê³°¤Î¾ì¹ç¡¢¤½¤Î¥Ý¥ê¥·¡¼¤ËÂÐ±þ¤¹¤ë¥Î¡¼¥É¥Þ¥¹¥¯¤ò
 119 ¤³¤Î°ú¤¿ô¤¬»Ø¤¹¾ì½ê¤Ë³ÊÇ¼¤¹¤ë¡£
 120 .I maxnode
 121 ¤Ë¤Ï
 122 .I nodemask
 123 ¤Ë³ÊÇ¼¤Ç¤¤ë¥Î¡¼¥É ID ¤Î¿ô¡¢¤Ä¤Þ¤êºÇÂç¥Î¡¼¥É ID ¤Ë 1 ¤òÂ¤·¤¿ÃÍ¤ò»ØÄê¤¹¤ë¡£
 124 .I maxnode
 125 ¤Ç»ØÄê¤µ¤ì¤¿ÃÍ¤Ï¾ï¤Ë
 126 .I sizeof(unsigned long)
 127 ¤ÎÇÜ¿ô¤ËÀÚ¤ê¾å¤²¤é¤ì¤ë¡£
 128
 129 .I flags
 130 ¤Ç
 131 .B MPOL_F_NODE
 132 ¤È
 133 .B MPOL_F_ADDR
 134 ¤ÎÎ¾Êý¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢
 135 .BR get_mempolicy ()
 136 ¤Ï¥¢¥É¥ì¥¹
 137 .I addr
 138 ¤¬³ä¤êÅö¤Æ¤é¤ì¤Æ¤¤¤ë¥Î¡¼¥É¤Î¥Î¡¼¥É ID ¤ò
 139 .I mode
 140 ¤¬»Ø¤¹¾ì½ê¤ËÆþ¤ì¤ÆÊÖ¤¹¡£
 141 »ØÄê¤µ¤ì¤¿¥¢¥É¥ì¥¹¤Ë¤É¤Î¥Ú¡¼¥¸¤â¤Þ¤À³ä¤êÅö¤Æ¤é¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
 142 .BR get_mempolicy ()
 143 ¤Ï¡¢¤¢¤¿¤«¤â¤½¤Î¥×¥í¥»¥¹¤¬¤½¤Î¥¢¥É¥ì¥¹¤ËÂÐ¤·¤ÆÆÉ¤ß¹þ¤ß¥¢¥¯¥»¥¹¤ò
 144 ¼Â¹Ô¤·¤¿¤«¤Î¤è¤¦¤Ë¥Ú¡¼¥¸¤Î³ä¤êÅö¤Æ¤ò¹Ô¤¤¡¢¥Ú¡¼¥¸¤¬³ä¤êÅö¤Æ¤é¤ì¤¿
 145 ¥Î¡¼¥É¤Î ID ¤òÊÖ¤¹¡£
 146
 147 .I flags
 148 ¤Ç
 149 .B MPOL_F_NODE
 150 ¤Ï»ØÄê¤µ¤ì¤¿¤¬¡¢
 151 .B MPOL_F_ADDR
 152 ¤Ï»ØÄê¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ç¡¢¤«¤Ä
 153 ¤½¤Î¥×¥í¥»¥¹¤Î¸½ºß¤Î¥Ý¥ê¥·¡¼¤¬
 154 .B MPOL_INTERLEAVE
 155 ¤Î¾ì¹ç¡¢
 156 .BR get_mempolicy ()
 157 ¤Ï¡¢¤½¤Î¥×¥í¥»¥¹¤ËÂÐ¤·¤Æ³ä¤êÅö¤Æ¤é¤ì¤¿¥«¡¼¥Í¥ë¤ÎÆâÉô¥Ú¡¼¥¸¤Ç
 158 ¼¡¤Ë¥¤¥ó¥¿¡¼¥ê¡¼¥ÖÍÑ¤Ë»ÈÍÑ¤µ¤ì¤ë¥Î¡¼¥É¤Î¥Î¡¼¥É ID ¤ò¡¢
 159 NULL ¤Ç¤Ê¤¤
 160 .I mode
 161 °ú¤¿ô¤¬»Ø¤¹¾ì½ê¤ËÆþ¤ì¤ÆÊÖ¤¹¡£
 162 .\" Note:  code returns next interleave node via 'mode' argument -Lee Schermerhorn
 163 ÆÉ¤ß¹þ¤ß¥¢¥¯¥»¥¹ÍÑ¤È¤·¤Æ
 164 .B MAP_PRIVATE
 165 ¥Õ¥é¥°ÉÕ¤¤Ç
 166 .BR mmap (2)
 167 ¤·¤¿¥×¥í¥»¥¹¥á¥â¥êÎÎ°è¤ä¡¢
 168 Ç¤°Õ¤Î¥¢¥¯¥»¥¹ÍÑ¤È¤·¤Æ
 169 .B MAP_SHARED
 170 ¥Õ¥é¥°ÉÕ¤¤Ç
 171 .BR mmap (2)
 172 ¤·¤¿¥á¥â¥êÎÎ°è¤Î¡¢¥á¥â¥ê¥Þ¥Ã¥×¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤ËÂÐ¤¹¤ë¥Ú¡¼¥¸¤â
 173 ¾åµ¤Î¥×¥í¥»¥¹¤ËÂÐ¤·¤Æ³ä¤êÅö¤Æ¤é¤ì¤¿¥Ú¡¼¥¸¤Ë´Þ¤Þ¤ì¤ë¡£
 174
 175 Â¾¤Î¥Õ¥é¥°¤ÏÍ½Ìó¤µ¤ì¤Æ¤¤¤ë¡£
 176
 177 ÀßÄê²ÄÇ½¤Ê¥Ý¥ê¥·¡¼¤Î³µÍ×¤Ë¤Ä¤¤¤Æ¤Ï
 178 .BR set_mempolicy (2)
 179 ¤ò»²¾È¡£
 180 .SH ÊÖ¤êÃÍ
 181 À®¸ù¤¹¤ë¤È¡¢
 182 .BR get_mempolicy ()
 183 ¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
 184 .I errno
 185 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
 186 .SH ¥¨¥é¡¼
 187 .TP
 188 .B EFAULT
 189 .\"motoki: Part of all of the memory ¤Ï Part or all .. ¤Î´Ö°ã¤¤¡©
 190 .I nodemask
 191 ¤È
 192 .I maxnode
 193 ¤Ç»ØÄê¤µ¤ì¤¿¥á¥â¥êÎÎ°è¤Î°ìÉô¤Þ¤¿¤ÏÁ´Éô¤¬¡¢
 194 ¸Æ¤Ó½Ð¤·¸µ¤¬¥¢¥¯¥»¥¹²ÄÇ½¤Ê¥¢¥É¥ì¥¹¶õ´Ö³°¤ò»Ø¤·¤Æ¤¤¤ë¡£
 195 .TP
 196 .B EINVAL
 197 .I maxnode
 198 ¤Ç»ØÄê¤µ¤ì¤¿ÃÍ¤¬¥·¥¹¥Æ¥à¤¬¥µ¥Ý¡¼¥È¤¹¤ë¥Î¡¼¥É ID ¤Î¿ô¤è¤ê¤â¾¯¤Ê¤¤¡£
 199 ¤Þ¤¿¤Ï¡¢
 200 .I flags
 201 ¤Ë
 202 .B MPOL_F_NODE
 203 ¤Ç¤â
 204 .B MPOL_F_ADDR
 205 ¤Ç¤â¤Ê¤¤ÃÍ¤¬»ØÄê¤µ¤ì¤¿¡£
 206 ¤Þ¤¿¤Ï¡¢
 207 .I flags
 208 ¤Ë
 209 .B MPOL_F_ADDR
 210 ¤¬»ØÄê¤µ¤ì¤Æ¤ª¤ê¡¢
 211 .I addr
 212 ¤¬ NULL ¤Ç¤¢¤ë¡£
 213 ¤Þ¤¿¤Ï¡¢
 214 .I flags
 215 ¤Ë
 216 .B MPOL_F_ADDR
 217 ¤¬¤µ¤ì¤Æ¤ª¤é¤º¡¢
 218 .I addr
 219 ¤¬ NULL ¤Ç¤Ê¤¤¡£
 220 ¤Þ¤¿¤Ï¡¢
 221 .I flags
 222 ¤Ë
 223 .B MPOL_F_NODE
 224 ¤¬»ØÄê¤µ¤ì¤Æ¤ª¤ê¡¢
 225 .B MPOL_F_ADDR
 226 ¤¬»ØÄê¤µ¤ì¤Æ¤ª¤é¤º¡¢
 227 ¥×¥í¥»¥¹¤Î¸½ºß¤Î¥Ý¥ê¥·¡¼¤¬
 228 .B MPOL_INTERLEAVE
 229 ¤Ç¤Ê¤¤¡£
 230 ¤Þ¤¿¤Ï¡¢
 231 .I flags
 232 ¤Ë
 233 .B MPOL_F_MEMS_ALLOWED
 234 ¤¬»ØÄê¤µ¤ì¤Æ¤ª¤ê¡¢¤µ¤é¤Ë
 235 .B MPOL_F_ADDR
 236 ¤«
 237 .B MPOL_F_NODE
 238 ¤Î¤¤¤º¤ì¤«¤¬»ØÄê¤µ¤ì¤Æ¤¤¤ë¡£
 239 (Â¾¤Ë¤â
 240 .B EINVAL
 241 ¤È¤Ê¤ë¾ì¹ç¤¬¤¢¤ë¡£)
 242 .SH ¥Ð¡¼¥¸¥ç¥ó
 243 .BR get_mempolicy ()
 244 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥Ð¡¼¥¸¥ç¥ó 2.6.7 ¤Ç Linux ¥«¡¼¥Í¥ë¤ËÄÉ²Ã¤µ¤ì¤¿¡£
 245 .SH ½àµò
 246 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¸ÇÍ¤Ç¤¢¤ë¡£
 247 .SH Ãí°Õ
 248 ¥é¥¤¥Ö¥é¥ê¤Ë¤è¤ë¥µ¥Ý¡¼¥È¤Ë¤Ä¤¤¤Æ¤Ï
 249 .BR numa (7)
 250 ¤ò»²¾È¡£
 251 .SH ´ØÏ¢¹àÌÜ
 252 .BR getcpu (2),
 253 .BR mbind (2),
 254 .BR mmap (2),
 255 .BR set_mempolicy (2),
 256 .BR numa (3),
 257 .BR numa (7),
 258 .BR numactl (8)