Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_set.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>
set
</h2>
<h4>
NAME
</h4>
<ul>
set - set a value to a specified physical address
</ul>
<h4>SYNOPSIS</h4>
<tt>
<ul>
set [-cpu <i>cpu_set</i>]
[-pa|-ra|-va] [-context_id <i>context</i>] [-partition-id
<i>partition</i>] [-size <i>size</i>] [-count <i>count</i>]
<i>address</i> <i>value</i>
<p>
<b>deprecated form:</b><br>
set [-cpu <i>cpu_set</i>]
[-pa|-ra|-va] [-context_id <i>context</i>] [-partition-id
<i>partition</i>] <i>address</i> <i>value</i> <i>size</i>
</ul>
</tt>
<p>
<h4>DESCRIPTION</h4>
<ul>
Set physical memory at location <i>address</i> to <i>value</i>.
The size option determines how many bytes are written.
Valid size options are 1, 2, 4, or 8.
The default size is 4 bytes.
The -count option lets <i>value</i> to be written to consecutive
locations of size <i>size</i>, starting at <i>address</i>.
The default count is 1.
If specified, the arguments <i>size</i> and <i>count</i> determine the
width of each write and how many writes occur.
Each write advances through memory by <i>size</i> bytes.
<p>
In the deprecated form, the default size argument is 4 bytes, but can be 1,
2, 4, and 8*N (N > 0) bytes.
<p>
The behaviour of set is undefined if <i>value</i> does not fit in the
specified size in bytes.
<p>
By default, <i>address</i> is treated as physical.
The -pa, -ra, and -va flags override this default.
More details on these and the -context and -partition flags can
be found <a href="flag_addressing_options.html">here</a>.
If -va is given, <i>address</i> is virtual and is translated in the context
of the current cpu, specified by <a href="cmd_pselect.html">pselect</a>.
This may be overriden by the <a href="flag_cpu.html">-cpu</a> flag.
</ul>
<p>
<h4>RETURN VALUES</h4>
<ul>
None.
</ul>
<h4>SEE ALSO</h4>
<ul><a href="cmd_get.html">get</a></ul>
<hr>
</body>
</html>