dbgarchlib.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS psrShow
    (
    UINT32 psrval             /* psr value to show */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the meaning of all fields in a specified PSR value,
symbolically.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, always.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>

<hr>
<a name="r0_1"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>r0(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>r0(&nbsp;)</strong> - return the contents of general register <b>r0</b> (also <b>r1</b>-<b>r15</b>) (SH)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register <b>r0</b> from the TCB of a specified
task.  If <i>taskId</i> is omitted or zero, the last task referenced is assumed.
<p>
Similar routines are provided for all general registers (<b>r1</b> - <b>r15</b>):
<b>r1(&nbsp;)</b> - <b>r15(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register r0 (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: Debugging</i>
<p>


<hr>
<a name="sr_1"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>sr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>sr(&nbsp;)</strong> - return the contents of control register <b>sr</b> (also <b>gbr</b>, <b>vbr</b>) (SH)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register sr from the TCB of a specified
task.  If <i>taskId</i> is omitted or zero, the last task referenced is assumed.
<p>
Similar routines are provided for all control registers (<b>gbr</b>, <b>vbr</b>):
<b>gbr(&nbsp;)</b>, <b>vbr(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register sr (or the requested control register).
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Debugging</i>
<p>


<hr>
<a name="mach"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>mach(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>mach(&nbsp;)</strong> - return the contents of system register <b>mach</b> (also <b>macl</b>, <b>pr</b>) (SH)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register mach from the TCB of
a specified task.  If <i>taskId</i> is omitted or zero, the last task referenced
is assumed.
<p>
Similar routines are provided for other system registers (<b>macl</b>, <b>pr</b>):
<b>macl(&nbsp;)</b>, <b>pr(&nbsp;)</b>.  Note that <b><a href="./usrLib.html#pc">pc</a>(&nbsp;)</b> is provided by <b>usrLib.c</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register mach (or the requested system register).
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <i>VxWorks Programmer's Guide: Debugging</i>
<p>


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

</blockquote><h1>o0(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>o0(&nbsp;)</strong> - return the contents of register o0 (also o1-o7) (SimSolaris)</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 o0 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 (o0 - o7):
<b><a href="./dbgArchLib.html#o0">o0</a>(&nbsp;)</b> - <b>o7(&nbsp;)</b>.
<p>
The stack pointer is accessed via o6.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register o0 (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: Debugging</i>

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

</blockquote><h1>l0(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>l0(&nbsp;)</strong> - return the contents of register l0 (also l1-l7) (SimSolaris)</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 l0 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 (l0 - l7):
<b><a href="./dbgArchLib.html#l0">l0</a>(&nbsp;)</b> - <b>l7(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register l0 (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: Debugging</i>

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

</blockquote><h1>i0(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>i0(&nbsp;)</strong> - return the contents of register i0 (also i1-i7) (SimSolaris)</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 i0 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 (i0 - i7):
<b><a href="./dbgArchLib.html#i0">i0</a>(&nbsp;)</b> - <b>i7(&nbsp;)</b>.
<p>
The frame pointer is accessed via i6.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register i0 (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: Debugging</i>

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

</blockquote><h1>npc(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>npc(&nbsp;)</strong> - return the contents of the next program counter (SimSolaris)</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><a href="./usrLib.html#ti">ti</a>(&nbsp;)</b>

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

</blockquote><h1>psr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>psr(&nbsp;)</strong> - return the contents of the processor status register (SimSolaris)</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>, <i>VxWorks Programmer's Guide: Debugging</i>

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

</blockquote><h1>wim(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wim(&nbsp;)</strong> - return the contents of the window invalid mask register (SimSolaris)</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: Debugging</i>

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

</blockquote><h1>y(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>y(&nbsp;)</strong> - return the contents of the y register (SimSolaris)</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 y 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: Debugging</i>

<hr>
<a name="edi_1"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>edi(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>edi(&nbsp;)</strong> - return the contents of register <b>edi</b> (also <b>esi</b> - <b>eax</b>) (x86/SimNT)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command extracts the contents of register <b>edi</b> from the TCB of a
specified task.  If <i>taskId</i> is omitted or zero, the last task
referenced is assumed.
<p>
Similar routines are provided for all address registers (<b>edi</b> - <b>eax</b>):
<b><a href="./dbgArchLib.html#edi">edi</a>(&nbsp;)</b> - <b>eax(&nbsp;)</b>.
<p>
The stack pointer is accessed via <b>eax(&nbsp;)</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The contents of register <b>edi</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: Debugging</i>

<hr>
<a name="eflags_1"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>eflags(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>eflags(&nbsp;)</strong> - return the contents of the status register (x86/SimNT)</p>

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

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

</body>
</html>