Re: [PATCH] man2/set_mempolicy.2: Add mode flag MPOL_F_NUMA_BALANCING

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Alex,

On 3/20/21 12:57 AM, Alejandro Colomar wrote:
> From: Huang Ying <ying.huang@xxxxxxxxx>
> 
> In Linux kernel 5.12, a new mode flag MPOL_F_NUMA_BALANCING is added
> to set_mempolicy() to optimize the page placement among the NUMA nodes
> with the NUMA balancing mechanism even if the memory of the
> applications are bound with MPOL_BIND.  This patch update the man page
> for the new mode flag.
> 
> Related kernel commits:
> bda420b985054a3badafef23807c4b4fa38a3dff

Thanks. Patch applied.

Cheers,

Michael

> 
> Signed-off-by: "Huang, Ying" <ying.huang@xxxxxxxxx>
> Cc: "Michael Kerrisk" <mtk.manpages@xxxxxxxxx>
> [ alx: srcfix ]
> Signed-off-by: Alejandro Colomar <alx.manpages@xxxxxxxxx>
> ---
>  man2/set_mempolicy.2 | 33 +++++++++++++++++++++++++++------
>  1 file changed, 27 insertions(+), 6 deletions(-)
> 
> diff --git a/man2/set_mempolicy.2 b/man2/set_mempolicy.2
> index 6e695fb13..746858720 100644
> --- a/man2/set_mempolicy.2
> +++ b/man2/set_mempolicy.2
> @@ -98,6 +98,27 @@ The supported
>  .I "mode flags"
>  are:
>  .TP
> +.BR MPOL_F_NUMA_BALANCING " (since Linux 5.12)"
> +When
> +.I mode
> +is
> +.BR MPOL_BIND ,
> +enable the kernel NUMA balancing for the task if it is supported by the kernel.
> +If the flag isn't supported by the kernel, or is used with
> +.I mode
> +other than
> +.BR MPOL_BIND ,
> +\-1 is returned and
> +.I errno
> +is set to
> +.BR EINVAL .
> +.TP
> +.BR MPOL_F_RELATIVE_NODES " (since Linux 2.6.26)"
> +A nonempty
> +.I nodemask
> +specifies node IDs that are relative to the
> +set of node IDs allowed by the process's current cpuset.
> +.TP
>  .BR MPOL_F_STATIC_NODES " (since Linux 2.6.26)"
>  A nonempty
>  .I nodemask
> @@ -107,12 +128,6 @@ Linux will not remap the
>  when the process moves to a different cpuset context,
>  nor when the set of nodes allowed by the process's
>  current cpuset context changes.
> -.TP
> -.BR MPOL_F_RELATIVE_NODES " (since Linux 2.6.26)"
> -A nonempty
> -.I nodemask
> -specifies node IDs that are relative to the set of
> -node IDs allowed by the process's current cpuset.
>  .PP
>  .I nodemask
>  points to a bit mask of node IDs that contains up to
> @@ -293,6 +308,12 @@ argument specified both
>  .B MPOL_F_STATIC_NODES
>  and
>  .BR MPOL_F_RELATIVE_NODES .
> +Or, the
> +.B MPOL_F_NUMA_BALANCING
> +isn't supported by the kernel, or is used with
> +.I mode
> +other than
> +.BR MPOL_BIND .
>  .TP
>  .B ENOMEM
>  Insufficient kernel memory was available.
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux