📄 wtextra.html
字号:
<html><head><!-- /vobs/wpwr/docs/tornado-api/wtxtcl/wtextra.html - generated by refgen from wtextra.c --> <title> wtxtcl Library Part II [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 II [Tcl]</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxtcl Library Part II [Tcl]</strong> - wtxtcl Library part II</p></blockquote><h4>TCL PROCEDURES</h4><blockquote><p><p><b><a href="./wtextra.html#wtxSymListGet">wtxSymListGet</a></b> - query the target server symbol table<br><b><a href="./wtextra.html#wtxMemDisassemble">wtxMemDisassemble</a></b> - query the target server disassembled instructions<br><b><a href="./wtextra.html#wtxLogging">wtxLogging</a></b> - WDB / WTX requests logging controls<br><b><a href="./wtextra.html#wtxObjModuleLoad">wtxObjModuleLoad</a></b> - Load a multiple section object file<br><b><a href="./wtextra.html#wtxObjModuleLoadStart">wtxObjModuleLoadStart</a></b> - Load a multiple section object file asynchronously<br><b><a href="./wtextra.html#wtxObjModuleLoadProgressReport">wtxObjModuleLoadProgressReport</a></b> - get the asynchronous load status<br><b><a href="./wtextra.html#wtxObjModuleLoadCancel">wtxObjModuleLoadCancel</a></b> - Stop an asynchronous load request<br><b><a href="./wtextra.html#wtxAsyncNotifyEnable">wtxAsyncNotifyEnable</a></b> - Start the asynchronous event notification<br><b><a href="./wtextra.html#wtxAsyncNotifyDisable">wtxAsyncNotifyDisable</a></b> - Stop the asynchronous event notification<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 II)<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b><hr><a name="wtxSymListGet"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxSymListGet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxSymListGet</strong> - query the target server symbol table</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxSymListGet [{-module <i>nameOrId</i> | -moduleId <i>modId</i> | \ -moduleName <i>modName</i>} [-unknown]] \ {-name <i>name</i> | -value <i>value</i>}</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This function returns a list of symbols. If <b>-name</b> is specified, then <i>name</i> is interpreted as a regular expression; all symbols whose names match are returned. If <b>-value</b> is specified, then a set 12 symbols is returned, the first of whose address is not greater than the specified one. <b>-module</b> constrains the search to a particular module; <b>-unknown</b> returns only unresolved symbols for the module.<p></blockquote><h4>NOTE</h4><blockquote><p><b>-module</b> will be obsoleted in the next release.<p></blockquote><h4>RETURNS</h4><blockquote><p>A list of values, each of which is a symbol similar to those returned by wtxSymFind. It is not considered an error to submit a query that matchesno symbols; an empty list is returned in that event.<p></blockquote><h4>EXAMPLE</h4><blockquote><p><pre>tcl> wtxSymListGet -name "_sem.*Take$"{_semTake 0xce72 0x5 0 0 vxWorks}{_semBTake 0xce84 0x5 0 0 vxWorks}{_semOTake 0xcf4e 0x5 0 0 vxWorks}{_semCTake 0x4190e 0x5 0 0 vxWorks}{_semMTake 0x419d6 0x5 0 0 vxWorks}</pre></blockquote><h4>ERRORS</h4><blockquote><p><dl><dt>missing module name or ID<dd>The request cannot be satisfied without the object module name or ID.<p><dt>name and value options cannot be used together<dd>Use either name or value, not both.<p><dt>module and value options cannot be used together<dd>Use either module or value, not both.<p><dt><b>-unknown</b> option cannot be used with name or value<dd> Don't use the <b>-unknown</b> option with name or value.<p></dl></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, * <b><a href="../wtxpcl/wtx.html#WTX_SYM_LIST_GET" >WTX_SYM_LIST_GET</a></b>, wtxtcl, wtxSymFind, wtxSymAdd, wtxSymRemove, wtxSymTblInfoGet<hr><a name="wtxMemDisassemble"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxMemDisassemble</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxMemDisassemble</strong> - query the target server disassembled instructions</p><p></blockquote><h4>LOCALE</h4><blockquote><p>WTX Tcl<p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxMemDisassemble [-address] [-opcodes] [-hex] <i>startAddr</i> \ [<i>nInst</i> [<i>endAddr</i>]]</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This function returns a list of disassembled instructions starting from<b>startAddr</b>.A disassembled instruction has the following shape :<p><pre> {<symbolName>} <instructionSize> {<instructionAddress>} {<instructionOpcodes>} {<disassembledInstruction>}</pre>If an instruction is disassembled at the adress of an existing symbol, thenthe demangled <i>symbolName</i> take the name of the demangled symbol name.<p>The <i>instructionSize</i> field indicaes the instruction size in bytes to makeit easy to retrieve following instruction's address.<p>The <i>instructionAddress</i> is the instruction memory address, or empty Tcl listelement ({}) if the <b>-address</b> option is not set.<p>The <i>instructionOpcodes</i> value is set to the instruction's opcode vlue if the<b>-opcodes</b> option is set, else it is a Tcl empty list element.<p>The <i>disassembleInstruction</i> is the disassembled instruction properly, itslayout depends on the board's architecture.<p>The <b>-hex</b> option allows to get disassembled instructions without the<b>symbolic + opcodes</b> sybol representation. Each address in the disassembledinstruction field is represented by its real hexadecimal address<p></blockquote><h4>RETURNS</h4><blockquote><p>A list of disassembled instructions as described above.<p></blockquote><h4>EXAMPLE</h4><blockquote><p><pre> wtxtcl> wtxMemDisassemble -address -opcodes 0x10d298 {_vxSemGive} 1 {0010d298} {55} {PUSH EBP} {} 2 {0010d299} {89 e5} {MOV EBP, ESP} {} 3 {0010d29b} {8b 45 08} {MOV EAX, [EBP+8] {} 1 {0010d29e} {50} {PUSH EAX} {} 5 {0010d29f} {e8 84 16 00 00} {CALL _semGive} {} 2 {0010d2a4} {89 ec} {MOV ESP, EBP} {} 1 {0010d2a6} {5d} {POP EBP} {} 1 {0010d2a7} {c3} {RET } {_vxSemTake} 1 {0010d2a8} {55} {PUSH EBP} {} 2 {0010d2a9} {89 e5} {MOV EBP, ESP} wtxtcl> wtxMemDisassemble -address -opcodes -hex 0x10d298 {_vxSemGive} 1 {0010d298} {55} {PUSH EBP} {} 2 {0010d299} {89 e5} {MOV EBP, ESP} {} 3 {0010d29b} {8b 45 08} {MOV EAX, [EBP+8]} {} 1 {0010d29e} {50} {PUSH EAX} {} 5 {0010d29f} {e8 84 16 00 00} {CALL 0x10e928} {} 2 {0010d2a4} {89 ec} {MOV ESP, EBP} {} 1 {0010d2a6} {5d} {POP EBP} {} 1 {0010d2a7} {c3} {RET } {_vxSemTake} 1 {0010d2a8} {55} {PUSH EBP} {} 2 {0010d2a9} {89 e5} {MOV EBP, ESP}</pre></blockquote><h4>ERRORS</h4><blockquote><p>No error messages.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_MEM_DISASSEMBLE" >WTX_MEM_DISASSEMBLE</a></b>, <b><a href="../../tornado/tools/wtxtcl.html#top" >wtxtcl</a></b>, <b><a href="./wtextra.html#wtxSymListGet">wtxSymListGet</a></b><hr><a name="wtxLogging"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxLogging</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxLogging</strong> - WDB / WTX requests logging controls</p><p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxLogging <i>wtx</i> {<i>on</i> [filename] [maxSize] [regExp]| <i>off</i>}wtxLogging <i>wdb</i> {<i>on</i> [filename] [maxSize]| <i>off</i>}wtxLogging <i>all</i> <i>off</i></pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>Options available for the WTX log request are:<dl><dt>ON<dd>Start the logging service<p><dt>OFF<dd>Stop the logging service<p><dt>filename<dd>Name where info will be written<p><dt>maxSize<dd>Maximum size of the log file<p><dt>regExp<dd>Regular expression used to filter events<p>Options available for the WDB log request are:<p><dt>ON<dd>Start the logging service<p><dt>OFF<dd>Stop the logging service<p><dt>filename<dd>Name where info will be written<p><dt>maxSize<dd> Maximum size of the log file<p></dl></blockquote><h4>EXAMPLE</h4><blockquote><p><p><p>Start the WTX logging with a file never bigger than 10000 bytes and containing all WTX requests except "<b><a href="../wtxpcl/wtx.html#WTX_TOOL_ATTACH" >WTX_TOOL_ATTACH</a></b>".<pre>tcl> wtxLogging WTX ON /folk/pascal/wtx.txt 10000 WTX_TOOL_ATTACH</pre>Start the WTX logging without size limit and with a default WTX requests filter.<pre>tcl> wtxLogging WTX ON /folk/pascal/wtx.txt WTX_LOG_NO_LIMIT</pre>Stop the WTX and the WDB logging in one call.<pre>tcl> wtxLogging ALL OFF</pre></blockquote><h4>RETURNS</h4><blockquote><p><b>TCL_OK</b> if success otherwise <b>TCL_ERROR</b><p></blockquote><h4>ERRORS</h4><blockquote><p>No error messages.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtextra.html#top">wtxtcl Library Part II</a></b>, <b><a href="../wtxpcl/wtx.html#WTX_COMMAND_SEND" >WTX_COMMAND_SEND</a></b>, wtxtcl<hr><a name="wtxObjModuleLoad"></a><p align=right><a href="rtnIndex.html"><i>WTX Tcl Library : Tcl Procedures</i></a></p></blockquote><h1>wtxObjModuleLoad</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxObjModuleLoad</strong> - Load a multiple section object file</p><p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxObjModuleLoad [-ts] [flags] [textAddr] [dataAddr] [bssAddr] filename</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine loads a module onto the target and into the target server module table. It returns when the module is in the target server memory,ready to be relocated and downloaded by the target server loader.<p>Files loaded on the target by the target server can be opened either bythe target server or by the client. These two behaviors can be controled bythe [-ts] option: if set, then opens the file where the target server is;otherwise the file is open locally where the client is.<p><i>Flags</i> is one or more members of the <b>LOAD_FLAG</b> values; see the entryfor <b><a href="../wtxpcl/wtx.html#WTX_OBJ_MODULE_LOAD" >WTX_OBJ_MODULE_LOAD</a></b> in the .I "API Reference Manual: WTX Protocol".⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -