.\" Copyright 2003,2004 Andi Kleen, SuSE Labs.
.\"
.\" 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
.\"
.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI
.\"         all rights reserved.
.\" Translated 2006-07-25, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
.\"
.TH MBIND 2 2006-02-07 "Linux" "Linux Programmer's Manual"
.SH ̾
mbind \- ΰФƥݥꥷꤹ
.SH 
.nf
.B "#include <numaif.h>"
.sp
.BI "int mbind(void *" start ", unsigned long " len  ", int " policy ,
.BI "          unsigned long *" nodemask  ", unsigned long " maxnode ,
.BI "          unsigned " flags );
.sp
.BI "cc ... \-lnuma"
.fi
.SH 
.BR mbind ()
ϡ
.I start
ϤޤĹ
.I len
ХȤϰϤΥ NUMA ݥꥷ
.I policy
ꤹ롣
NUMA (оΥꥢ) ޥΥʣΥΡɤʬ䤵졢
ݥꥷϤɤΥΡɤ˥Ƥ뤫ꤹ롣
.BR mbind ()
ϿΥƤФƤΤ߸̤ġ
ݥꥷꤵˤǤ˻ѤƤϰΥڡФƤϡ
ݥꥷϱƶʤ

ǽʥݥꥷ
.BR MPOL_DEFAULT ,
.BR MPOL_BIND ,
.BR MPOL_INTERLEAVE ,
.BR MPOL_PREFERRED
Ǥ롣
.B MPOL_DEFAULT
ʳΥݥꥷξ硢ƤӽФ
.I nodemask
ѥ᡼ǥݥꥷŬѤΡɤꤹɬפ롣
.I nodemask
ϥΡɤΥӥåȥޥǤꡢ
.I maxnode
ĤΥӥåȤ鹽롣
ΰͳǼºݤžХȿϡľ
.IR "sizeof(unsigned long)"
ܿڤ夲뤬ͥ뤬ѤΤ
.I maxnode
ĤޤǤΥӥåȤǤ롣
 NULL ϥΡɤζ̣롣

.B MPOL_DEFAULT
ݥꥷǥեȤǤꡢꤹ
ץΤΥݥꥷѤ
(ץΥݥꥷ
.BR set_mempolicy (2)
ѹ뤳ȤǤ)
ץΥݥꥷѹƤʤ硢
ƤΤäȤʤä CPU ΥΡɤ˥꤬Ƥ뤳
ˤʤ롣
.I nodemask
ˤ NULL ꤹ٤Ǥ롣

.B MPOL_BIND
ϸݥꥷǡƤ
.I nodemask
˻ꤵ줿Ρɤ˸ꤵ롣
¾ΥΡɤؤγƤϹԤʤ

.B MPOL_INTERLEAVE
ǤϡƤ
.I nodemask
˻ꤵ줿Ρɤ˸ߤ˹Ԥ
ΥݥꥷǤϡٱǤϤʤӰ褬Ŭ롣
̤ˤϡΰ򤢤礭٤Ǥꡢ
ʤȤ 1MB ʾɬפǤ롣

.B MPOL_PREFERRED
ϡƻͥ褵Ρɤꤹ롣
ͥϤޤͥΡɤ˳ƤԤȤ
ͥΡɤ˶꤬ʤ¾ΥΡɤ˳ƤԤ
.I nodemask
κǽΥΡɤѤ롣
.I nodemask
ˤɤΥΡɤ⥻åȤƤʤСƤΤäȤʤä
CPU ΥΡɤ˥ƤԤ롣

.I flags

.B MPOL_MF_STRICT

ꤵ졢
.I policy

.B MPOL_DEFAULT
Ǥʤ硢
ꤵ줿ݥꥷ˽äƤʤޥåԥ󥰤˥ڡ¸ߤȡ
.BR mbind ()
ϥ顼
.B EIO
ǼԤ롣
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 顼
.TP
.B EFAULT
ꤵ줿ΰ˥ޥåפƤʤʬ (unmapped hole) ä
⤷ϻꤵ줿ݥ󥿤ͭǤʤä
.TP
.B EINVAL
.I flags

.I mode
ͤꤵ줿
ޤ
.I start + len

.I start
꾮
ޤ
.I policy

.B MPOL_DEFAULT

.I nodemask
ؤ礬Ǥʤä
ޤ
.I policy

.B MPOL_BIND

.B MPOL_INTERLEAVE

.I nodemask
νؤƤ
.TP
.B ENOMEM
ƥΥ­Ǥ롣
.TP
.B EIO
.B MPOL_MF_STRICT
ꤵ줿Υݥꥷ˽äƤʤΡɤ
Ǥ˥ڡ¸ߤƤ
.SH 
Υƥॳ Linux ȼǤ롣
.SH 
NUMA ݥꥷϥեޥåԥ󥰤ǤϥݡȤƤʤ

.B MPOL_MF_STRICT
Ϻߤϥҥ塼ڡ (huge page) ޥåԥ󥰤Ǥ̵뤵롣

Ȥˡ
.B MPOL_DEFAULT
Ȥ̾Ʊǡ
.BR mbind (2)

.BR set_mempolicy (2)
ǰۤʤ̣ĥե饰¸ߤ롣
.BR mbind ()
ƤӽФݤ
ֳƤΤäȤʤä CPU ΥΡɤ˳ƤԤ
.RB ( set_mempolicy (2)

.B MPOL_DEFAULT
Ʊ) 򤹤ˤϡ
.I nodemask

.I policy

.B MPOL_PREFERRED
ꤹФ褤
.SS Сȥ饤֥Ǥб
ƥॳ
.BR mbind (),
.BR get_mempolicy (2),
.BR set_mempolicy (2)
ϥС 2.6.7  Linux ͥɲä줿

.B CONFIG_NUMA
ͭˤƥѥ뤵줿ͥǤΤѤǤ롣

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

.B MPOL_MF_MOVE

.B MPOL_MF_MOVE_ALL
 Linux 2.6.16 ʹߤǤΤѲǽǤ롣

ΥƥॳľܻѤ٤ǤϤʤ
ˡ
.I numactl
ѥå
.BR numa (3)
ؿˤ󶡤٥Υ󥿥ե
ȤΤ˾ޤ
.I numactl
ѥå
.I ftp://ftp.suse.com/pub/people/ak/numa/
Ǥ롣

ƥॳˤϡ
.I \-lnuma
դǥ󥯤Ф褤
.I libnuma

.I numactl
ѥåäƤ롣
Υѥåˤϡإåե
.I numaif.h
äƤ롣
.SH Ϣ
.BR numa (3),
.BR numactl (8),
.BR set_mempolicy (2),
.BR get_mempolicy (2),
.BR mmap (2)