sam-t2/sam/docs/ui-cmds/flag_cpu.html

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>SPARC Architectural Model: User Commands</title>
</head>
<body bgcolor="#FFFFFF" LANG="en-US">
<div STYLE="margin-bottom: 0cm"></div>&nbsp;

<h2>
-cpu&nbsp;<i>cpu-set</i>
</h2>

<h4>
NAME
</h4>
<ul>
-cpu&nbsp;<i>cpu-set</i> - specifies the set of cpus used by a command
</ul>

<h4>SYNOPSIS</h4>
<tt>
<ul>
-cpu&nbsp;<i>cpu-set</i>
</ul>
</tt>

<h4>DESCRIPTION</h4>
<ul>
The -cpu&nbsp;flag overrides the default set of cpus used by a command.
This set of cpus can be a single cpu or many cpus.
Each command documents whether it accepts one or multiple cpus.
The -cpu flag may appear multiple times on a command line.  The last
(rightmost) instance of -cpu overrides all previous appearances.
<p>
The -cpu&nbsp;flag accepts three formats as argument:
<div>
<table cellpadding="5%">
<tr>
<th>Format</th><th>Example</i></th><th>Meaning</i></th>
</tr>
</tr>
<td valign="top">all</td><td>-cpu&nbsp;all</td>
<td>Specifies all enabled cpus.</td>
</tr>
<tr valign="top">
<td valign="top"><i>cpu-num</i></td><td valign="top">-cpu&nbsp;2</td>
<td>Specifies a single cpu <i>cpu-num</i>.</td>
</tr>
<tr valign="top">
<td valign="top"><i>cpu-range1</i>,
<i>cpu-range2</i>,...</td><td>-cpu&nbsp;7..15</td>
<td>Specifies one or more cpu ranges.</td>
</table>
</div>
<br>
where <i>cpu-range</i> is one of:
<br><br>
<div>
<table cellpadding="5%">
<tr>
<th>Format</th><th>Example</i></th><th>Meaning</i></th>
</tr>
<tr valign="top">
<td>
<i>cpu-num</i></td><td>-cpu&nbsp;5</td>
<td>Specifies a single cpu <i>cpu-num</i>.</td>
</tr>
<tr valign="top">
<td><i>cpu-num1</i>..<i>cpu-num2</i></td>
<td>-cpu&nbsp;7..15</td>
<td>Specifies the cpus between <i>cpu-num1</i> and <i>cpu-num2</i> inclusive.</td>
</tr>
<tr valign="top">
<td><i>cpu-num1</i>..<i>cpu-num2</i>:<i>stride</i>
</td><td valign="top">-cpu&nbsp;0..31:2</td>
<td>Specifies the cpus between <i>cpu-num1</i> and <i>cpu-num2</i> inclusive,
skipping by <i>stride</i>.</td>
</tr>
</table>
</div>
<p>
The different formats for a cpu range may be freely combined by
separating with commas.  For example, the cpu range
0..15:2,31..63,0x7f specifies all the even numbered cpus from 0 to
14, all cpus from 31 to 63, and cpu 127.  Overlapping ranges accumlate
without warning or error.
</ul>

<h4>RETURN VALUES</h4>
<ul>
None.
</ul>

<h4>SEE ALSO</h4>

<hr>
</body>
</html>