Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / sam / docs / ui-cmds / cmd_pregs.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>
pregs
</h2>
<h4>
NAME
</h4>
<ul>
pregs - print cpu architecture registers
</ul>
<h4>SYNOPSIS</h4>
<tt>
<ul>
pregs [-w|-g|-f|-df|-pr|-asr|-hpr|-trap]
[-cpu <i>cpu_set</i>]
[-cwp <i>window-pointer</i>] [-gl <i>global-level</i>] [-tl <i>trap-level</i>]
</ul>
</tt>
<h4>DESCRIPTION</h4>
<ul>
Prints cpu registers.
<p>
By default, only the registers of the cpu specified by <a
href="cmd_pselect.html">pselect</a> are printed.
The <a href="flag_cpu.html">-cpu</a> flag may be used to override this.
<p>
The -w ,-g, -f, -df, -pr, -asr, -hpr, and -trap flags select which
registers are printed. If none of these are given, pregs prints the
windowed and global registers plus the pc, npc, tt, tl, gl, cwp,
pstate, and hpstate registers.
<p>
The -w ,-g, -f, -df, -asr, -pr, -hpr, and -trap flags may be used in
any combination. The registers they output are as follows:
<br><br>
<table cellpadding=5%>
<tr>
<th>Flag</th><th>Register Set</i></th>
</tr>
<tr>
<td valign="top">-w</td><td>The windowed registers: i0-i7, o0-o7, l0-l7</td>
</tr>
<tr>
<td valign="top">-g</td><td>The global registers: g0-g7</td>
</tr>
<tr>
<td valign="top">-f</td><td>The single precision floating point
registers: f0-f31 and fsr</td>
</tr>
<tr>
<td valign="top">-df</td><td>The double precision floating point
registers: d0-d62 and fsr</td>
</tr>
<tr>
<td valign="top">-asr</td><td>ASR related registers:
y, ccr, asi, tick, pc, fprs, pcr, pic, gsr, softint_set, softint_clr,
softint, tick_cmpr, stick, and stick_cmpr
</td>
</tr>
<tr>
<td valign="top">-pr</td><td>Privileged registers:
tpc, tnpc, tstate, tt, pr_tick, tba, pstate, tl, pil, cwp,
cansave, canrestore, cleanwin, otherwin, wstate, and gl
</td>
</tr>
<tr>
<td valign="top">-hpr</td><td>Hyperprivileged registers:
hpstate, htstate, hintp, htba, hver, and hstick_cmpr</td>
</tr>
<tr>
<td valign="top">-trap</td><td>Trap related registers: tpc, tnpc, tstate, tt, pstate,
tl, cwp, gl</td>
</tr>
</table><br>
<p>
By default, the current cwp register, global level, and trap level are
used to access windowed registers, global registers, and trap
registers, respectively.
<br><br>
<table cellpadding=5%>
<tr>
<th>Flag</th><th>Behavior</i></th>
</tr>
<tr>
<td valign="top">-cwp <i>window-pointer</i></td><td>Sets the register window used to access
windowed registers</td>
</tr>
<tr>
<td valign="top">-gl <i>global-level</i></td><td>Sets the global level used to access global
registers</td>
</tr>
<tr>
<td valign="top">-tl <i>trap-level</i></td><td>Sets the trap level used to access trap
registers</td>
</tr>
</table>
</ul>
<h4>RETURN VALUES</h4>
<ul>
Print the value of cpu architecture registers.
</ul>
<h4>SEE ALSO</h4>
<ul><a href="cmd_read-reg.html">read-reg</a></ul>
<hr>
</body>
</html>