Skip to contentSkip to conversation

mbind.2: Add mode flag MPOL_F_NUMA_BALANCING

PATCH Alejandro Colomar 1 participant 1 message Dec 9, 2023 1 message not in the archive Memory management

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

#1 lore raw

Hello Yafang,

Quoted 13 lines · Yafang Shao

In Linux Kernel 5.12, a new mode flag, MPOL_F_NUMA_BALANCING, was 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 is bound with MPOL_BIND.

In Linux Kernel 5.15, this mode flag was extended to mbind(2). Let's also add man-page for mbind(2). It is copied from set_mempoicy(2) man-page with subtle modifications.

Related kernel commits:
bda420b985054a3badafef23807c4b4fa38a3dff
6d2aec9e123bb9c49cb5c7fc654f25f81e688e8c

Quoted 6 lines
Cc "Huang, Ying" <[email protected]>
Cc Alejandro Colomar <[email protected]>
Cc Michael Kerrisk <[email protected]>

---

Patch applied.

Thanks,
Alex

Quoted 34 lines
 man2/mbind.2 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
man2/mbind.2 +17 -0
index ba1b81ae9..dac784389 100644
@@ -142,6 +142,23 @@ The supported
 .I "mode flags"
 are:
 .TP
+.BR MPOL_F_NUMA_BALANCING " (since Linux 5.15)"
+.\" commit bda420b985054a3badafef23807c4b4fa38a3dff
+.\" commit 6d2aec9e123bb9c49cb5c7fc654f25f81e688e8c
+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_STATIC_NODES " (since Linux-2.6.26)"
 A nonempty
 .I nodemask
Signature · 1 line
2.30.1 (Apple Git-130)
Signature · 1 line
<https://www.alejandro-colomar.es/>