Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_get.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>
get
</h2>
<h4>
NAME
</h4>
<ul>
get - get value of physical address
</ul>
<h4>SYNOPSIS</h4>
<tt>
<ul>
get [-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>
<p>
<b>deprecated form:</b><br>
get [-cpu <i>cpu_set</i>]
[-pa|-ra|-va] [-context_id <i>context</i>]
[-partition-id <i>partition</i>]
<i>address</i> [<i>size</i>]
</ul>
</tt>
<p>
<h4>DESCRIPTION</h4>
<ul>
Get value(s) of memory location(s).
The -count option determines the number of values to get from
memoryi. The default is get one value. The size option determines the
size of a value. Valid size options are 1, 2, 4, or 8. The default
size is 4 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>
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>
Returns the value of a specified memory location.
</ul>
<h4>SEE ALSO</h4>
<ul><a href="cmd_set.html">set</a></ul>
<hr>
</body>
</html>