Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_set.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>
10set
11</h2>
12
13<h4>
14NAME
15</h4>
16<ul>
17set - set a value to a specified physical address
18</ul>
19
20<h4>SYNOPSIS</h4>
21<tt>
22<ul>
23set [-cpu <i>cpu_set</i>]
24[-pa|-ra|-va] [-context_id <i>context</i>] [-partition-id
25<i>partition</i>] [-size <i>size</i>] [-count <i>count</i>]
26<i>address</i> <i>value</i>
27<p>
28<b>deprecated form:</b><br>
29set [-cpu <i>cpu_set</i>]
30[-pa|-ra|-va] [-context_id <i>context</i>] [-partition-id
31<i>partition</i>] <i>address</i> <i>value</i> <i>size</i>
32</ul>
33</tt>
34<p>
35<h4>DESCRIPTION</h4>
36<ul>
37Set physical memory at location <i>address</i> to <i>value</i>.
38The size option determines how many bytes are written.
39Valid size options are 1, 2, 4, or 8.
40The default size is 4 bytes.
41The -count option lets <i>value</i> to be written to consecutive
42locations of size <i>size</i>, starting at <i>address</i>.
43The default count is 1.
44If specified, the arguments <i>size</i> and <i>count</i> determine the
45width of each write and how many writes occur.
46Each write advances through memory by <i>size</i> bytes.
47<p>
48In the deprecated form, the default size argument is 4 bytes, but can be 1,
492, 4, and 8*N (N > 0) bytes.
50<p>
51The behaviour of set is undefined if <i>value</i> does not fit in the
52specified size in bytes.
53<p>
54By default, <i>address</i> is treated as physical.
55The -pa, -ra, and -va flags override this default.
56More details on these and the -context and -partition flags can
57be found <a href="flag_addressing_options.html">here</a>.
58If -va is given, <i>address</i> is virtual and is translated in the context
59of the current cpu, specified by <a href="cmd_pselect.html">pselect</a>.
60This may be overriden by the <a href="flag_cpu.html">-cpu</a> flag.
61</ul>
62<p>
63<h4>RETURN VALUES</h4>
64<ul>
65None.
66</ul>
67
68<h4>SEE ALSO</h4>
69<ul><a href="cmd_get.html">get</a></ul>
70
71<hr>
72</body>
73</html>