summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man2/get_mempolicy.2
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man2/get_mempolicy.2')
-rw-r--r--upstream/opensuse-tumbleweed/man2/get_mempolicy.232
1 files changed, 18 insertions, 14 deletions
diff --git a/upstream/opensuse-tumbleweed/man2/get_mempolicy.2 b/upstream/opensuse-tumbleweed/man2/get_mempolicy.2
index 45b8f2fc..b70f5299 100644
--- a/upstream/opensuse-tumbleweed/man2/get_mempolicy.2
+++ b/upstream/opensuse-tumbleweed/man2/get_mempolicy.2
@@ -7,7 +7,7 @@
.\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
.\" more precise specification of behavior.
.\"
-.TH get_mempolicy 2 2023-07-16 "Linux man-pages 6.05.01"
+.TH get_mempolicy 2 2024-05-02 "Linux man-pages (unreleased)"
.SH NAME
get_mempolicy \- retrieve NUMA memory policy for a thread
.SH LIBRARY
@@ -16,7 +16,7 @@ NUMA (Non-Uniform Memory Access) policy library
.SH SYNOPSIS
.B "#include <numaif.h>"
.nf
-.PP
+.P
.BI "long get_mempolicy(int *" mode ,
.BI " unsigned long " nodemask [(. maxnode " + ULONG_WIDTH - 1)"
.B " / ULONG_WIDTH],"
@@ -28,12 +28,12 @@ NUMA (Non-Uniform Memory Access) policy library
retrieves the NUMA policy of the calling thread or of a memory address,
depending on the setting of
.IR flags .
-.PP
+.P
A NUMA machine has different
memory controllers with different distances to specific CPUs.
The memory policy defines from which node memory is allocated for
the thread.
-.PP
+.P
If
.I flags
is specified as 0,
@@ -55,7 +55,7 @@ When
is 0,
.I addr
must be specified as NULL.
-.PP
+.P
If
.I flags
specifies
@@ -77,7 +77,7 @@ with either
.B MPOL_F_ADDR
or
.BR MPOL_F_NODE .
-.PP
+.P
If
.I flags
specifies
@@ -91,7 +91,7 @@ or one of the helper functions described in
.BR numa (3)
has been used to establish a policy for the memory range containing
.IR addr .
-.PP
+.P
If the
.I mode
argument is not NULL, then
@@ -112,7 +112,7 @@ The value specified by
.I maxnode
is always rounded to a multiple of
.IR "sizeof(unsigned\ long)*8" .
-.PP
+.P
If
.I flags
specifies both
@@ -129,7 +129,7 @@ If no page has yet been allocated for the specified address,
will allocate a page as if the thread had performed a read
(load) access to that address, and return the ID of the node
where that page was allocated.
-.PP
+.P
If
.I flags
specifies
@@ -137,7 +137,9 @@ specifies
but not
.BR MPOL_F_ADDR ,
and the thread's current policy is
-.BR MPOL_INTERLEAVE ,
+.B MPOL_INTERLEAVE
+or
+.BR MPOL_WEIGHTED_INTERLEAVE ,
then
.BR get_mempolicy ()
will return in the location pointed to by a non-NULL
@@ -154,9 +156,9 @@ call with the
flag for read accesses, and in memory ranges mapped with the
.B MAP_SHARED
flag for all accesses.
-.PP
+.P
Other flag values are reserved.
-.PP
+.P
For an overview of the possible policies see
.BR set_mempolicy (2).
.SH RETURN VALUE
@@ -205,8 +207,10 @@ specified
.B MPOL_F_NODE
but not
.B MPOL_F_ADDR
-and the current thread policy is not
-.BR MPOL_INTERLEAVE .
+and the current thread policy is neither
+.B MPOL_INTERLEAVE
+nor
+.BR MPOL_WEIGHTED_INTERLEAVE .
Or,
.I flags
specified