Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / flag_cpu.html
CommitLineData
920dae64
AT
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3<head>
4<title>SPARC Architectural Model: User Commands</title>
5</head>
6<body bgcolor="#FFFFFF" LANG="en-US">
7<div STYLE="margin-bottom: 0cm"></div>&nbsp;
8
9<h2>
10-cpu&nbsp;<i>cpu-set</i>
11</h2>
12
13<h4>
14NAME
15</h4>
16<ul>
17-cpu&nbsp;<i>cpu-set</i> - specifies the set of cpus used by a command
18</ul>
19
20<h4>SYNOPSIS</h4>
21<tt>
22<ul>
23-cpu&nbsp;<i>cpu-set</i>
24</ul>
25</tt>
26
27<h4>DESCRIPTION</h4>
28<ul>
29The -cpu&nbsp;flag overrides the default set of cpus used by a command.
30This set of cpus can be a single cpu or many cpus.
31Each command documents whether it accepts one or multiple cpus.
32The -cpu flag may appear multiple times on a command line. The last
33(rightmost) instance of -cpu overrides all previous appearances.
34<p>
35The -cpu&nbsp;flag accepts three formats as argument:
36<div>
37<table cellpadding="5%">
38<tr>
39<th>Format</th><th>Example</i></th><th>Meaning</i></th>
40</tr>
41</tr>
42<td valign="top">all</td><td>-cpu&nbsp;all</td>
43<td>Specifies all enabled cpus.</td>
44</tr>
45<tr valign="top">
46<td valign="top"><i>cpu-num</i></td><td valign="top">-cpu&nbsp;2</td>
47<td>Specifies a single cpu <i>cpu-num</i>.</td>
48</tr>
49<tr valign="top">
50<td valign="top"><i>cpu-range1</i>,
51<i>cpu-range2</i>,...</td><td>-cpu&nbsp;7..15</td>
52<td>Specifies one or more cpu ranges.</td>
53</table>
54</div>
55<br>
56where <i>cpu-range</i> is one of:
57<br><br>
58<div>
59<table cellpadding="5%">
60<tr>
61<th>Format</th><th>Example</i></th><th>Meaning</i></th>
62</tr>
63<tr valign="top">
64<td>
65<i>cpu-num</i></td><td>-cpu&nbsp;5</td>
66<td>Specifies a single cpu <i>cpu-num</i>.</td>
67</tr>
68<tr valign="top">
69<td><i>cpu-num1</i>..<i>cpu-num2</i></td>
70<td>-cpu&nbsp;7..15</td>
71<td>Specifies the cpus between <i>cpu-num1</i> and <i>cpu-num2</i> inclusive.</td>
72</tr>
73<tr valign="top">
74<td><i>cpu-num1</i>..<i>cpu-num2</i>:<i>stride</i>
75</td><td valign="top">-cpu&nbsp;0..31:2</td>
76<td>Specifies the cpus between <i>cpu-num1</i> and <i>cpu-num2</i> inclusive,
77skipping by <i>stride</i>.</td>
78</tr>
79</table>
80</div>
81<p>
82The different formats for a cpu range may be freely combined by
83separating with commas. For example, the cpu range
840..15:2,31..63,0x7f specifies all the even numbered cpus from 0 to
8514, all cpus from 31 to 63, and cpu 127. Overlapping ranges accumlate
86without warning or error.
87</ul>
88
89<h4>RETURN VALUES</h4>
90<ul>
91None.
92</ul>
93
94<h4>SEE ALSO</h4>
95
96<hr>
97</body>
98</html>