📄 wtdoc.html
字号:
<html><head><!-- /vobs/wpwr/docs/tornado-api/wtxtcl/wtdoc.html - generated by refgen from wtdoc.c --> <title> wtxtcl Library Part I [Tcl] </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>Tornado API Reference : WTX Tcl Library</i></a></p></blockquote><h1>wtxtcl Library Part I [Tcl]</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxtcl Library Part I [Tcl]</strong> - wtxtcl Library part I</p></blockquote><h4>TCL PROCEDURES</h4><blockquote><p><p><b><a href="./wtdoc.html#wtxContextCreate">wtxContextCreate</a></b> - create a new context on the target<br><b><a href="./wtdoc.html#wtxContextKill">wtxContextKill</a></b> - kill a context<br><b><a href="./wtdoc.html#wtxContextSuspend">wtxContextSuspend</a></b> - suspend a context<br><b><a href="./wtdoc.html#wtxContextStatusGet">wtxContextStatusGet</a></b> - get the status of a context <br><b><a href="./wtdoc.html#wtxContextCont">wtxContextCont</a></b> - continue a context stopped at a breakpoint<br><b><a href="./wtdoc.html#wtxContextResume">wtxContextResume</a></b> - resume a suspended context<br><b><a href="./wtdoc.html#wtxContextStep">wtxContextStep</a></b> - single step a context by machine instruction<br><b><a href="./wtdoc.html#wtxSymFind">wtxSymFind</a></b> - locate a symbol in the symbol table<br><b><a href="./wtdoc.html#wtxSymAdd">wtxSymAdd</a></b> - add a new symbol to the symbol table<br><b><a href="./wtdoc.html#wtxSymRemove">wtxSymRemove</a></b> - remove a symbol from the symbol table<br><b><a href="./wtdoc.html#wtxSymTblInfoGet">wtxSymTblInfoGet</a></b> - return information about the target server symbol table<br><b><a href="./wtdoc.html#wtxObjModuleList">wtxObjModuleList</a></b> - fetch a list of IDs of object modules loaded on the target<br><b><a href="./wtdoc.html#wtxObjModuleInfoGet">wtxObjModuleInfoGet</a></b> - return information about an object module<br><b><a href="./wtdoc.html#wtxObjModuleInfoAndPathGet">wtxObjModuleInfoAndPathGet</a></b> - return information about an object module<br><b><a href="./wtdoc.html#wtxObjModuleFind">wtxObjModuleFind</a></b> - find an object module given a name or an ID<br><b><a href="./wtdoc.html#wtxObjModuleUnload">wtxObjModuleUnload</a></b> - unload an object module<br><b><a href="./wtdoc.html#wtxMemChecksum">wtxMemChecksum</a></b> - compute the checksum on target memory<br><b><a href="./wtdoc.html#wtxMemScan">wtxMemScan</a></b> - scan target memory for the presence or absence of a pattern<br><b><a href="./wtdoc.html#wtxMemSet">wtxMemSet</a></b> - set a block of memory to a specified value<br><b><a href="./wtdoc.html#wtxMemAlloc">wtxMemAlloc</a></b> - allocate memory from the agent pool<br><b><a href="./wtdoc.html#wtxMemRealloc">wtxMemRealloc</a></b> - reallocate a block of agent pool memory<br><b><a href="./wtdoc.html#wtxMemAlign">wtxMemAlign</a></b> - allocate a block of aligned memory from the agent pool<br><b><a href="./wtdoc.html#wtxMemAddToPool">wtxMemAddToPool</a></b> - add memory to the agent pool<br><b><a href="./wtdoc.html#wtxMemFree">wtxMemFree</a></b> - free a block of agent pool memory<br><b><a href="./wtdoc.html#wtxMemWrite">wtxMemWrite</a></b> - write a memory block to the target<br><b><a href="./wtdoc.html#wtxMemWidthWrite">wtxMemWidthWrite</a></b> - write a memory block to the target<br><b><a href="./wtdoc.html#wtxMemRead">wtxMemRead</a></b> - read target memory into a memory block<br><b><a href="./wtdoc.html#wtxMemWidthRead">wtxMemWidthRead</a></b> - read memory from the target<br><b><a href="./wtdoc.html#wtxMemMove">wtxMemMove</a></b> - move a block of memory on the target<br><b><a href="./wtdoc.html#wtxRegsGet">wtxRegsGet</a></b> - read a block of register data from the target<br><b><a href="./wtdoc.html#wtxRegsSet">wtxRegsSet</a></b> - write a block of register data to the target<br><b><a href="./wtdoc.html#wtxEventpointAdd">wtxEventpointAdd</a></b> - add an agent eventpoint<br><b><a href="./wtdoc.html#wtxEventpointList">wtxEventpointList</a></b> - list the eventpoints known to the agent<br><b><a href="./wtdoc.html#wtxEventpointListGet">wtxEventpointListGet</a></b> - list the eventpoints known to the agent<br><b><a href="./wtdoc.html#wtxEventpointDelete">wtxEventpointDelete</a></b> - delete an eventpoint<br><b><a href="./wtdoc.html#wtxOpen">wtxOpen</a></b> - open a file for use with virtual I/O<br><b><a href="./wtdoc.html#wtxClose">wtxClose</a></b> - close a target server file<br><b><a href="./wtdoc.html#wtxVioCtl">wtxVioCtl</a></b> - change the characteristics of a virtual I/O channel<br><b><a href="./wtdoc.html#wtxVioWrite">wtxVioWrite</a></b> - virtual I/O write<br><b><a href="./wtdoc.html#wtxVioFileList">wtxVioFileList</a></b> - list the files managed by the target server<br><b><a href="./wtdoc.html#wtxConsoleCreate">wtxConsoleCreate</a></b> - create a target server console window (UNIX only)<br><b><a href="./wtdoc.html#wtxConsoleKill">wtxConsoleKill</a></b> - kill a target server virtual I/O console (UNIX only)<br><b><a href="./wtdoc.html#wtxTsInfoGet">wtxTsInfoGet</a></b> - get information about the target server<br><b><a href="./wtdoc.html#wtxTsVersionGet">wtxTsVersionGet</a></b> - return Tornado version<br><b><a href="./wtdoc.html#wtxTsLock">wtxTsLock</a></b> - lock the target server<br><b><a href="./wtdoc.html#wtxTsUnlock">wtxTsUnlock</a></b> - unlock target server<br><b><a href="./wtdoc.html#wtxMemInfoGet">wtxMemInfoGet</a></b> - return information about the agent pool<br><b><a href="./wtdoc.html#wtxTargetAttach">wtxTargetAttach</a></b> - attempt to reattach to the target<br><b><a href="./wtdoc.html#wtxTargetReset">wtxTargetReset</a></b> - reset the target<br><b><a href="./wtdoc.html#wtxAgentModeGet">wtxAgentModeGet</a></b> - get the WDB agent mode<br><b><a href="./wtdoc.html#wtxDirectCall">wtxDirectCall</a></b> - make a function call in the agent's context<br><b><a href="./wtdoc.html#wtxAgentModeSet">wtxAgentModeSet</a></b> - set the WDB agent mode<br><b><a href="./wtdoc.html#wtxFuncCall">wtxFuncCall</a></b> - call a function on the target<br><b><a href="./wtdoc.html#wtxEventGet">wtxEventGet</a></b> - receive an event if any are waiting<br><b><a href="./wtdoc.html#wtxEventAdd">wtxEventAdd</a></b> - send an event to all other tools attached to the target server<br><b><a href="./wtdoc.html#wtxRegisterForEvent">wtxRegisterForEvent</a></b> - provide a regular expression to mask event delivery<br><b><a href="./wtdoc.html#wtxGopherEval">wtxGopherEval</a></b> - request the evaluation of a Gopher script by the agent<br><b><a href="./wtdoc.html#wtxTsKill">wtxTsKill</a></b> - kill the target server<br><b><a href="./wtdoc.html#wtxVioChanGet">wtxVioChanGet</a></b> - claim a VIO channel<br><b><a href="./wtdoc.html#wtxVioChanRelease">wtxVioChanRelease</a></b> - release a VIO channel<br><b><a href="./wtxtclUtil.html#wtxToolIdGet">wtxToolIdGet</a></b> - return the tool identifier of the current tool<br><b><a href="./wtdoc.html#wtxCacheTextUpdate">wtxCacheTextUpdate</a></b> - synchronize the instruction and data caches.<br><b><a href="./wtdoc.html#wtxEventListGet">wtxEventListGet</a></b> - get all the events in one call.<br><b><a href="./wtdoc.html#wtxObjModuleChecksum">wtxObjModuleChecksum</a></b> - checks validity of target memory.<br><b><a href="./wtdoc.html#wtxUnregisterForEvent">wtxUnregisterForEvent</a></b> - ask the target server to not send events matching<br><b><a href="./wtextra.html#wtxExecutableFind">wtxExecutableFind</a></b> - WDB / WTX requests executable path via document name<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>wtxtcl APIs libary (part I)<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b><hr><a name="wtxContextCreate"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextCreate</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextCreate</strong> - create a new context on the target</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextCreate <i>CONTEXT_TYPE</i> <i>name</i> <i>priority</i> <i>options</i> <i>stackBase</i> <i>stackSize</i> <i>entry</i> <i>redirIn</i> <i>redirOut</i> <a0...a9></pre></blockquote><h4>DESCRIPTION </h4><blockquote><p>This command creates a new task context on the target.The <i>CONTEXT_TYPE</i> argument typically has the value<b>CONTEXT_TASK</b>. The newly created context has the given <i>name</i>,<i>priority</i>, and <i>options</i>, where <i>name</i> is a string, and <i>priority</i>and <i>options</i> are numbers interpreted by the agent. The parameter<i>stackBase</i> is ignored; the agent allocates a stackfor the task. The allocated stack contains <i>stackSize</i>bytes. The new task context begins execution at the address<i>entry</i> and may have up to 10 integer arguments specified,<i>a0</i>...<i>a9</i>.<p></blockquote><h4>RETURNS</h4><blockquote><p>The context ID of the newly created context.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_CREATE" >WTX_CONTEXT_CREATE</a></b>, wtxtcl, wtxContextResume, wtxContextKill<hr><a name="wtxContextKill"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextKill</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextKill</strong> - kill a context</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextKill [<i>CONTEXT_TYPE</i>] <i>contextId</i></pre></blockquote><h4>DESCRIPTION </h4><blockquote><p>This function kills the specified context. <i>CONTEXT_TYPE</i> is one ofthe names of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, whichmay be specified numerically or in string form; <b>CONTEXT_TASK</b> is thedefault. <i>ContextId</i> is a context ID, perhaps one returned bywtxContextCreate.<p></blockquote><h4>RETURNS</h4><blockquote><p>WTX Status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_KILL" >WTX_CONTEXT_KILL</a></b>, wtxtcl, wtxContextCreate<hr><a name="wtxContextSuspend"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextSuspend</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextSuspend</strong> - suspend a context</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextSuspend [<i>CONTEXT_TYPE</i>] <i>contextId</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p><p>This command suspends the specified context. <i>CONTEXT_TYPE</i> is one of thenames of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, which may bespecified numerically or in string form; if absent, <b>CONTEXT_TASK</b> isassumed. <i>ContextId</i> is a context ID, perhaps one returned bywtxContextCreate.<p></blockquote><h4>RETURNS</h4><blockquote><p>WTX Status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_SUSPEND" >WTX_CONTEXT_SUSPEND</a></b>, wtxtcl, wtxContextCreate, wtxContextResume<hr><a name="wtxContextStatusGet"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextStatusGet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextStatusGet</strong> - get the status of a context </p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextStatusGet [<i>CONTEXT_TYPE</i>] <i>contextId</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p><p>This command returns the status of the specified context as a string. <i>CONTEXT_TYPE</i> is one of the names of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, which may be specified numerically or in string form;if it is omitted, <b>CONTEXT_TASK</b> is assumed. <i>ContextId</i> is a context ID,perhaps one returned by wtxContextCreate. You can use wtxEnumInfo withan argument of <b>CONTEXT_STATUS</b> to see the list of possible context status.<p></blockquote><h4>EXAMPLE</h4><blockquote><p><pre>tcl> wtxContextStatusGet CONTEXT_SYSTEM 0 CONTEXT_RUNNINGtcl> wtxEnumInfo CONTEXT_STATUS CONTEXT_RUNNING 0x0 CONTEXT_SUSPENDED 0x1</pre></blockquote><h4>NOTE</h4><blockquote><p><p>This request is implemented only for system mode context.<p></blockquote><h4>RETURNS</h4><blockquote><p>The context status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_STATUS_GET" >WTX_CONTEXT_STATUS_GET</a></b>, wtxtcl, wtxContextCreate, wtxContextResume, wtxContextSuspend<hr><a name="wtxContextCont"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextCont</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextCont</strong> - continue a context stopped at a breakpoint</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextCont [<i>CONTEXT_TYPE</i>] <i>contextId</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This function continues the specified context. <i>CONTEXT_TYPE</i> is one ofthe names of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, which maybe specified numerically or in string form; if it is omitted, <b>CONTEXT_TASK</b>is assumed. <i>ContextId</i> is a context ID, perhaps one returned bywtxContextCreate.<p></blockquote><h4>RETURNS</h4><blockquote><p>WTX Status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_CONT" >WTX_CONTEXT_CONT</a></b>, wtxtcl, wtxEventpointAdd, wtxContextCreate, wtxContextStep<hr><a name="wtxContextResume"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextResume</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextResume</strong> - resume a suspended context</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextResume [<i>CONTEXT_TYPE</i>] <i>contextId</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This command resumes the specified context. It restarts a task that has been suspended (perhaps by wtxContextSuspend). Do not usewtxContextResume to continue a task stopped at a breakpoint; the tasksimply hits the breakpoint again. Use wtxContextCont.<p><i>CONTEXT_TYPE</i> is one of the names of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, which may be specified numerically or in string form; if itis omitted, <b>CONTEXT_TASK</b> is assumed. <i>ContextId</i> is a context ID, perhapsone returned by wtxContextCreate.<p></blockquote><h4>RETURNS</h4><blockquote><p>WTX Status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_RESUME" >WTX_CONTEXT_RESUME</a></b>, wtxtcl, wtxContextSuspend, wtxContextCreate<hr><a name="wtxContextStep"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxContextStep</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxContextStep</strong> - single step a context by machine instruction</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxContextStep [<i>CONTEXT_TYPE</i>] <i>contextId</i> [<i>startAddr</i> <i>endAddr</i>]</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This function runs the specified context in instruction-trace mode. If <i>startAddr</i> and <i>endAddr</i> are given, the context continues to single step instruction by instruction until the step range is exited (either by executing the last instruction in the range or by jumping out the rangevia a branch or call instruction). <i>CONTEXT_TYPE</i> is one of the names of the <b>CONTEXT_TYPE</b> enumeration in the WTX protocol, which may be specified numerically or in string form; if it is omitted, <b>CONTEXT_TASK</b> is assumed.<i>ContextId</i> is a context ID, perhapsone returned by wtxContextCreate.<p></blockquote><h4>RETURNS</h4><blockquote><p>WTX Status.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtdoc.html#top">wtxtcl Library Part I</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_CONTEXT_STEP" >WTX_CONTEXT_STEP</a></b>, wtxtcl, wtxEventpointAdd, wtxContextCont, wtxContextCreate⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -