mirror of https://github.com/mkerrisk/man-pages
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:
parent
610f75cc09
commit
c6b29f0e9e
55
man2/mbind.2
55
man2/mbind.2
|
@ -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)
|
||||
|
|
Loading…
Reference in New Issue