.\" Copyright 2003,2004 Andi Kleen, SuSE Labs.
.\" and Copyright 2007 Lee Schermerhorn, Hewlett Packard
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" 2006-02-03, mtk, substantial wording changes and other improvements
.\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
.\"     more precise specification of behavior.
.\"
.\" Translated 2006-08-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.39
.\" Updated 2007-01-07, Akihiro MOTOKI, LDP v2.43
.\" Updated 2008-02-13, Akihiro MOTOKI, LDP v2.77
.\" Updated 2008-08-06, Akihiro MOTOKI, LDP v3.05
.\" Updated 2008-08-21, Akihiro MOTOKI, LDP v3.07
.\" Updated 2008-09-02, Akihiro MOTOKI, LDP v3.08
.\" Updated 2008-11-19, Akihiro MOTOKI, LDP v3.13
.\"
.\"WORD:	anonymous memory	̵̾
.\"
.TH SET_MEMPOLICY 2 2008-08-15 Linux "Linux Programmer's Manual"
.SH ̾
set_mempolicy \- ץȤλҥץ NUMA 
ǥեȥݥꥷꤹ
.SH 
.nf
.B "#include <numaif.h>"
.sp
.BI "int set_mempolicy(int " mode ", unsigned long *" nodemask ,
.BI "                  unsigned long " maxnode );
.sp
\fI\-lnuma\fP ǥ󥯤롣
.fi
.SH 
.BR set_mempolicy ()
ϡƤӽФץ NUMA ݥꥷ
.I policy
ꤹ롣
NUMA ݥꥷϥݥꥷ⡼ɤ 0 İʾΥΡɤ鹽졢
Ƥϰ
.IR mode ,
.IR nodemask ,
.I maxnode
ˤꤵ롣

NUMA (оΥꥢ) ޥǤϡCPU ˤ
ꥳȥ餬ۤʤꡢΥۤʤäƤ롣
ݥꥷϡɤΥΡɤ򤽤Υץ
Ƥ뤫ΤǤ롣

.BR set_mempolicy ()
ϡץΥǥեȥݥꥷ롣
ץΥݥꥷϡ
.BR mbind (2)
ꤵΥݥꥷˤ椵ΰʳ
ץΥɥ쥹֤ˤڡγƤŬѤ롣
ץΥǥեȥݥꥷϡ
.B MAP_PRIVATE
ե饰ꤷ
.BR mmap (2)
Ȥäƥޥåפ줿ޥåסեФɤ߽Ф
(ɤ) ΥڡγƤˤŬѤ롣
ޤ
.B MAP_SHARED
ե饰ꤷ
.BR mmap (2)
Ȥäƥޥåפ줿ޥåסեФڡγƤˤ
ŬѤ (ξϥڡΥ̤˴ؤ餺ŬѤ) 
ꤷݥꥷϡץ˿ΥڡƤȤˤΤ
ŬѤ롣̵̾ (anonymous memory) ξ硢ڡγƤ
ץꥱ󤬽ƥڡ˥ݤ˹Ԥ롣

.I mode
ˤ
.BR MPOL_DEFAULT ,
.BR MPOL_BIND ,
.BR MPOL_INTERLEAVE ,
.B MPOL_PREFERRED
Τ줫ĤꤷƤʤФʤʤ
.B MPOL_DEFAULT
ʳΥݥꥷξ硢ƤӽФ
.I nodemask
ǰİʾΥΡɤꤹɬפ롣

.I mode
ˤϡɲä
.I "⡼ɥե饰"
ޤ뤳ȤǤ롣
ݡȤƤ
.I "⡼ɥե饰"
ϰʲ̤Ǥ롣
.TP
.BR MPOL_F_STATIC_NODES " (Linux 2.6.26 ʹ)"
Ǥʤ
.I nodemask
ϡʪΡ ID Ǥ롣
Linux ǤϡΥץۤʤ CPU 祳ƥ (cpuset context)
˰ưǤ⡢Υץθߤ CPU 祳ƥȤ
ĤƤΡɽ礬ѲǤ⡢
.I nodemask
ޥåԥ󥰤ľȤϤʤ
.TP
.BR MPOL_F_RELATIVE_NODES " (Linux 2.6.26 ʹ)"
Ǥʤ
.I nodemask
ϡΥץθߤ CPU ǵĤƤΡ ID 
ˤŪʥΡ ID Ǥ롣
.PP
.I nodemask
ϡ
.I maxnode
ӥåȤ鹽Ρ ID Υӥåȥޥؤ
ӥåȥޥ礭ϡľ
.I sizeof(unsigned long)
ܿڤ夲뤬ͥ뤬ѤΤ
.I maxnode
ĤޤǤΥӥåȤǤ롣
NULL ͤ
.I nodemask
⤷ͤ 0 
.I maxnode
ϥΡɤζɽ
.I maxnode
ͤ 0 ξ硢
.I nodemask
̵뤵롣

.I nodemask
ɬܤξ̤Ǥϡ
.I nodemask
ˡ饤ǡΥץθߤ CPU 祳ƥȤ
ĤƤ
.RB ( MPOL_F_STATIC_NODES
⡼ɥե饰ꤵƤʤ)꤬Ρɤ
ʤȤäƤʤФʤʤ
.I mode

.B MPOL_F_STATIC_NODES
åȤ졢
.I nodemask
ɬܤξ̤ǡ
.I nodemask
ˡΥץθߤ CPU 祳ƥȤǵĤ줿Ρɤ
ĤޤޤƤʤˤϡΥݥꥷȤƥǥեȤ
֥뤫 (local allocation)פŬѤ롣
Υץ CPU 祳ƥȤ
.I nodemask
ǻꤵ줿Ρɤ򾯤ʤȤĴޤ褦ˤʤޤǤϡ
Ū˻ꤵ줿ư񤭤뤳Ȥˤʤ롣

.B MPOL_DEFAULT
⡼ɤϡǥեȤǤϤʤץΥݥꥷ뤳Ȥ
ꤹΤǤ롣ˤꡢݥꥷϥƥ
ǥեȥݥꥷˡפȤˤʤ롣
ƥΥǥեȥݥꥷϡ֥뤫γ (local allocation)ס
ĤޤƤΤäȤʤä CPU ΥΡɤΥ꤬Ƥ롣
.I nodemask
ˤ NULL ꤷʤФʤʤ
ּΡ (local node)פ˶꤬ʤ硢ƥ
ֶ᤯ (near by) ΡɡפƤ褦Ȼߤ롣

.B MPOL_BIND
⡼ɤϸ̩ʥݥꥷǡƤ
.I nodemask
˻ꤵ줿Ρɤ˸ꤵ롣
.I nodemask
 2 İʾΥΡɤꤵ줿硢ڡγƤ
Ρ ID ȤƺǾΥΡɤ鳫Ϥ졢
ΥΡɤ˶꤬ʤʤޤǤΥΡɤ
ڡƤԤ롣ΥΡɤ˶꤬ʤʤä顢
.\"motoki: the next highest  the next lowest δְ㤤
˾ʥΡ ID ĥΡɤڡƤԤ롣

.I nodemask
ǻꤵ줿ƤΥΡɤǶ꤬ʤʤޤǷ֤
.I nodemask
ǻꤵ줿ʳΥΡɤϥڡγƤϹԤʤ

.B MPOL_INTERLEAVE
ǤϡڡƤ
.I nodemask
˻ꤵ줿Ρɤδ֤ǥΡ ID οǸߤ˹Ԥ
ΥݥꥷǤϡʣΥΡɤ˥ڡ򹭤֤ΥڡؤΥ
ʬ뤳ȤǡٱǤϤʤӰŬ롣
ĤΥڡؤΥ˴ؤƤϰȤưĤΥΡɤΥӰ
¤Ȥʤ롣
.\" NOTE:  the following sentence doesn't make sense in the context
.\" of set_mempolicy() -- no memory area specified.
.\" To be effective the memory area should be fairly large,
.\" at least 1MB or bigger.

.B MPOL_PREFERRED
ϡƻͥ褵Ρ (preferred node) ꤹ롣
ͥϤޤͥΡɤڡƤԤȤ
ͥΡɤ˶꤬ʤˡֶ᤯ (near by)ץΡɤ
ƤԤ
.I nodemask
ʣΥΡ ID ꤵ줿ϡ
.I nodemask
κǽΥΡɤͥΡɤȤ򤵤롣

.IR nodemask ,
.I maxnode
Ƕ礬ꤵ줿ϡݥꥷ (ҤΥƥ
ǥեȥݥꥷƱͤ) ֥뤫γơפȤʤ롣

ץΥݥꥷ
.BR execve (2)
ݻ졢
.BR fork (2)

.BR clone (2)
Ȥäƺ줿ҥץ˷Ѿ롣
.SH ֤
ȡ
.BR set_mempolicy ()
 0 ֤顼ξ硢\-1 ֤
.I errno
˥顼򼨤ͤꤹ롣
.SH 顼
.TP
.B EFAULT
.\"motoki: Part of all of the memory  Part or all .. δְ㤤
.I nodemask

.I maxnode
ǻꤵ줿ΰΰޤ
ƤӽФǽʥɥ쥹ֳؤƤ롣
.TP
.B EINVAL
.I mode
Ǥ롣
.I mode

.B MPOL_DEFAULT
ǡ
.I nodemask
ǤϤʤ
.I mode

.B MPOL_BIND

.B MPOL_INTERLEAVE
ǡ
.I nodemask
Ǥ롣
.I maxnode
Ǽºݤ˰̣ӥåȿ¿Υӥåȿꤵ줿
.I nodemask
ˡݡȤƤΡ ID 礭Ρɤꤵ줿
.I nodemask
ˡ饤ǡĤΥץθߤ CPU 祳ƥȤ
ĤƤΡɤĤޤޤƤʤ
ޤΡɤĤꤵƤʤ
.I mode

.B MPOL_F_STATIC_NODES

.B MPOL_F_RELATIVE_NODES
ξꤵ줿
.TP
.B ENOMEM
Ѳǽʥ꤬ͥʬǤʤä
.SH С
.BR set_mempolicy ()
ƥॳϥС 2.6.7  Linux ͥɲä줿
.SH 
Υƥॳ Linux ȼǤ롣
.SH 
ڡåסȤˤϡ
ץݥꥷϿ侩ʤ
åסȤ줿ڡڡ󤹤ݤˤ⡢
ڡƻŬѤץݥꥷΰݥꥷ
Ѥ롣

饤֥ˤ륵ݡȤˤĤƤ
.BR numa (7)
򻲾ȡ
.SH Ϣ
.BR get_mempolicy (2),
.BR getcpu (2),
.BR mbind (2),
.BR mmap (2),
.BR numa (3),
.BR cpuset (7),
.BR numa (7),
.BR numactl (8)