📄 wtxtcl.html
字号:
<html><head><!-- /vobs/wpwr/docs/tornado/tools/wtxtcl.html - generated by refgen from wtxtcl.sh --> <title> wtxtcl </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>Tornado Reference : Tornado Tools</i></a></p></blockquote><h1>wtxtcl</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxtcl</strong> - the Tornado TCL shell</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxtcl [<i>file</i>]</pre><p><p></blockquote><h4>DESCRIPTION</h4><blockquote><p><p>wtxtcl is the Tornado TCL shell. This shell provides all the TCL facilities plus the WTX TCL APIs.<p></blockquote><h4>INTRODUCTION</h4><blockquote><p>The WTX Tcl API provides a binding of the WTX protocol to the Tcl language.This allows Tcl scripts to be written that interact with the WTX environment.Every WTX protocol request is available to the Tcl interface. The names of allWTX Tcl API commands are derived from the protocol request names according tothe conventions discussed in the<i>Tornado API Programmer's Guide: Coding Conventions </i>.In other words, underscores are removed and all words but the first arecapitalized. For example, <b><a href="../../tornado-api/wtxpcl/wtx.html#WTX_MEM_READ" >WTX_MEM_READ</a></b> becomes <b><a href="../../tornado-api/wtxtcl/wtdoc.html#wtxMemRead" >wtxMemRead</a></b>.<p>The Tcl API is accessible directly by means of the wtxtcl tool, from WindSh bytyping <b>?</b>, in CrossWind by using <b>tcl</b>, and in launch and the browser whenthese tools are started with the <b>-T</b> option.<p></blockquote><h4>ERROR MESSAGES</h4><blockquote><p>A wtxtcl command can return one of several types of errors:<p><dl><dt>A WTX error<dd>See the reference for <b><a href="../../tornado-api/wtxpcl/wtx.html#top" >WTX</a></b> in the online<i>Tornado API Reference </i>for a list of WTX errors.<p><dt>A Tcl command parameter parsing error<dd>See <b>host/src/libwpwr/wtxtcl/wtparse.c</b>, which is the file where these errors are generated.<p><dt>A wtxtcl error<dd> See the listings in the ERRORS section of the function documentation forexamples. </dl><p></blockquote><h4>MEMORY BLOCKS</h4><blockquote><p>The <b>memBlockXxx</b> routines implement a memory block data type. The goal is toallow efficient management of blocks of target memory provided by WTX from Tclprograms. In particular, the memory blocks are not converted to string formexcept when a Tcl program requests it.<p>WTX routines that return (or accept) blocks of target memory must supply blockhandles provided by this library.<p>Blocks have both a "logical" size, specified by their creator, and anallocation size. The allocation size is the amount of heap memory allotted for the block data. The routines obtain memory to enlarge blocks in chunks.<p>Blocks are coded for the endianness of the target that supplied them, and the<b><a href="../../tornado-api/wtxtcl/memBlock.html#memBlockSet" >memBlockSet</a></b> and <b><a href="../../tornado-api/wtxtcl/memBlock.html#memBlockGet" >memBlockGet</a></b> routines automatically swap 16- and 32-bitquantities when they are stored to or retrieved from a block.<p></blockquote><h4>USING A SCRIPT FILE</h4><blockquote><p><p>Specifying a <i>file</i> in the wtxtcl command line makes wtxtcl use this file asscript file.<p>wtxtcl then executes all specified procedures from the script file.This does not act like a sourced file in that wtxtcl exits after havingexecuted the script file.<p></blockQuote><h4>Example</h4><blockQuote><p>First write the <b>myWtxTcl.tcl</b> script<p><pre> # myWtxTcl.tcl - user defined WTX / TCL script file # # modification history # -------------------- # 01a,02jun98,fle written #*/ # # DESCRIPTION # This tcl script file contains user-defined WTX-TCL procedures # ########################################################################## # # cpuNumGet - gets the CPU number of the specified <tgtSvr> # # SYNOPSIS # cpuNumGet tgtSvr # # PARAMETERS # tgtSvr : the target server to get CPU number from # # RETURNS: The CPU number or -1 on error # # ERRORS: N/A # proc cpuNumGet { tgtSvr } { set cpuNum -1 if { [catch "wtxToolAttach $tgtSvr" tgtSvrName] } { return $cpuNum } if { [catch "wtxTsInfoGet" tsInfo] } { return $cpuNum } wtxToolDetach set cpuNum [lindex [lindex $tsInfo 2] 0] return $cpuNum } ########################################################################## # # main - command to execute at wtxtcl startup # puts stdout [cpuNumGet $argv]</pre>Then launch wtxtcl with the file name as argument and the target server nameas the argument to <b>myWtxTcl.tcl</b><p><pre> wtxtcl myWtxTcl.tcl -1 wtxtcl myWtxTcl.tcl vxsim0 61</pre><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtxtcl.html#top">wtxtcl</a></b>, <b><a href="../../tornado-api/wtxpcl/wtx.html#top" >WTX</a></b> entry in the online<i>Tornado API Reference </i>, <i>Tornado API Programmer's Guide: The WTX Protocol </i>, <i>Tornado User's Guide </i><p><p></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -