dbgarchlib.html

vxworks相关论文

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void fsrShow
    (
    UINT fsrValue /* fsr value to show */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the meaning of all the fields in a specified <b>fsr</b> value,
symbolically.
<p>
Extracted from <b>reg.h</b>:
<pre>Definition of bits in the Sun-4 FSR (Floating-point Status Register)
  -------------------------------------------------------------
 |  RD |  RP | TEM |  res | FTT | QNE | PR | FCC | AEXC | CEXC |
 |-----|---- |-----|------|-----|-----|----|-----|------|------|
  31 30 29 28 27 23 22  17 16 14   13   12  11 10 9    5 4    0
</pre>
For compatibility with future revisions, reserved bits are defined to be
initialized to zero and, if written, must be preserved.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>    -&gt; fsrShow 0x12345678
    Rounding Direction: nearest or even if tie.
    Rounding Precision: single.
    Trap Enable Mask:
       underflow.
    Floating-point Trap Type: IEEE exception.
    Queue Not Empty: FALSE;
    Partial Remainder: TRUE;
    Condition Codes: less than.
    Accumulated exceptions:
       inexact divide-by-zero invalid.
    Current exceptions:
       overflow invalid
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>SPARC Architecture Manual </i>

<hr>
<a name="o0"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>o0</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>o0</i>(&nbsp;)</strong> - return the contents of register <b>o0</b> (also <b>o1</b> - <b>o7</b>) (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int o0
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of out register <b>o0</b> from the TCB of a
specified task.  If <i>taskId</i> is omitted or 0, the current default task is
assumed.
<p>
Similar routines are provided for all out registers (<b>o0</b> - <b>o7</b>):
<b><i><a href="./dbgArchLib.html#o0">o0</a></i>(&nbsp;)</b> - <b><i>o7</i>(&nbsp;)</b>.
<p>
The stack pointer is accessed via <b>o6</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register <b>o0</b> (or the requested register).
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="l0"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>l0</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>l0</i>(&nbsp;)</strong> - return the contents of register <b>l0</b> (also <b>l1</b> - <b>l7</b>) (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int l0
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of local register <b>l0</b> from the TCB of a
specified task.  If <i>taskId</i> is omitted or 0, the current default task is
assumed.
<p>
Similar routines are provided for all local registers (<b>l0</b> - <b>l7</b>):
<b><i><a href="./dbgArchLib.html#l0">l0</a></i>(&nbsp;)</b> - <b><i>l7</i>(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register <b>l0</b> (or the requested register).
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="i0"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>i0</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>i0</i>(&nbsp;)</strong> - return the contents of register <b>i0</b> (also <b>i1</b> - <b>i7</b>) (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int i0
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of in register <b>i0</b> from the TCB of a
specified task.  If <i>taskId</i> is omitted or 0, the current default task is
assumed.
<p>
Similar routines are provided for all in registers (<b>i0</b> - <b>i7</b>):
<b><i><a href="./dbgArchLib.html#i0">i0</a></i>(&nbsp;)</b> - <b><i>i7</i>(&nbsp;)</b>.
<p>
The frame pointer is accessed via <b>i6</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register <b>i0</b> (or the requested register).
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="npc"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>npc</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>npc</i>(&nbsp;)</strong> - return the contents of the next program counter (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int npc
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of the next program counter from the TCB
of a specified task.  If <i>taskId</i> is omitted or 0, the current default
task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the next program counter.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <b><i><a href="./usrLib.html#ti">ti</a></i>(&nbsp;)</b>

<hr>
<a name="psr"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>psr</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>psr</i>(&nbsp;)</strong> - return the contents of the processor status register (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int psr
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of the processor status register from
the TCB of a specified task.  If <i>taskId</i> is omitted or 0, the default
task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the processor status register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <b><i><a href="./dbgArchLib.html#psrShow">psrShow</a></i>(&nbsp;)</b>,  
<i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="wim"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>wim</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>wim</i>(&nbsp;)</strong> - return the contents of the window invalid mask register (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int wim
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of the window invalid mask register from
the TCB of a specified task.  If <i>taskId</i> is omitted or 0, the default
task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the window invalid mask register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="y"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>y</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>y</i>(&nbsp;)</strong> - return the contents of the <b>y</b> register (SPARC)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int y
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of the <b>y</b> register from the TCB of a
specified task.  If <i>taskId</i> is omitted or 0, the default task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the y register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="pfp"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>pfp</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>pfp</i>(&nbsp;)</strong> - return the contents of register <b>pfp</b> (i960)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int pfp
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register <b>pfp</b>, the previous frame
pointer, from the TCB of a specified task.
If <i>taskId</i> is omitted or 0, the current default task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the <b>pfp</b> register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="tsp"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>tsp</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tsp</i>(&nbsp;)</strong> - return the contents of register <b>sp</b> (i960)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int tsp
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register <b>sp</b>, the stack pointer,
from the TCB of a specified task.
If <i>taskId</i> is omitted or 0, the current default task is assumed.
<p>
Note:  The name <b><i><a href="./dbgArchLib.html#tsp">tsp</a></i>(&nbsp;)</b> is used because <b><i><a href="./usrLib.html#sp">sp</a></i>(&nbsp;)</b> (the logical name choice)
conflicts with the routine <b><i><a href="./usrLib.html#sp">sp</a></i>(&nbsp;)</b> for spawning a task with default parameters.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the <b>sp</b> register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="rip"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>rip</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>rip</i>(&nbsp;)</strong> - return the contents of register <b>rip</b> (i960)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int rip
    (
    int taskId /* task ID, 0 means default task */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register <b>rip</b>, the return
instruction pointer, from the TCB of a specified task.
If <i>taskId</i> is omitted or 0, the current default task is assumed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of the <b>rip</b> register.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Target Shell</i>

<hr>
<a name="r3"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>r3</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>r3</i>(&nbsp;)</strong> - return the contents of register <b>r3</b> (also <b>r4</b> - <b>r15</b>) (i960)</p>