cpuset/doc/cset-set.html

638 lines
15 KiB
HTML
Raw Normal View History

<!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" />
2009-12-08 04:52:22 +00:00
<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;
2009-12-08 04:52:22 +00:00
color: navy;
}
strong {
font-weight: bold;
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
h1, h2, h3 {
border-bottom: 2px solid silver;
}
h2 {
padding-top: 0.5em;
}
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
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 {
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
div.quoteblock {
padding-left: 2.0em;
margin-right: 10%;
}
2009-12-08 04:52:22 +00:00
div.quoteblock > div.attribution {
padding-top: 0.5em;
text-align: right;
}
2009-12-08 04:52:22 +00:00
div.verseblock {
padding-left: 2.0em;
margin-right: 10%;
2009-12-08 04:52:22 +00:00
}
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;
2009-12-08 04:52:22 +00:00
font-style: normal;
color: navy;
}
dd > *:first-child {
2009-12-08 04:52:22 +00:00
margin-top: 0.1em;
}
ul, ol {
list-style-position: outside;
}
2009-12-08 04:52:22 +00:00
ol.arabic {
list-style-type: decimal;
}
ol.loweralpha {
list-style-type: lower-alpha;
}
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
div.hdlist {
margin-top: 0.8em;
margin-bottom: 0.8em;
}
2009-12-08 04:52:22 +00:00
div.hdlist tr {
padding-bottom: 15px;
}
dt.hdlist1.strong, td.hdlist1.strong {
font-weight: bold;
}
td.hdlist1 {
vertical-align: top;
2009-12-08 04:52:22 +00:00
font-style: normal;
padding-right: 0.8em;
2009-12-08 04:52:22 +00:00
color: navy;
}
2009-12-08 04:52:22 +00:00
td.hdlist2 {
vertical-align: top;
}
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
margin-top: 0;
margin-bottom: 0;
}
div.toclevel2 {
margin-left: 2em;
2009-12-08 04:52:22 +00:00
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%;
}
2009-12-08 04:52:22 +00:00
@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 {
2009-12-08 04:52:22 +00:00
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;
}
2009-12-08 04:52:22 +00:00
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">
2009-12-08 04:52:22 +00:00
<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
2009-12-08 04:52:22 +00:00
<em>cset</em> set --destroy /mygroup_sets/my_set</div>
<div class="verseblock-attribution">
</div></div>
</div>
2009-12-08 04:52:22 +00:00
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
2009-12-08 04:52:22 +00:00
<div class="dlist"><dl>
<dt class="hdlist1">
-h, --help
</dt>
<dd>
<p>
prints the list of options for this command
</p>
</dd>
2009-12-08 04:52:22 +00:00
<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>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
-c CPUSPEC, --cpu=CPUSPEC
</dt>
<dd>
<p>
create or modify cpuset in the specified cpuset with CPUSPEC
specification
</p>
</dd>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
-m MEMSPEC, --mem=MEMSPEC
</dt>
<dd>
<p>
specify which memory nodes to assign to the created or modified
cpuset
</p>
</dd>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
-d, --destroy
</dt>
<dd>
<p>
destroy specified cpuset
</p>
</dd>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
-s CPUSET, --set=CPUSET
</dt>
<dd>
<p>
specify cpuset name to be acted on
</p>
</dd>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
-r, --recurse
</dt>
<dd>
<p>
do recursive listing, for use with --list
</p>
</dd>
2009-12-08 04:52:22 +00:00
<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>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
--cpu_exclusive
</dt>
<dd>
<p>
mark this cpuset as owning its CPUs exclusively
</p>
</dd>
2009-12-08 04:52:22 +00:00
<dt class="hdlist1">
--mem_exclusive
</dt>
<dd>
<p>
mark this cpuset as owning its MEMs exclusively
</p>
</dd>
2009-12-08 04:52:22 +00:00
</dl></div>
</div>
2009-12-08 04:52:22 +00:00
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
2009-12-08 04:52:22 +00:00
<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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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,
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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,
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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>
2009-12-08 04:52:22 +00:00
</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
2009-12-08 04:52:22 +00:00
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>
2009-12-08 04:52:22 +00:00
</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
2009-12-08 04:52:22 +00:00
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
2009-12-08 04:52:22 +00:00
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>
2009-12-08 04:52:22 +00:00
<h2 id="_license">LICENSE</h2>
<div class="sectionbody">
2009-12-08 04:52:22 +00:00
<div class="paragraph"><p>Cpuset is licensed under the GNU GPL V2 only.</p></div>
</div>
2009-12-08 04:52:22 +00:00
<h2 id="_copyright">COPYRIGHT</h2>
<div class="sectionbody">
<div class="paragraph"><p>Copyright (c) 2008-2010 Novell Inc.</p></div>
</div>
2009-12-08 04:52:22 +00:00
<h2 id="_author">AUTHOR</h2>
<div class="sectionbody">
2009-12-08 04:52:22 +00:00
<div class="paragraph"><p>Written by Alex Tsariounov &lt;alext@novell.com&gt;.</p></div>
</div>
2009-12-08 04:52:22 +00:00
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
2009-12-08 04:52:22 +00:00
<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.3<br />
Last updated 2010-02-11 13:36:30 MDT
</div>
</div>
</body>
</html>