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:
Simon Paillard 2013-02-08 10:07:18 +01:00 committed by Michael Kerrisk
parent 7521bf1b61
commit 0a61a4f401
1 changed files with 49 additions and 49 deletions

View File

@ -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