.\" 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.
.\"
.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI
.\"         all rights reserved.
.\" Translated 2006-07-25, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
.\" Updated 2008-08-21, Akihiro MOTOKI, LDP v3.07
.\" Updated 2008-09-19, Akihiro MOTOKI, LDP v3.08
.\"
.TH MBIND 2 2008-08-15 Linux "Linux Programmer's Manual"
.SH ̾
mbind \- ΰФƥݥꥷꤹ
.SH 
.nf
.B "#include <numaif.h>"
.sp
.BI "int mbind(void *" addr ", unsigned long " len  ", int " mode ,
.BI "          unsigned long *" nodemask  ", unsigned long " maxnode ,
.BI "          unsigned " flags );
.sp
\fI\-lnuma\fP ǥ󥯤롣
.fi
.SH 
.BR mbind ()
ϡ
.I addr
ϤޤĹ
.I len
ХȤϰϤΥ NUMA ݥꥷꤹ롣
NUMA ݥꥷϥݥꥷ⡼ɤ 0 İʾΥΡɤ鹽롣
ݥꥷϤɤΥΡɤƤ뤫ꤹ롣

.I addr

.I len
ǻꤵ줿ϰϤˡ
Ρ̵̾ΰ \(em
.B MAP_ANONYMOUS
դ
.BR mmap (2)
ƥॳȤäƺ줿ΰ \(em 
.B MAP_PRIVATE
դ
.BR mmap (2)
Ȥäƥޥåפ줿ޥåסե뤬ޤޤƤ硢
ڡꤵ줿ݥꥷ˴ŤƳƤΤϡץꥱ
Υڡؤν񤭹 (ǡγǼ) ԤäǤ롣
̵̾ΰξ硢ǽɤ߽Фκݤˤ
ͥǡ 0 Ǥ붦ͭڡѤ롣
.B MAP_PRIVATE
ǥޥåפ줿եξ硢ǽɤ߽Фȡ
ڡƤȯ뤭äȤʤäץΥǥեȥݥꥷ
ˤäƥڡγƤԤ롣
ڡƤΤäȤʤäץϡ
.BR mbind ()
ƤӽФץƱȤϸ¤ʤ

ꤵ줿ϰˤ
.B MAP_SHARED
Υޥåԥ󥰤Ǥϻꤵ줿ݥꥷ̵뤵졢
ڡƤȯ뤭äȤʤäץΥǥեȥݥꥷ
äƥڡγƤԤ뤳Ȥˤʤ롣
֤ˤʤ뤬ڡƤΤäȤʤäץϡ
.BR mbind ()
ƤӽФץƱȤϸ¤ʤ

ꤵ줿ϰϤˡ
.BR shmget (2)
ƥॳȤäƺ줿ꡢ
.BR shmat (2)
ƥॳȤäղ (attach) 줿ꤷͭΰ褬
ޤޤ硢̵̾ΰ䶦ͭΰФڡƤϡ
ͭꥻȤإݥꥷԤäץڡ
ΤäȤʤä˴ؤ餺ꤵ줿ݥꥷˤäƳ
Ԥ롣
ʤ顢ͭΰ褬
.B SHM_HUGETLB
ե饰ꤷƺ줿ˤϡҥ塼ڡ (huge page) γƤ
ꤵ줿ݥꥷˤäƹԤΤϡΰФ
.BR mbind ()
ƤӽФץڡƤΤäȤʤäΤߤǤ롣

ǥեȤǤϡ
.BR mbind ()
ϿΥƤФƤΤ߸̤ġ
ݥꥷꤵˤǤ˻ѤƤϰΥڡФƤϡ
ݥꥷϱƶʤ
ΥǥեȤưϡʲե饰
.B MPOL_MF_MOVE

.B MPOL_MF_MOVE_ALL
ˤ񤭤ǽ롣

.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
ӥåȤ鹽ΡɤΥӥåȥޥؤ
ӥåȥޥ礭ϡľ
.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
⡼ɥե饰ꤵƤʤ)꤬Ρɤ
ʤȤäƤʤФʤʤ

⡼
.B MPOL_DEFAULT
ϥǥեȤǤϤʤץΥݥꥷ
ǥեȤư᤹ȤꤹΤǤ롣
.BR mbind ()
ͳǡΰФ
.B MPOL_DEFAULT
ŬѤ줿硢ץΥǥեȥݥꥷѤ뤳Ȥ̣롣
ץΥǥեȥݥꥷϡ
.BR set_mempolicy (2)
ѹƤ뤫⤷ʤ
ץΥݥꥷΥ⡼ɤ
.B MPOL_DEFAULT
ξ硢ƥΤΥǥեȥݥꥷѤ롣
ƥΤΥǥեȥݥꥷǤϡƤΤäȤʤä
CPU ΥΡɤڡγƤԤ
.B MPOL_DEFAULT
Ǥϡ
.I nodemask

.I maxnode
˥ΡɤζꤷʤФʤʤ

.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
˻ꤵ줿Ρɴ֤Ǹߤ˹Ԥ뤳ȤꤹΤǤ롣
ΥݥꥷǤϡʣΥΡɤ˥ڡ򹭤֤Υڡؤ
ꥢʬ뤳ȤǡٱǤϤʤӰŬ롣
̤ˤϡΰ򤢤礭٤Ǥꡢ
ꥢΥѥ󤬤ʤѰʾǤ
ʤȤ 1MB ʾˤ٤Ǥ롣
Υ⡼ɤǤ⡢ĤΥڡؤΥ˴ؤƤ
ĤΥΡɤΥӰ褬¤Ȥʤ뤳ȤѤʤ

.B MPOL_PREFERRED
ϡƻͥ褵Ρɤꤹ롣
ͥϤޤͥΡɤ˥ڡƤԤȤ
ͥΡɤ˶꤬ʤ¾ΥΡɤ˳ƤԤ
.I nodemask
ʣΥΡ ID ꤵ줿ϡ
.I nodemask
κǽΥΡɤͥΡɤȤ򤵤롣

.IR nodemask ,
.I maxnode
Ƕ礬ꤵ줿ϡƤΤäȤʤä CPU ΥΡɤ
ƤԤ롣
.BR mbind (2)
ǡΰФơ֥뤫γ (local allocation)פ
ꤹˡϤ줷ʤ

.I flags

.B MPOL_MF_STRICT

ꤵ졢
.I policy

.B MPOL_DEFAULT
Ǥʤ硢
ꤵ줿ݥꥷ˽äƤʤΰ˥ڡ¸ߤȡ
.BR mbind ()
ϥ顼
.B EIO
ǼԤ롣
.\" According to the kernel code, the following is not true
.\" --Lee Schermerhorn
.\" .\"O In 2.6.16 or later the kernel will also try to move pages
.\" .\"O to the requested node with this flag.
.\" 2.6.16 ʹߤΥͥǤϡΥե饰׵ᤵ줿Ρɤ
.\" ڡư褦Ȥ롣

.I flags

.B MPOL_MF_MOVE
ꤵȡͥϤΥΰδ¸ƤΥڡư
ꤵ줿ݥꥷ˽褦ˤ褦Ȥ롣
¾ΥץȶͭƤڡϰưʤ
.B MPOL_MF_STRICT
ꤵ줿硢ưǤʤäڡȡ
.BR mbind ()
ϥ顼
.B EIO
ǼԤ롣

.I flags

.B MPOL_MF_MOVE_ALL
ꤵȡͥϤΥΰδ¸ƤΥڡ
¾ΥץڡѤƤ뤫ɤ˴ؤ餺ư롣
Υե饰ѤˤϡƤӽФΥץø
.RB ( CAP_SYS_NICE )
äƤʤФʤʤ
.B MPOL_MF_STRICT
ꤵ줿硢ưǤʤäڡȡ
.BR mbind ()
ϥ顼
.B EIO
ǼԤ롣
.\" ---------------------------------------------------------------
.SH ֤
ȡ
.BR mbind ()
 0 ֤顼ξ硢\-1 ֤
.I errno
˥顼򼨤ͤꤹ롣
.\" ---------------------------------------------------------------
.SH 顼
.\"  I think I got all of the error returns.  --Lee Schermerhorn
.TP
.B EFAULT
.I nodemask

.I maxnode
ǻꤵ줿ΰΰޤ
ƤӽФǽʥɥ쥹ֳؤƤ롣
⤷ϻꤵ줿ΰ˥ޥåפƤʤʬ (unmapped hole)
ä
.TP
.B EINVAL
.I flags

.I mode
ͤꤵ줿
.I addr + len

.I addr
꾮
.I addr
ƥΥڡܿˤʤäƤʤ
ޤ
.I mode

.B MPOL_DEFAULT

.I nodemask
˶Ǥʤ礬ꤵ줿
.I mode

.B MPOL_BIND

.B MPOL_INTERLEAVE

.I nodemask
Ǥä
.I maxnode
ͥŬѤ줿¤ĶƤ롣
.\" As at 2.6.23, this limit is "a page worth of bits", e.g.,
.\" 8 * 4096 bits, assuming a 4kB page size.
.I nodemask
ˡݡȤƤΡ ID 礭Ρɤꤵ줿
.I nodemask
ˡ饤ǡĤΥץθߤ CPU 祳ƥȤ
ĤƤΡɤĤޤޤƤʤ
ޤΡɤĤꤵƤʤ
.I mode

.B MPOL_F_STATIC_NODES

.B MPOL_F_RELATIVE_NODES
ξꤵ줿
.TP
.B EIO
.B MPOL_MF_STRICT
ꤵ줿Υݥꥷ˽äƤʤΡɤ
Ǥ˥ڡ¸ߤƤ
⤷
.B MPOL_MF_MOVE

.B MPOL_MF_MOVE_ALL
ꤵ줿ͥ뤬ꤵ줿ΰδ¸ƤΥڡ
ư뤳ȤǤʤä
.TP
.B ENOMEM
Ѳǽʥ꤬ͥʬʤä
.TP
.B EPERM
.I flags

.B MPOL_MF_MOVE_ALL
ե饰ޤޤƤ뤬ƤӽФ
.B CAP_SYS_NICE
øʤ
.\" ---------------------------------------------------------------
.SH С
.BR mbind ()
ƥॳϥС 2.6.7  Linux ͥɲä줿
.SH 
Υƥॳ Linux ȼǤ롣
.SH 
饤֥ˤ륵ݡȤˤĤƤ
.BR numa (7)
򻲾ȡ

NUMA ݥꥷϡ
.B MAP_SHARED
ե饰ꤵƥޥåפ줿ޥåסեΰǤ
ݡȤƤʤ

.B MPOL_DEFAULT
⡼ɤϡ
.BR mbind ()

.BR set_mempolicy (2)
ǰۤʤ̤ĤȤǤ롣
.BR set_mempolicy (2)

.B MPOL_DEFAULT
ꤵ줿硢ΥץΥݥꥷϥƥ
ǥեȥݥꥷʤ뤫γơ롣
.BR mbind ()
ȤäƥΤΰ
.B MPOL_DEFAULT
ꤵ줿硢ϰϤФƤʹߤ˹ԤڡγƤǤϡ
.BR set_mempolicy (2)
ꤷΤƱ褦ˡΥץΥݥꥷŬѤ롣
.\"0motoki: possibly non-default policy  default policy δְ㤤
ˤꡢΥΰˤĤƤŪʥݥꥷ
ǥեȤΥݥꥷˡ᤹פȤǤ롣
ΰФơ֥뤫γơפŪꤹˤϡ
.I mode

.B MPOL_PREFERRED
ꤷ
.I nodemask
˶ΥΡɤꤹФ褤
ˡ
.BR set_mempolicy (2)
ǤѤ롣

2.6.16 ǥҥ塼ڡݥꥷؤбɲä줿
󥿡꡼֡ݥꥷҥ塼ڡΥޥåԥ󥰤Ǹ̤Ĥˤϡ
ݥꥷŬѤ꤬ᥬХȰʾǤɬפ롣

.B MPOL_MF_STRICT
ϥҥ塼ڡΥޥåԥ󥰤Ǥ̵뤵롣

.B MPOL_MF_MOVE

.B MPOL_MF_MOVE_ALL
 Linux 2.6.16 ʹߤǤΤѲǽǤ롣
.SH Ϣ
.BR get_mempolicy (2),
.BR getcpu (2),
.BR mmap (2),
.BR set_mempolicy (2),
.BR shmat (2),
.BR shmget (2),
.BR numa (3),
.BR cpuset (7),
.BR numa (7),
.BR numactl (8)