SEE ALSO: Add numa(7).

Added  a VERSIONS section.
Remove material on library support and numactl; that material
is now in numactl.7.
This commit is contained in:
Michael Kerrisk 2008-08-13 08:15:51 +00:00
parent 610f75cc09
commit c6b29f0e9e
1 changed files with 13 additions and 42 deletions

View File

@ -22,7 +22,7 @@
.\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
.\" more precise specification of behavior.
.\"
.TH MBIND 2 2008-08-11 Linux "Linux Programmer's Manual"
.TH MBIND 2 2008-08-15 Linux "Linux Programmer's Manual"
.SH NAME
mbind \- Set memory policy for a memory range
.SH SYNOPSIS
@ -44,7 +44,6 @@ for the memory range starting with
and continuing for
.I len
bytes.
The memory of a NUMA machine is divided into multiple nodes.
The memory policy defines from which node memory is allocated.
If the memory range specified by the
@ -299,7 +298,7 @@ is set to indicate the error.
.\" I think I got all of the error returns. --Lee Schermerhorn
.TP
.B EFAULT
Part of all of the memory range specified by
Part or all of the memory range specified by
.I nodemask
and
.I maxnode
@ -377,17 +376,21 @@ flag and the caller does not have the
.B CAP_SYS_NICE
privilege.
.\" ---------------------------------------------------------------
.SH VERSIONS
The
.BR mbind (),
system call was added to the Linux kernel in version 2.6.7.
.SH CONFORMING TO
This system call is Linux-specific.
.SH NOTES
For information on library support, see
.BR numa (7).
NUMA policy is not supported on a memory mapped file range
that was mapped with the
.B MAP_SHARED
flag.
.B MPOL_MF_STRICT
is ignored on huge page mappings.
The
.BR MPOL_DEFAULT ,
mode can have different effects for
@ -419,47 +422,14 @@ with an empty set of nodes.
This method will work for
.BR set_mempolicy (2),
as well.
.\" ---------------------------------------------------------------
.SS "Versions and Library Support"
The
.BR mbind (),
.BR get_mempolicy (2),
and
.BR set_mempolicy (2)
system calls were added to the Linux kernel with version 2.6.7.
They are only available on kernels compiled with
.BR CONFIG_NUMA .
You can link with
.I \-lnuma
to get system call definitions.
.I libnuma
and the required
.I <numaif.h>
header are available in the
.I numactl
package.
However, applications should not use these system calls directly.
Instead, the higher level interface provided by the
.BR numa (3)
functions in the
.I numactl
package is recommended.
The
.I numactl
package is available at
.IR ftp://oss.sgi.com/www/projects/libnuma/download/ .
The package is also included in some Linux distributions.
Some distributions include the development library and header
in the separate
.I numactl-devel
package.
Support for huge page policy was added with 2.6.16.
For interleave policy to be effective on huge page mappings the
policied memory needs to be tens of megabytes or larger.
.B MPOL_MF_STRICT
is ignored on huge page mappings.
.B MPOL_MF_MOVE
and
.B MPOL_MF_MOVE_ALL
@ -473,4 +443,5 @@ are only available on Linux 2.6.16 and later.
.BR shmget (2),
.BR numa (3),
.BR cpuset (7),
.BR numa (7),
.BR numactl (8)