mirror of https://github.com/mkerrisk/man-pages
cpuset.7: add missing 'cpuset.' prefix for some flags
See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
7521bf1b61
commit
0a61a4f401
|
@ -192,7 +192,7 @@ and all child cpuset directories have been removed.
|
|||
See the \fBNotify On Release\fR section, below.
|
||||
.\" ====================== cpus ======================
|
||||
.TP
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
List of the physical numbers of the CPUs on which processes
|
||||
in that cpuset are allowed to execute.
|
||||
See \fBList Format\fR below for a description of the
|
||||
|
@ -205,7 +205,7 @@ writing a new list to its
|
|||
file.
|
||||
.\" ==================== cpu_exclusive ====================
|
||||
.TP
|
||||
.I cpu_exclusive
|
||||
.I cpuset.cpu_exclusive
|
||||
Flag (0 or 1).
|
||||
If set (1), the cpuset has exclusive use of
|
||||
its CPUs (no sibling or cousin cpuset may overlap CPUs).
|
||||
|
@ -234,7 +234,7 @@ of any cpuset are always a subset of the
|
|||
of its parent cpuset.
|
||||
.\" ====================== mems ======================
|
||||
.TP
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
List of memory nodes on which processes in this cpuset are
|
||||
allowed to allocate memory.
|
||||
See \fBList Format\fR below for a description of the
|
||||
|
@ -242,7 +242,7 @@ format of
|
|||
.IR mems .
|
||||
.\" ==================== mem_exclusive ====================
|
||||
.TP
|
||||
.I mem_exclusive
|
||||
.I cpuset.mem_exclusive
|
||||
Flag (0 or 1).
|
||||
If set (1), the cpuset has exclusive use of
|
||||
its memory nodes (no sibling or cousin may overlap).
|
||||
|
@ -258,7 +258,7 @@ nodes of any cpuset are always a subset of the memory nodes
|
|||
of that cpuset's parent cpuset.
|
||||
.\" ==================== mem_hardwall ====================
|
||||
.TP
|
||||
.IR mem_hardwall " (since Linux 2.6.26)"
|
||||
.IR cpuset.mem_hardwall " (since Linux 2.6.26)"
|
||||
Flag (0 or 1).
|
||||
If set (1), the cpuset is a \fBHardwall\fR cpuset (see below.)
|
||||
Unlike \fBmem_exclusive\fR,
|
||||
|
@ -269,14 +269,14 @@ By default this is off (0).
|
|||
Newly created cpusets also initially default this to off (0).
|
||||
.\" ==================== memory_migrate ====================
|
||||
.TP
|
||||
.IR memory_migrate " (since Linux 2.6.16)"
|
||||
.IR cpuset.memory_migrate " (since Linux 2.6.16)"
|
||||
Flag (0 or 1).
|
||||
If set (1), then memory migration is enabled.
|
||||
By default this is off (0).
|
||||
See the \fBMemory Migration\fR section, below.
|
||||
.\" ==================== memory_pressure ====================
|
||||
.TP
|
||||
.IR memory_pressure " (since Linux 2.6.16)"
|
||||
.IR cpuset.memory_pressure " (since Linux 2.6.16)"
|
||||
A measure of how much memory pressure the processes in this
|
||||
cpuset are causing.
|
||||
See the \fBMemory Pressure\fR section, below.
|
||||
|
@ -289,7 +289,7 @@ See the
|
|||
section, below.
|
||||
.\" ================= memory_pressure_enabled =================
|
||||
.TP
|
||||
.IR memory_pressure_enabled " (since Linux 2.6.16)"
|
||||
.IR cpuset.memory_pressure_enabled " (since Linux 2.6.16)"
|
||||
Flag (0 or 1).
|
||||
This file is only present in the root cpuset, normally
|
||||
.IR /dev/cpuset .
|
||||
|
@ -301,7 +301,7 @@ See the
|
|||
\fBMemory Pressure\fR section, below.
|
||||
.\" ================== memory_spread_page ==================
|
||||
.TP
|
||||
.IR memory_spread_page " (since Linux 2.6.17)"
|
||||
.IR cpuset.memory_spread_page " (since Linux 2.6.17)"
|
||||
Flag (0 or 1).
|
||||
If set (1), pages in the kernel page cache
|
||||
(file-system buffers) are uniformly spread across the cpuset.
|
||||
|
@ -311,7 +311,7 @@ newly created cpusets.
|
|||
See the \fBMemory Spread\fR section, below.
|
||||
.\" ================== memory_spread_slab ==================
|
||||
.TP
|
||||
.IR memory_spread_slab " (since Linux 2.6.17)"
|
||||
.IR cpuset.memory_spread_slab " (since Linux 2.6.17)"
|
||||
Flag (0 or 1).
|
||||
If set (1), the kernel slab caches
|
||||
for file I/O (directory and inode structures) are
|
||||
|
@ -322,7 +322,7 @@ newly created cpusets.
|
|||
See the \fBMemory Spread\fR section, below.
|
||||
.\" ================== sched_load_balance ==================
|
||||
.TP
|
||||
.IR sched_load_balance " (since Linux 2.6.24)"
|
||||
.IR cpuset.sched_load_balance " (since Linux 2.6.24)"
|
||||
Flag (0 or 1).
|
||||
If set (1, the default) the kernel will
|
||||
automatically load balance processes in that cpuset over
|
||||
|
@ -336,7 +336,7 @@ flag set.
|
|||
See \fBScheduler Load Balancing\fR, below, for further details.
|
||||
.\" ================== sched_relax_domain_level ==================
|
||||
.TP
|
||||
.IR sched_relax_domain_level " (since Linux 2.6.26)"
|
||||
.IR cpuset.sched_relax_domain_level " (since Linux 2.6.26)"
|
||||
Integer, between \-1 and a small positive value.
|
||||
The
|
||||
.I sched_relax_domain_level
|
||||
|
@ -529,7 +529,7 @@ It's up to the batch manager or other user code to decide
|
|||
what action to take if it detects signs of memory pressure.
|
||||
.PP
|
||||
Unless memory pressure calculation is enabled by setting the pseudo-file
|
||||
.IR /dev/cpuset/memory_pressure_enabled ,
|
||||
.IR /dev/cpuset/cpuset.memory_pressure_enabled ,
|
||||
it is not computed for any cpuset, and reads from any
|
||||
.I memory_pressure
|
||||
always return zero, as represented by the ASCII string "0\en".
|
||||
|
@ -571,7 +571,7 @@ by simply dropping them, though if that page is needed again, it
|
|||
will have to be reread from disk.
|
||||
.PP
|
||||
The
|
||||
.I memory_pressure
|
||||
.I cpuset.memory_pressure
|
||||
file provides an integer number representing the recent (half-life of
|
||||
10 seconds) rate of entries to the direct reclaim code caused by any
|
||||
process in the cpuset, in units of reclaims attempted per second,
|
||||
|
@ -582,19 +582,19 @@ There are two Boolean flag files per cpuset that control where the
|
|||
kernel allocates pages for the file-system buffers and related
|
||||
in-kernel data structures.
|
||||
They are called
|
||||
.I memory_spread_page
|
||||
.I cpuset.memory_spread_page
|
||||
and
|
||||
.IR memory_spread_slab .
|
||||
.IR cpuset.memory_spread_slab .
|
||||
.PP
|
||||
If the per-cpuset Boolean flag file
|
||||
.I memory_spread_page
|
||||
.I cpuset.memory_spread_page
|
||||
is set, then
|
||||
the kernel will spread the file-system buffers (page cache) evenly
|
||||
over all the nodes that the faulting process is allowed to use, instead
|
||||
of preferring to put those pages on the node where the process is running.
|
||||
.PP
|
||||
If the per-cpuset Boolean flag file
|
||||
.I memory_spread_slab
|
||||
.I cpuset.memory_spread_slab
|
||||
is set,
|
||||
then the kernel will spread some file-system-related slab caches,
|
||||
such as those for inodes and directory entries, evenly over all the nodes
|
||||
|
@ -633,9 +633,9 @@ memory policy most recently specified by these calls is automatically
|
|||
reapplied.
|
||||
.PP
|
||||
Both
|
||||
.I memory_spread_page
|
||||
.I cpuset.memory_spread_page
|
||||
and
|
||||
.I memory_spread_slab
|
||||
.I cpuset.memory_spread_slab
|
||||
are Boolean flag files.
|
||||
By default they contain "0", meaning that the feature is off
|
||||
for that cpuset.
|
||||
|
@ -662,7 +662,7 @@ thread initializing or reading in the data set.
|
|||
.\" ================== Memory Migration ==================
|
||||
.SS Memory Migration
|
||||
Normally, under the default setting (disabled) of
|
||||
.IR memory_migrate ,
|
||||
.IR cpuset.memory_migrate ,
|
||||
once a page is allocated (given a physical page
|
||||
of main memory) then that page stays on whatever node it
|
||||
was allocated, so long as it remains allocated, even if the
|
||||
|
@ -1014,10 +1014,10 @@ is currently mounted.
|
|||
.SH WARNINGS
|
||||
.SS Enabling memory_pressure
|
||||
By default, the per-cpuset file
|
||||
.I memory_pressure
|
||||
.I cpuset.memory_pressure
|
||||
always contains zero (0).
|
||||
Unless this feature is enabled by writing "1" to the pseudo-file
|
||||
.IR /dev/cpuset/memory_pressure_enabled ,
|
||||
.IR /dev/cpuset/cpuset.memory_pressure_enabled ,
|
||||
the kernel does
|
||||
not compute per-cpuset
|
||||
.IR memory_pressure .
|
||||
|
@ -1035,7 +1035,7 @@ For example, if the command:
|
|||
.in +4n
|
||||
.nf
|
||||
|
||||
echo 19 > mems
|
||||
echo 19 > cpuset.mems
|
||||
|
||||
.fi
|
||||
.in
|
||||
|
@ -1052,7 +1052,7 @@ errors, as in the example:
|
|||
.in +4n
|
||||
.nf
|
||||
|
||||
/bin/echo 19 > mems
|
||||
/bin/echo 19 > cpuset.mems
|
||||
/bin/echo: write error: Invalid argument
|
||||
.fi
|
||||
.in
|
||||
|
@ -1129,16 +1129,16 @@ not already in its parent.
|
|||
.B EACCES
|
||||
Attempted to set, using
|
||||
.BR write (2),
|
||||
.I cpu_exclusive
|
||||
.I cpuset.cpu_exclusive
|
||||
or
|
||||
.I mem_exclusive
|
||||
.I cpuset.mem_exclusive
|
||||
on a cpuset whose parent lacks the same setting.
|
||||
.TP
|
||||
.B EACCES
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
a
|
||||
.I memory_pressure
|
||||
.I cpuset.memory_pressure
|
||||
file.
|
||||
.TP
|
||||
.B EACCES
|
||||
|
@ -1190,18 +1190,18 @@ attribute of that cpuset or any of its siblings.
|
|||
Attempted to
|
||||
.BR write (2)
|
||||
an empty
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
list to a cpuset which has attached processes or child cpusets.
|
||||
.TP
|
||||
.B EINVAL
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
a
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
list which included a range with the second number smaller than
|
||||
the first number.
|
||||
.TP
|
||||
|
@ -1209,30 +1209,30 @@ the first number.
|
|||
Attempted to
|
||||
.BR write (2)
|
||||
a
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
list which included an invalid character in the string.
|
||||
.TP
|
||||
.B EINVAL
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
a list to a
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
file that did not include any online CPUs.
|
||||
.TP
|
||||
.B EINVAL
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
a list to a
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
file that did not include any online memory nodes.
|
||||
.TP
|
||||
.B EINVAL
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
a list to a
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
file that included a node that held no memory.
|
||||
.TP
|
||||
.B EIO
|
||||
|
@ -1296,18 +1296,18 @@ the process ID (PID)
|
|||
of a process to a cpuset
|
||||
.I tasks
|
||||
file when the cpuset had an empty
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or empty
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
setting.
|
||||
.TP
|
||||
.B ENOSPC
|
||||
Attempted to
|
||||
.BR write (2)
|
||||
an empty
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
setting to a cpuset that
|
||||
has tasks attached.
|
||||
.TP
|
||||
|
@ -1321,9 +1321,9 @@ Attempted to remove a file from a cpuset directory.
|
|||
.TP
|
||||
.B ERANGE
|
||||
Specified a
|
||||
.I cpus
|
||||
.I cpuset.cpus
|
||||
or
|
||||
.I mems
|
||||
.I cpuset.mems
|
||||
list to the kernel which included a number too large for the kernel
|
||||
to set in its bitmasks.
|
||||
.TP
|
||||
|
@ -1349,7 +1349,7 @@ can be passed in the argument
|
|||
.IR pid .
|
||||
.\" ================== BUGS ==================
|
||||
.SH BUGS
|
||||
.I memory_pressure
|
||||
.I cpuset.memory_pressure
|
||||
cpuset files can be opened
|
||||
for writing, creation, or truncation, but then the
|
||||
.BR write (2)
|
||||
|
@ -1393,8 +1393,8 @@ and then attach the current shell to that cpuset.
|
|||
.RB "$" " cd /dev/cpuset"
|
||||
.RB "$" " mkdir Charlie"
|
||||
.RB "$" " cd Charlie"
|
||||
.RB "$" " /bin/echo 2-3 > cpus"
|
||||
.RB "$" " /bin/echo 1 > mems"
|
||||
.RB "$" " /bin/echo 2-3 > cpuset.cpus"
|
||||
.RB "$" " /bin/echo 1 > cpuset.mems"
|
||||
.RB "$" " /bin/echo $$ > tasks"
|
||||
# The current shell is now running in cpuset Charlie
|
||||
# The next line should display '/Charlie'
|
||||
|
@ -1439,9 +1439,9 @@ The following sequence of commands accomplishes this.
|
|||
.RB "$" " cd /dev/cpuset"
|
||||
.RB "$" " mkdir beta"
|
||||
.RB "$" " cd beta"
|
||||
.RB "$" " /bin/echo 16-19 > cpus"
|
||||
.RB "$" " /bin/echo 8-9 > mems"
|
||||
.RB "$" " /bin/echo 1 > memory_migrate"
|
||||
.RB "$" " /bin/echo 16-19 > cpuset.cpus"
|
||||
.RB "$" " /bin/echo 8-9 > cpuset.mems"
|
||||
.RB "$" " /bin/echo 1 > cpuset.memory_migrate"
|
||||
.RB "$" " while read i; do /bin/echo $i; done < ../alpha/tasks > tasks"
|
||||
.fi
|
||||
.in
|
||||
|
|
Loading…
Reference in New Issue