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>
|
.\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
|
||||||
.\" more precise specification of behavior.
|
.\" 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
|
.SH NAME
|
||||||
mbind \- Set memory policy for a memory range
|
mbind \- Set memory policy for a memory range
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
@ -44,7 +44,6 @@ for the memory range starting with
|
||||||
and continuing for
|
and continuing for
|
||||||
.I len
|
.I len
|
||||||
bytes.
|
bytes.
|
||||||
The memory of a NUMA machine is divided into multiple nodes.
|
|
||||||
The memory policy defines from which node memory is allocated.
|
The memory policy defines from which node memory is allocated.
|
||||||
|
|
||||||
If the memory range specified by the
|
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
|
.\" I think I got all of the error returns. --Lee Schermerhorn
|
||||||
.TP
|
.TP
|
||||||
.B EFAULT
|
.B EFAULT
|
||||||
Part of all of the memory range specified by
|
Part or all of the memory range specified by
|
||||||
.I nodemask
|
.I nodemask
|
||||||
and
|
and
|
||||||
.I maxnode
|
.I maxnode
|
||||||
|
@ -377,17 +376,21 @@ flag and the caller does not have the
|
||||||
.B CAP_SYS_NICE
|
.B CAP_SYS_NICE
|
||||||
privilege.
|
privilege.
|
||||||
.\" ---------------------------------------------------------------
|
.\" ---------------------------------------------------------------
|
||||||
|
.SH VERSIONS
|
||||||
|
The
|
||||||
|
.BR mbind (),
|
||||||
|
system call was added to the Linux kernel in version 2.6.7.
|
||||||
.SH CONFORMING TO
|
.SH CONFORMING TO
|
||||||
This system call is Linux-specific.
|
This system call is Linux-specific.
|
||||||
.SH NOTES
|
.SH NOTES
|
||||||
|
For information on library support, see
|
||||||
|
.BR numa (7).
|
||||||
|
|
||||||
NUMA policy is not supported on a memory mapped file range
|
NUMA policy is not supported on a memory mapped file range
|
||||||
that was mapped with the
|
that was mapped with the
|
||||||
.B MAP_SHARED
|
.B MAP_SHARED
|
||||||
flag.
|
flag.
|
||||||
|
|
||||||
.B MPOL_MF_STRICT
|
|
||||||
is ignored on huge page mappings.
|
|
||||||
|
|
||||||
The
|
The
|
||||||
.BR MPOL_DEFAULT ,
|
.BR MPOL_DEFAULT ,
|
||||||
mode can have different effects for
|
mode can have different effects for
|
||||||
|
@ -419,47 +422,14 @@ with an empty set of nodes.
|
||||||
This method will work for
|
This method will work for
|
||||||
.BR set_mempolicy (2),
|
.BR set_mempolicy (2),
|
||||||
as well.
|
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.
|
Support for huge page policy was added with 2.6.16.
|
||||||
For interleave policy to be effective on huge page mappings the
|
For interleave policy to be effective on huge page mappings the
|
||||||
policied memory needs to be tens of megabytes or larger.
|
policied memory needs to be tens of megabytes or larger.
|
||||||
|
|
||||||
|
.B MPOL_MF_STRICT
|
||||||
|
is ignored on huge page mappings.
|
||||||
|
|
||||||
.B MPOL_MF_MOVE
|
.B MPOL_MF_MOVE
|
||||||
and
|
and
|
||||||
.B MPOL_MF_MOVE_ALL
|
.B MPOL_MF_MOVE_ALL
|
||||||
|
@ -473,4 +443,5 @@ are only available on Linux 2.6.16 and later.
|
||||||
.BR shmget (2),
|
.BR shmget (2),
|
||||||
.BR numa (3),
|
.BR numa (3),
|
||||||
.BR cpuset (7),
|
.BR cpuset (7),
|
||||||
|
.BR numa (7),
|
||||||
.BR numactl (8)
|
.BR numactl (8)
|
||||||
|
|
Loading…
Reference in New Issue