From c6b29f0e9e62456ebf7356b749107a74b2546eea Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 13 Aug 2008 08:15:51 +0000 Subject: [PATCH] SEE ALSO: Add numa(7). Added a VERSIONS section. Remove material on library support and numactl; that material is now in numactl.7. --- man2/mbind.2 | 55 +++++++++++++--------------------------------------- 1 file changed, 13 insertions(+), 42 deletions(-) diff --git a/man2/mbind.2 b/man2/mbind.2 index e3b61903e..efae0f4f0 100644 --- a/man2/mbind.2 +++ b/man2/mbind.2 @@ -22,7 +22,7 @@ .\" 2007-08-27, Lee Schermerhorn .\" 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 -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)