cpuset/doc/cset.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.3.3" />
<title>cset(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#revision {
  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,
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
  margin-right: 10%;
  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 {
  margin-right: 0%;
}
div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock {
  padding-left: 2.0em;
}
div.quoteblock > div.attribution {
  padding-top: 0.5em;
  text-align: right;
}

div.verseblock {
  padding-left: 2.0em;
}
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; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }

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;
}

@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(1) Manual Page
</h1>
<h2>NAME</h2>
<div class="sectionbody">
<p>cset -
   manage cpusets functions in the Linux kernel
</p>
</div>
</div>
<h2>SYNOPSIS</h2>
<div class="sectionbody">
<div class="verseblock">
<div class="verseblock-content"><em>cset</em> [--version | --help | --tohex]
<em>cset</em> [help &lt;command&gt; | &lt;command&gt; --help]
<em>cset</em> [cset options] &lt;command&gt; [command options] [args]</div>
<div class="verseblock-attribution">
</div></div>
</div>
<h2 id="_description">DESCRIPTION</h2>
<div class="sectionbody">
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">In general, you need to have root permissions to run cset.  The
tool mounts the cpusets filesystem and manipulates it.  Non-root users
do not have permission for these actions.</td>
</tr></table>
</div>
<div class="paragraph"><p>Cpuset is a Python application to make using the cpusets facilities in
the Linux kernel easier. The actual included command is called <em>cset</em>
and it allows manipulation of cpusets on the system and provides
higher level functions such as implementation and control of a basic
cpu shielding setup.</p></div>
<h3 id="_typical_uses_of_cpuset_include">Typical uses of cpuset include</h3><div style="clear:left"></div>
<div class="dlist"><dl>
<dt class="hdlist1">
Setting up and managing a simple shielded CPU environment
</dt>
<dd>
<p>
        The concept of <em>shielded</em> cpus is that a certain number of
        cpus are partitioned off on the system and only processes that
        are of interest are run on these cpus (i.e., inside the shield).
</p>
<div class="paragraph"><p>For a simple shielded configuration, one typically uses three cpusets:
the root set, a system set and a user set.  <em>Cset</em> includes a super
command that implements this strategy and lets you easily manage it.
See <em>cset-shield(1)</em> for more details.</p></div>
</dd>
<dt class="hdlist1">
Setting up and managing a complex shielding environment
</dt>
<dd>
<p>
        Shielding can be more complex of course where concepts such as
        priority cpusets and intersecting cpuset can be used.  You can
        use <em>cset</em> to help manage this type of shielding as well.  You
        will need to use the <em>cset-set(1)</em> and <em>cset-proc(1)</em>
        subcommands directly to do that.
</p>
</dd>
<dt class="hdlist1">
Managing cpusets on the system
</dt>
<dd>
<p>
        The cset subcommand <em>cset-set(1)</em> allows you to create and
        destroy arbitrary cpusets on the system and assign arbitrary
        cpus and memory nodes to them.  The cpusets so created have to
        follow the Linux kernel cpuset rules.  See the <em>cset-set(1)</em>
        subcommand for more details.
</p>
</dd>
<dt class="hdlist1">
Managing processes that run on various system cpusets
</dt>
<dd>
<p>
        The cset subcommand <em>cset-proc(1)</em> allows you to manage
        processes running on various cpusets created on the system.
        You can exec new processes in specific cpusets and move tasks
        around existing cpusets.  See the <em>cset-proc(1)</em> subcommand
        for more details.
</p>
</dd>
</dl></div>
</div>
<h2 id="_options">OPTIONS</h2>
<div class="sectionbody">
<div class="paragraph"><p>The following generic option flags are available.  Additional options
are available per-command, and documented in the command-specific
documentation.</p></div>
<div class="dlist"><dl>
<dt class="hdlist1">
<em>cset</em> --version
</dt>
<dd>
<p>
        Display version information and exits.
</p>
</dd>
<dt class="hdlist1">
<em>cset</em> --help
</dt>
<dd>
<p>
        Prints the synopsis and a list of all commands.
</p>
</dd>
<dt class="hdlist1">
<em>cset</em> --log &lt;filename&gt;
</dt>
<dd>
<p>
        Creates a log file for the current run.  All manner of useful
        information is stored in this file.  This is usually used to
        debug cpuset when things don&#8217;t go as planned.
</p>
</dd>
<dt class="hdlist1">
<em>cset</em> --machine
</dt>
<dd>
<p>
        Makes cset output information for all operations in a format
        that is machine readable (i.e. easy to parse).
</p>
</dd>
<dt class="hdlist1">
<em>cset</em> --tohex &lt;CPUSPEC&gt;
</dt>
<dd>
<p>
        Converts a CPUSPEC (see <em>cset-set(1)</em> for definition) to a
        hexadecimal number and outputs it.  Useful for setting IRQ
        stub affinity to a cpuset definition.
</p>
</dd>
</dl></div>
</div>
<h2 id="_cpuset_commands">CPUSET COMMANDS</h2>
<div class="sectionbody">
<div class="paragraph"><p>The cpuset commands are divided into groups, according to the primary
purpose of those commands.  Following is a short description of each
command. A more detailed description is available in individual
command manpages.  Those manpages are named <em>cset-&lt;command&gt;(1)</em>. The
first command, <em>help</em>, is especially useful as it prints out a long
summary of what a particular command does.</p></div>
<div class="dlist"><dl>
<dt class="hdlist1">
<em>cset help command</em>
</dt>
<dd>
<p>
        print out a lengthy summary of how the specified subcommand
        works
</p>
</dd>
<dt class="hdlist1">
<em>cset command --help</em>
</dt>
<dd>
<p>
        print out an extended synopsis of the specified subcommand
</p>
</dd>
<dt class="hdlist1">
<em>cset shield</em>
</dt>
<dd>
<p>
        supercommand to set up and manage basic shielding (see
        <em>cset-shield(1)</em>)
</p>
</dd>
<dt class="hdlist1">
<em>cset set</em>
</dt>
<dd>
<p>
        create, modify and destroy cpusets (see <em>cset-set(1)</em>)
</p>
</dd>
<dt class="hdlist1">
<em>cset proc</em>
</dt>
<dd>
<p>
        create and manage processes within cpusets (see
        <em>cset-proc(1)</em>)
</p>
</dd>
</dl></div>
</div>
<h2 id="_files">FILES</h2>
<div class="sectionbody">
<div class="paragraph"><p>Cpuset uses a configuration file if present on the system.  The file
is <em>/etc/cset.conf</em> and may contain the following options.</p></div>
<div class="dlist"><dl>
<dt class="hdlist1">
mountpoint = &lt;directory_name&gt;
</dt>
<dd>
<p>
        Specify the mountpoint where the cpuset filesystem is to be
        mounted.  By default this is <em>/cpusets</em>; however, some people
        prefer to mount this in the more traditional <em>/dev/cpusets</em>.
</p>
</dd>
</dl></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-2009 Novell Inc.</p></div>
</div>
<h2 id="_author">AUTHOR</h2>
<div class="sectionbody">
<div class="paragraph"><p>Written by Alex Tsariounov &lt;alext@novell.com&gt;</p></div>
<div class="paragraph"><p>Some substrate code and ideas were taken from the excellent Stacked
GIT (stgit) v0.13 (see http://gna.org/projects/stgit  and
http://www.procode.org/stgit).  Stacked GIT is under GPL V2 or later.</p></div>
</div>
<h2 id="_see_also">SEE ALSO</h2>
<div class="sectionbody">
<div class="paragraph"><p>cset-set(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.0<br />
Last updated 2009-02-25 12:42:05 MDT
</div>
</div>
</body>
</html>