You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
638 lines
15 KiB
HTML
638 lines
15 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
|
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<meta name="generator" content="AsciiDoc 8.4.5" />
|
|
<title>cset-set(1)</title>
|
|
<style type="text/css">
|
|
/* Debug borders */
|
|
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
|
|
/*
|
|
border: 1px solid red;
|
|
*/
|
|
}
|
|
|
|
body {
|
|
margin: 1em 5% 1em 5%;
|
|
}
|
|
|
|
a {
|
|
color: blue;
|
|
text-decoration: underline;
|
|
}
|
|
a:visited {
|
|
color: fuchsia;
|
|
}
|
|
|
|
em {
|
|
font-style: italic;
|
|
color: navy;
|
|
}
|
|
|
|
strong {
|
|
font-weight: bold;
|
|
color: #083194;
|
|
}
|
|
|
|
tt {
|
|
color: navy;
|
|
}
|
|
|
|
h1, h2, h3, h4, h5, h6 {
|
|
color: #527bbd;
|
|
font-family: sans-serif;
|
|
margin-top: 1.2em;
|
|
margin-bottom: 0.5em;
|
|
line-height: 1.3;
|
|
}
|
|
|
|
h1, h2, h3 {
|
|
border-bottom: 2px solid silver;
|
|
}
|
|
h2 {
|
|
padding-top: 0.5em;
|
|
}
|
|
h3 {
|
|
float: left;
|
|
}
|
|
h3 + * {
|
|
clear: left;
|
|
}
|
|
|
|
div.sectionbody {
|
|
font-family: serif;
|
|
margin-left: 0;
|
|
}
|
|
|
|
hr {
|
|
border: 1px solid silver;
|
|
}
|
|
|
|
p {
|
|
margin-top: 0.5em;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
|
|
ul, ol, li > p {
|
|
margin-top: 0;
|
|
}
|
|
|
|
pre {
|
|
padding: 0;
|
|
margin: 0;
|
|
}
|
|
|
|
span#author {
|
|
color: #527bbd;
|
|
font-family: sans-serif;
|
|
font-weight: bold;
|
|
font-size: 1.1em;
|
|
}
|
|
span#email {
|
|
}
|
|
span#revnumber, span#revdate, span#revremark {
|
|
font-family: sans-serif;
|
|
}
|
|
|
|
div#footer {
|
|
font-family: sans-serif;
|
|
font-size: small;
|
|
border-top: 2px solid silver;
|
|
padding-top: 0.5em;
|
|
margin-top: 4.0em;
|
|
}
|
|
div#footer-text {
|
|
float: left;
|
|
padding-bottom: 0.5em;
|
|
}
|
|
div#footer-badges {
|
|
float: right;
|
|
padding-bottom: 0.5em;
|
|
}
|
|
|
|
div#preamble {
|
|
margin-top: 1.5em;
|
|
margin-bottom: 1.5em;
|
|
}
|
|
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
|
|
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
|
div.admonitionblock {
|
|
margin-top: 1.5em;
|
|
margin-bottom: 1.5em;
|
|
}
|
|
div.admonitionblock {
|
|
margin-top: 2.5em;
|
|
margin-bottom: 2.5em;
|
|
}
|
|
|
|
div.content { /* Block element content. */
|
|
padding: 0;
|
|
}
|
|
|
|
/* Block element titles. */
|
|
div.title, caption.title {
|
|
color: #527bbd;
|
|
font-family: sans-serif;
|
|
font-weight: bold;
|
|
text-align: left;
|
|
margin-top: 1.0em;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
div.title + * {
|
|
margin-top: 0;
|
|
}
|
|
|
|
td div.title:first-child {
|
|
margin-top: 0.0em;
|
|
}
|
|
div.content div.title:first-child {
|
|
margin-top: 0.0em;
|
|
}
|
|
div.content + div.title {
|
|
margin-top: 0.0em;
|
|
}
|
|
|
|
div.sidebarblock > div.content {
|
|
background: #ffffee;
|
|
border: 1px solid silver;
|
|
padding: 0.5em;
|
|
}
|
|
|
|
div.listingblock > div.content {
|
|
border: 1px solid silver;
|
|
background: #f4f4f4;
|
|
padding: 0.5em;
|
|
}
|
|
|
|
div.quoteblock {
|
|
padding-left: 2.0em;
|
|
margin-right: 10%;
|
|
}
|
|
div.quoteblock > div.attribution {
|
|
padding-top: 0.5em;
|
|
text-align: right;
|
|
}
|
|
|
|
div.verseblock {
|
|
padding-left: 2.0em;
|
|
margin-right: 10%;
|
|
}
|
|
div.verseblock > div.content {
|
|
white-space: pre;
|
|
}
|
|
div.verseblock > div.attribution {
|
|
padding-top: 0.75em;
|
|
text-align: left;
|
|
}
|
|
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
|
div.verseblock + div.attribution {
|
|
text-align: left;
|
|
}
|
|
|
|
div.admonitionblock .icon {
|
|
vertical-align: top;
|
|
font-size: 1.1em;
|
|
font-weight: bold;
|
|
text-decoration: underline;
|
|
color: #527bbd;
|
|
padding-right: 0.5em;
|
|
}
|
|
div.admonitionblock td.content {
|
|
padding-left: 0.5em;
|
|
border-left: 2px solid silver;
|
|
}
|
|
|
|
div.exampleblock > div.content {
|
|
border-left: 2px solid silver;
|
|
padding: 0.5em;
|
|
}
|
|
|
|
div.imageblock div.content { padding-left: 0; }
|
|
span.image img { border-style: none; }
|
|
a.image:visited { color: white; }
|
|
|
|
dl {
|
|
margin-top: 0.8em;
|
|
margin-bottom: 0.8em;
|
|
}
|
|
dt {
|
|
margin-top: 0.5em;
|
|
margin-bottom: 0;
|
|
font-style: normal;
|
|
color: navy;
|
|
}
|
|
dd > *:first-child {
|
|
margin-top: 0.1em;
|
|
}
|
|
|
|
ul, ol {
|
|
list-style-position: outside;
|
|
}
|
|
ol.arabic {
|
|
list-style-type: decimal;
|
|
}
|
|
ol.loweralpha {
|
|
list-style-type: lower-alpha;
|
|
}
|
|
ol.upperalpha {
|
|
list-style-type: upper-alpha;
|
|
}
|
|
ol.lowerroman {
|
|
list-style-type: lower-roman;
|
|
}
|
|
ol.upperroman {
|
|
list-style-type: upper-roman;
|
|
}
|
|
|
|
div.compact ul, div.compact ol,
|
|
div.compact p, div.compact p,
|
|
div.compact div, div.compact div {
|
|
margin-top: 0.1em;
|
|
margin-bottom: 0.1em;
|
|
}
|
|
|
|
div.tableblock > table {
|
|
border: 3px solid #527bbd;
|
|
}
|
|
thead {
|
|
font-family: sans-serif;
|
|
font-weight: bold;
|
|
}
|
|
tfoot {
|
|
font-weight: bold;
|
|
}
|
|
td > div.verse {
|
|
white-space: pre;
|
|
}
|
|
p.table {
|
|
margin-top: 0;
|
|
}
|
|
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
|
div.tableblock > table[frame="void"] {
|
|
border-style: none;
|
|
}
|
|
div.tableblock > table[frame="hsides"] {
|
|
border-left-style: none;
|
|
border-right-style: none;
|
|
}
|
|
div.tableblock > table[frame="vsides"] {
|
|
border-top-style: none;
|
|
border-bottom-style: none;
|
|
}
|
|
|
|
|
|
div.hdlist {
|
|
margin-top: 0.8em;
|
|
margin-bottom: 0.8em;
|
|
}
|
|
div.hdlist tr {
|
|
padding-bottom: 15px;
|
|
}
|
|
dt.hdlist1.strong, td.hdlist1.strong {
|
|
font-weight: bold;
|
|
}
|
|
td.hdlist1 {
|
|
vertical-align: top;
|
|
font-style: normal;
|
|
padding-right: 0.8em;
|
|
color: navy;
|
|
}
|
|
td.hdlist2 {
|
|
vertical-align: top;
|
|
}
|
|
div.hdlist.compact tr {
|
|
margin: 0;
|
|
padding-bottom: 0;
|
|
}
|
|
|
|
.comment {
|
|
background: yellow;
|
|
}
|
|
|
|
@media print {
|
|
div#footer-badges { display: none; }
|
|
}
|
|
|
|
div#toctitle {
|
|
color: #527bbd;
|
|
font-family: sans-serif;
|
|
font-size: 1.1em;
|
|
font-weight: bold;
|
|
margin-top: 1.0em;
|
|
margin-bottom: 0.1em;
|
|
}
|
|
|
|
div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
|
margin-top: 0;
|
|
margin-bottom: 0;
|
|
}
|
|
div.toclevel2 {
|
|
margin-left: 2em;
|
|
font-size: 0.9em;
|
|
}
|
|
div.toclevel3 {
|
|
margin-left: 4em;
|
|
font-size: 0.9em;
|
|
}
|
|
div.toclevel4 {
|
|
margin-left: 6em;
|
|
font-size: 0.9em;
|
|
}
|
|
/* Overrides for manpage documents */
|
|
h1 {
|
|
padding-top: 0.5em;
|
|
padding-bottom: 0.5em;
|
|
border-top: 2px solid silver;
|
|
border-bottom: 2px solid silver;
|
|
}
|
|
h2 {
|
|
border-style: none;
|
|
}
|
|
div.sectionbody {
|
|
margin-left: 5%;
|
|
}
|
|
|
|
@media print {
|
|
div#toc { display: none; }
|
|
}
|
|
|
|
/* Workarounds for IE6's broken and incomplete CSS2. */
|
|
|
|
div.sidebar-content {
|
|
background: #ffffee;
|
|
border: 1px solid silver;
|
|
padding: 0.5em;
|
|
}
|
|
div.sidebar-title, div.image-title {
|
|
color: #527bbd;
|
|
font-family: sans-serif;
|
|
font-weight: bold;
|
|
margin-top: 0.0em;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
|
|
div.listingblock div.content {
|
|
border: 1px solid silver;
|
|
background: #f4f4f4;
|
|
padding: 0.5em;
|
|
}
|
|
|
|
div.quoteblock-attribution {
|
|
padding-top: 0.5em;
|
|
text-align: right;
|
|
}
|
|
|
|
div.verseblock-content {
|
|
white-space: pre;
|
|
}
|
|
div.verseblock-attribution {
|
|
padding-top: 0.75em;
|
|
text-align: left;
|
|
}
|
|
|
|
div.exampleblock-content {
|
|
border-left: 2px solid silver;
|
|
padding-left: 0.5em;
|
|
}
|
|
|
|
/* IE6 sets dynamically generated links as visited. */
|
|
div#toc a:visited { color: blue; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div id="header">
|
|
<h1>
|
|
cset-set(1) Manual Page
|
|
</h1>
|
|
<h2>NAME</h2>
|
|
<div class="sectionbody">
|
|
<p>cset-set -
|
|
manage sets of cpus
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<h2 id="_synopsis">SYNOPSIS</h2>
|
|
<div class="sectionbody">
|
|
<div class="verseblock">
|
|
<div class="verseblock-content"><em>cset</em> [cset options] <em>set</em> [set options] [args]
|
|
<em>cset</em> set --help
|
|
<em>cset</em> set
|
|
<em>cset</em> set --recurse
|
|
<em>cset</em> set --list myset
|
|
<em>cset</em> set myset
|
|
<em>cset</em> set --recurse --list myset
|
|
<em>cset</em> set --cpu 2-5 --mem 0 --set newset
|
|
<em>cset</em> set --cpu 2-5 newset
|
|
<em>cset</em> set --cpu 1,2,5-7 another_set
|
|
<em>cset</em> set --destroy newset
|
|
<em>cset</em> set --destroy /mygroup_sets/my_set</div>
|
|
<div class="verseblock-attribution">
|
|
</div></div>
|
|
</div>
|
|
<h2 id="_options">OPTIONS</h2>
|
|
<div class="sectionbody">
|
|
<div class="dlist"><dl>
|
|
<dt class="hdlist1">
|
|
-h, --help
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
prints the list of options for this command
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-l, --list
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
list the named cpuset(s); if -a is used, will list members of named
|
|
cpuset; if -r is used, will list recursively
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-c CPUSPEC, --cpu=CPUSPEC
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
create or modify cpuset in the specified cpuset with CPUSPEC
|
|
specification
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-m MEMSPEC, --mem=MEMSPEC
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
specify which memory nodes to assign to the created or modified
|
|
cpuset
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-d, --destroy
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
destroy specified cpuset
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-s CPUSET, --set=CPUSET
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
specify cpuset name to be acted on
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-r, --recurse
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
do recursive listing, for use with --list
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
-v, --verbose
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
prints more detailed output, for the set command, using this flag
|
|
will not chop listing to fit in 80 columns
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
--cpu_exclusive
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
mark this cpuset as owning its CPUs exclusively
|
|
</p>
|
|
</dd>
|
|
<dt class="hdlist1">
|
|
--mem_exclusive
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
mark this cpuset as owning its MEMs exclusively
|
|
</p>
|
|
</dd>
|
|
</dl></div>
|
|
</div>
|
|
<h2 id="_description">DESCRIPTION</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>This command is used to create, modify, and destroy cpusets.
|
|
Cpusets form a tree-like structure rooted at the root cpuset
|
|
which always includes all system CPUs and all system memory
|
|
nodes.</p></div>
|
|
<div class="paragraph"><p>A cpuset is an organizational unit that defines a group of CPUs
|
|
and a group of memory nodes where a process or thread (i.e. task)
|
|
is allowed to run on. For non-NUMA machines, the memory node is
|
|
always 0 (zero) and cannot be set to anything else. For NUMA
|
|
machines, the memory node can be set to a similar specification
|
|
as the CPU definition and will tie those memory nodes to that
|
|
cpuset. You will usually want the memory nodes that belong to
|
|
the CPUs defined to be in the same cpuset.</p></div>
|
|
<div class="paragraph"><p>A cpuset can have exclusive right to the CPUs defined in it.
|
|
This means that only this cpuset can own these CPUs. Similarly,
|
|
a cpuset can have exclusive right to the memory nodes defined in
|
|
it. This means that only this cpuset can own these memory
|
|
nodes.</p></div>
|
|
<div class="paragraph"><p>Cpusets can be specified by name or by path; however, care
|
|
should be taken when specifying by name if the name is not
|
|
unique. This tool will generally not let you do destructive
|
|
things to non-unique cpuset names.</p></div>
|
|
<div class="paragraph"><p>Cpusets are uniquely specified by path. The path starts at where
|
|
the cpusets filesystem is mounted so you generally do not have to
|
|
know where that is. For example, so specify a cpuset that is
|
|
called "two" which is a subset of "one" which in turn is a subset
|
|
of the root cpuset, use the path "/one/two" regardless of where
|
|
the cpusets filesystem is mounted.</p></div>
|
|
<div class="paragraph"><p>When specifying CPUs, a so-called CPUSPEC is used. The CPUSPEC
|
|
will accept a comma-separated list of CPUs and inclusive range
|
|
specifications. For example, --cpu=1,3,5-7 will assign CPU1,
|
|
CPU3, CPU5, CPU6, and CPU7 to the specified cpuset.</p></div>
|
|
<div class="paragraph"><p>Note that cpusets follow certain rules. For example, children
|
|
can only include CPUs that the parents already have. If you do
|
|
not follow those rules, the kernel cpuset subsystem will not let
|
|
you create that cpuset. For example, if you create a cpuset that
|
|
contains CPU3, and then attempt to create a child of that cpuset
|
|
with a CPU other than 3, you will get an error, and the cpuset
|
|
will not be active. The error is somewhat cryptic in that it is
|
|
usually a "Permission denied" error.</p></div>
|
|
<div class="paragraph"><p>Memory nodes are specified with a MEMSPEC in a similar way to
|
|
the CPUSPEC. For example, --mem=1,3-6 will assign MEM1, MEM3,
|
|
MEM4, MEM5, and MEM6 to the specified cpuset.</p></div>
|
|
<div class="paragraph"><p>Note that if you attempt to create or modify a cpuset with a
|
|
memory node specification that is not valid, you may get a
|
|
cryptic error message, "No space left on device", and the
|
|
modification will not be allowed.</p></div>
|
|
<div class="paragraph"><p>When you destroy a cpuset, then the tasks running in that set are
|
|
moved to the parent of that cpuset. If this is not what you
|
|
want, then manually move those tasks to the cpuset of your choice
|
|
with the <em>cset proc</em> command (see <em>cset proc --help</em> for more
|
|
information).</p></div>
|
|
<h3 id="_examples">EXAMPLES</h3><div style="clear:left"></div>
|
|
<div class="dlist"><dl>
|
|
<dt class="hdlist1">
|
|
Create a cpuset with the default memory specification
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
<strong><tt># cset set --cpu=2,4,6-8 --set=new_set</tt></strong>
|
|
</p>
|
|
</dd>
|
|
</dl></div>
|
|
<div class="paragraph"><p>This command creates a cpuset called "new_set" located
|
|
off the root cpuset which holds CPUS 2,4,6,7,8 and node 0
|
|
(interleaved) memory. Note that --set is optional, and
|
|
you can just specify the name for the new cpuset after
|
|
all arguments.</p></div>
|
|
<div class="dlist"><dl>
|
|
<dt class="hdlist1">
|
|
Create a cpuset that specifies both CPUs and memory nodes
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
<strong><tt># cset set --cpu=3 --mem=3 /rad/set_one</tt></strong>
|
|
</p>
|
|
</dd>
|
|
</dl></div>
|
|
<div class="paragraph"><p>Note that this command uses the full path method to
|
|
specify the name of the new cpuset "/rad/set_one". It
|
|
also names the new cpuset implicitly (i.e. no --set
|
|
option, although you can use that if you want to). If
|
|
the "set_one" name is unique, you can subsequently refer
|
|
to is just by that. Memory node 3 is assigned to this
|
|
cpuset as well as CPU 3.</p></div>
|
|
<div class="paragraph"><p>The above commands will create the new cpusets, or if they
|
|
already exist, they will modify them to the new specifications.</p></div>
|
|
</div>
|
|
<h2 id="_license">LICENSE</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Cpuset is licensed under the GNU GPL V2 only.</p></div>
|
|
</div>
|
|
<h2 id="_copyright">COPYRIGHT</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Copyright (c) 2008-2011 Novell Inc.</p></div>
|
|
</div>
|
|
<h2 id="_author">AUTHOR</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Written by Alex Tsariounov <alext@novell.com>.</p></div>
|
|
</div>
|
|
<h2 id="_see_also">SEE ALSO</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>cset(1), cset-proc(1), cset-shield(1)</p></div>
|
|
<div class="paragraph"><p>/usr/share/doc/packages/cpuset/html/tutorial.html</p></div>
|
|
<div class="paragraph"><p>taskset(1), chrt(1)</p></div>
|
|
<div class="paragraph"><p>/usr/src/linux/Documentation/cpusets.txt</p></div>
|
|
</div>
|
|
<div id="footer">
|
|
<div id="footer-text">
|
|
Version 1.5.6<br />
|
|
Last updated 2011-06-09 12:53:27 EDT
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|