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