📄 dbgarchlib.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/dbgArchLib.html - generated by refgen from dbgArchLib.c --> <title> dbgArchLib </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.htm"><i>VxWorks API Reference : OS Libraries</i></a></p></blockquote><h1>dbgArchLib</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dbgArchLib</strong> - architecture-dependent debugger library </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><a href="./dbgArchLib.html#a0">a0</a>( )</b> - return the contents of register <b>a0</b> (also <b>a1</b> - <b>a7</b>) (MC680x0)<br><b><a href="./dbgArchLib.html#d0">d0</a>( )</b> - return the contents of register <b>d0</b> (also <b>d1</b> - <b>d7</b>) (MC680x0)<br><b><a href="./dbgArchLib.html#sr">sr</a>( )</b> - return the contents of the status register (MC680x0, SH)<br><b><a href="./dbgArchLib.html#dbgBpTypeBind">dbgBpTypeBind</a>( )</b> - bind a breakpoint handler to a breakpoint type (MIPS R3000, R4000, R4650)<br><b><a href="./dbgArchLib.html#edi">edi</a>( )</b> - return the contents of register <b>edi</b> (also <b>esi</b> - <b>eax</b>) (x86)<br><b><a href="./dbgArchLib.html#eflags">eflags</a>( )</b> - return the contents of the status register (x86)<br><b><a href="./dbgArchLib.html#r0">r0</a>( )</b> - return the contents of register <b>r0</b> (also <b>r1</b> - <b>r14</b>) (ARM)<br><b><a href="./dbgArchLib.html#cpsr">cpsr</a>( )</b> - return the contents of the current processor status register (ARM)<br><b><a href="./dbgArchLib.html#psrShow">psrShow</a>( )</b> - display the meaning of a specified PSR value, symbolically (ARM)<br><b><a href="./dbgArchLib.html#r0_1">r0</a>( )</b> - return the contents of general register <b>r0</b> (also <b>r1</b>-<b>r15</b>) (SH)<br><b><a href="./dbgArchLib.html#sr_1">sr</a>( )</b> - return the contents of control register <b>sr</b> (also <b>gbr</b>, <b>vbr</b>) (SH)<br><b><a href="./dbgArchLib.html#mach">mach</a>( )</b> - return the contents of system register <b>mach</b> (also <b>macl</b>, <b>pr</b>) (SH)<br><b><a href="./dbgArchLib.html#o0">o0</a>( )</b> - return the contents of register o0 (also o1-o7) (SimSolaris)<br><b><a href="./dbgArchLib.html#l0">l0</a>( )</b> - return the contents of register l0 (also l1-l7) (SimSolaris)<br><b><a href="./dbgArchLib.html#i0">i0</a>( )</b> - return the contents of register i0 (also i1-i7) (SimSolaris)<br><b><a href="./dbgArchLib.html#npc">npc</a>( )</b> - return the contents of the next program counter (SimSolaris)<br><b><a href="./dbgArchLib.html#psr">psr</a>( )</b> - return the contents of the processor status register (SimSolaris)<br><b><a href="./dbgArchLib.html#wim">wim</a>( )</b> - return the contents of the window invalid mask register (SimSolaris)<br><b><a href="./dbgArchLib.html#y">y</a>( )</b> - return the contents of the y register (SimSolaris)<br><b><a href="./dbgArchLib.html#edi_1">edi</a>( )</b> - return the contents of register <b>edi</b> (also <b>esi</b> - <b>eax</b>) (x86/SimNT)<br><b><a href="./dbgArchLib.html#eflags_1">eflags</a>( )</b> - return the contents of the status register (x86/SimNT)<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This module provides architecture-specific support functions for <b><a href="./dbgLib.html#top">dbgLib</a></b>.It also includes user-callable functions for accessing the contents ofregisters in a task's TCB (task control block). These routines include:<p><table><tr valign=top><td align=left><b>MC680x0</b>:</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#a0">a0</a>( )</b> - <b>a7( )</b> </td><td align=left> - address registers (<b>a0</b> - <b>a7</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#d0">d0</a>( )</b> - <b>d7( )</b> </td><td align=left> - data registers (<b>d0</b> - <b>d7</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#sr">sr</a>( )</b> </td><td align=left> - status register (<b>sr</b>)</tr><tr valign=top><td align=left></tr><tr valign=top><td align=left><b>MIPS</b>:</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#dbgBpTypeBind">dbgBpTypeBind</a>( )</b> </td><td align=left> - bind a breakpoint handler to a breakpoint type</tr><tr valign=top><td align=left></tr><tr valign=top><td align=left><b>x86/SimNT</b>:</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#edi">edi</a>( )</b> - <b>eax( )</b> </td><td align=left> - named register values</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#eflags">eflags</a>( )</b> </td><td align=left> - status register value</tr><tr valign=top><td align=left></tr><tr valign=top><td align=left><b>SH</b>: </tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#r0">r0</a>( )</b> - <b>r15( )</b> </td><td align=left> - general registers (<b>r0</b> - <b>r15</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#sr">sr</a>( )</b> </td><td align=left> - status register (<b>sr</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b>gbr( )</b> </td><td align=left> - global base register (<b>gbr</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b>vbr( )</b> </td><td align=left> - vector base register (<b>vbr</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#mach">mach</a>( )</b> </td><td align=left> - multiply and accumulate register high (<b>mach</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b>macl( )</b> </td><td align=left> - multiply and accumulate register low (<b>macl</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b>pr( )</b> </td><td align=left> - procedure register (<b>pr</b>)</tr><tr valign=top><td align=left></tr><tr valign=top><td align=left><b>ARM</b>:</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#r0">r0</a>( )</b> - <b>r14( )</b> </td><td align=left> - general-purpose registers (<b>r0</b> - <b>r14</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#cpsr">cpsr</a>( )</b> </td><td align=left> - current processor status reg (<b>cpsr</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#psrShow">psrShow</a>( )</b> </td><td align=left> - <b>psr</b> value, symbolically</tr><tr valign=top><td align=left></tr><tr valign=top><td align=left><b>SimSolaris</b>:</tr><tr valign=top><td align=left> </td><td align=left> <b>g0( )</b> - <b>g7( )</b> </td><td align=left> - global registers (<b>g0</b> - <b>g7</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#o0">o0</a>( )</b> - <b>o7( )</b> </td><td align=left> - out registers (<b>o0</b> - <b>o7</b>, note lower-case "o")</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#l0">l0</a>( )</b> - <b>l7( )</b> </td><td align=left> - local registers (<b>l0</b> - <b>l7</b>, note lower-case "l")</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#i0">i0</a>( )</b> - <b>i7( )</b> </td><td align=left> - in registers (<b>i0</b> - <b>i7</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#npc">npc</a>( )</b> </td><td align=left> - next program counter (<b>npc</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#psr">psr</a>( )</b> </td><td align=left> - processor status register (<b>psr</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#wim">wim</a>( )</b> </td><td align=left> - window invalid mask (<b>wim</b>)</tr><tr valign=top><td align=left> </td><td align=left> <b><a href="./dbgArchLib.html#y">y</a>( )</b> </td><td align=left> - <b>y</b> register </tr><tr valign=top><td align=left></tr></tr></table></blockquote><h4>NOTE</h4><blockquote><p>The routine <b><a href="./usrLib.html#pc">pc</a>( )</b>, for accessing the program counter, is foundin <b><a href="./usrLib.html#top">usrLib</a></b>.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./dbgLib.html#top">dbgLib</a></b>,<i>VxWorks Programmer's Guide: Target Shell </i><p><hr><a name="a0"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>a0( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>a0( )</strong> - return the contents of register <b>a0</b> (also <b>a1</b> - <b>a7</b>) (MC680x0)</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int a0 ( int taskId /* task ID, 0 means default task */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This command extracts the contents of register <b>a0</b> from the TCB of a specifiedtask. If <i>taskId</i> is omitted or zero, the last task referenced is assumed.<p>Similar routines are provided for all address registers (<b>a0</b> - <b>a7</b>):<b><a href="./dbgArchLib.html#a0">a0</a>( )</b> - <b>a7( )</b>.<p>The stack pointer is accessed via <b>a7( )</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p>The contents of register <b>a0</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="d0"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>d0( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>d0( )</strong> - return the contents of register <b>d0</b> (also <b>d1</b> - <b>d7</b>) (MC680x0)</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int d0 ( int taskId /* task ID, 0 means default task */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This command extracts the contents of register <b>d0</b> from the TCB of a specifiedtask. If <i>taskId</i> is omitted or zero, the last task referenced is assumed.<p>Similar routines are provided for all data registers (<b>d0</b> - <b>d7</b>):<b><a href="./dbgArchLib.html#d0">d0</a>( )</b> - <b>d7( )</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p>The contents of register <b>d0</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="sr"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>sr( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>sr( )</strong> - return the contents of the status register (MC680x0, 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 the status register from the TCB of aspecified task. If <i>taskId</i> is omitted or zero, the last task referenced isassumed.<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: Target Shell</i><hr><a name="dbgBpTypeBind"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>dbgBpTypeBind( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>dbgBpTypeBind( )</strong> - bind a breakpoint handler to a breakpoint type (MIPS R3000, R4000, R4650)</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS dbgBpTypeBind ( int bpType, /* breakpoint type */ FUNCPTR routine /* function to bind */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>Dynamically bind a breakpoint handler to breakpoints of type 0 - 7.By default only breakpoints of type zero are handled with thevxWorks breakpoint handler (see <b><a href="./dbgLib.html#top">dbgLib</a></b>). Other types may be used forAda stack overflow or other such functions. The installed handlermust take the same parameters as <b>excExcHandle( )</b> (see <b><a href="./excLib.html#top">excLib</a></b>).<p></blockquote><h4>RETURNS</h4><blockquote><p><p>OK, orERROR if <i>bpType</i> is out of bounds.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./dbgArchLib.html#top">dbgArchLib</a></b>, <b><a href="./dbgLib.html#top">dbgLib</a></b>, <b><a href="./excLib.html#top">excLib</a></b><hr><a name="edi"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>edi( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>edi( )</strong> - return the contents of register <b>edi</b> (also <b>esi</b> - <b>eax</b>) (x86)</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 aspecified task. If <i>taskId</i> is omitted or zero, the last taskreferenced is assumed.<p>Similar routines are provided for all general registers (<b>edi</b> - <b>eax</b>):<b><a href="./dbgArchLib.html#edi">edi</a>( )</b> - <b>eax( )</b>.<p>The stack pointer is accessed via <b>eax( )</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"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>eflags( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>eflags( )</strong> - return the contents of the status register (x86)</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 aspecified task. If <i>taskId</i> is omitted or zero, the last task referenced isassumed.<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><hr><a name="r0"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>r0( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>r0( )</strong> - return the contents of register <b>r0</b> (also <b>r1</b> - <b>r14</b>) (ARM)</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 aspecified task. If <i>taskId</i> is omitted or zero, the last task referenced isassumed.<p>Similar routines are provided for registers (<b>r1</b> - <b>r14</b>):<b>r1( )</b> - <b>r14( )</b>.<p></blockquote><h4>RETURNS</h4><blockquote><p>The contents of register <b>r0</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="cpsr"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>cpsr( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>cpsr( )</strong> - return the contents of the current processor status register (ARM)</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int cpsr ( 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 aspecified task. If <i>taskId</i> is omitted or zero, the last task referenced isassumed.<p></blockquote><h4>RETURNS</h4><blockquote><p>The contents of the current 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="psrShow"></a><p align=right><a href="rtnIndex.htm"><i>OS Libraries : Routines</i></a></p></blockquote><h1>psrShow( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>psrShow( )</strong> - display the meaning of a specified PSR value, symbolically (ARM)</p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -