wtdoc.html

vxworks相关论文

<hr>
<a name="wtxSymFind"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxSymFind</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxSymFind</strong> - locate a symbol in the symbol table</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxSymFind [-exact] [-name <i>name</i> | -value <i>value</i>] [-type <i>type</i>]
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function queries the target server symbol table looking for one
symbol that exactly matches the specified <i>name</i> or <i>value</i>.  If <b>-type</b>
is specified, any returned symbol will have the supplied <i>type</i>.  If
<b>-exact</b> is specified, the name must match exactly.  If not,
wtxSymFind will consider a symbol to match if it differs from the
supplied name only by having one leading underscore (that is, "_foo"
could be returned for "foo", if <b>-exact</b> is not set).  If a value is 
specified, the nearest symbol whose value is not greater than the
given value is returned.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
If a symbol matching the search criteria is found, the following structure
is returned:
<pre>name address type {symTblId group module}
</pre>

where <i>name</i> is the name of the found symbol, <i>address</i> its address,
and <i>type</i> one of the VxWorks symbol type codes.  <i>symTblId</i> is currently
for internal use. 
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<b>SYMTBL_SYMBOL_NOT_FOUND</b> if no symbol is found.
<p>
</blockquote><h4>CAVEATS</h4><blockquote><p>
<b>-exact</b> should apply to value searches.  <i>symTblId</i>, <i>group</i>, and
<i>module</i> have NULL values for all searches.
<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_SYM_FIND" >WTX_SYM_FIND</a></b>, wtxtcl, wtxSymAdd, wtxSymRemove, wtxSymListGet, wtxSymTblInfoGet

<hr>
<a name="wtxSymAdd"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxSymAdd</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxSymAdd</strong> - add a new symbol to the symbol table</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxSymAdd <i>name</i> <i>value</i> <i>type</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
<p>
This function adds a new symbol to the target server symbol table, with 
the given <i>name</i>, <i>value</i>, and <i>type</i>.  <i>Name</i> is a string, <i>value</i> is an 
integer, and <i>type</i> is a small integer representing one of the VxWorks 
symbol type codes.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
NONE.
<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_SYM_ADD" >WTX_SYM_ADD</a></b>, wtxtcl, wtxSymFind, wtxSymRemove, wtxSymListGet, wtxSymTblInfoGet

<hr>
<a name="wtxSymRemove"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxSymRemove</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxSymRemove</strong> - remove a symbol from the symbol table</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxSymRemove <i>name</i> <i>type</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command removes the symbol with the given <i>name</i> and <i>type</i> from the 
target server symbol table.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<b>SYMTBL_SYMBOL_NOT_FOUND</b> if the symbol cannot be located.
<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_SYM_REMOVE" >WTX_SYM_REMOVE</a></b>, wtxtcl, wtxSymFind, wtxSymAdd, wtxSymListGet, wtxSymTblInfoGet

<hr>
<a name="wtxSymTblInfoGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxSymTblInfoGet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxSymTblInfoGet</strong> - return information about the target server symbol table</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxSymTblInfoGet
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function returns a list of information about the target server 
symbol table. 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The returned list contains three elements:  the first is the symbol table
ID, the second is the number of symbols contained there, and the third is 
a boolean indicating whether the symbol table permits more than one entry
to have the same name.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>tcl&gt; wtxSymTblInfoGet
0xa3558 2204 1
</pre>

</blockquote><h4>ERRORS</h4><blockquote><p>
None.
<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_SYM_TBL_INFO_GET" >WTX_SYM_TBL_INFO_GET</a></b>, wtxtcl, wtxSymFind, wtxSymAdd, wtxSymRemove,  
wtxSymListGet

<hr>
<a name="wtxObjModuleList"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleList</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleList</strong> - fetch a list of IDs of object modules loaded on the target</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleList
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function fetches the list of IDs of object modules loaded on the target.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A list of object module IDs.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>tcl&gt; wtxObjModuleList
0x98860 0x4a5c48
</pre>

</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_OBJ_MODULE_LIST" >WTX_OBJ_MODULE_LIST</a></b>, wtxtcl, wtxObjModuleInfoGet, wtxObjModuleFind,  
wtxObjModuleLoad, wtxObjModuleUnload

<hr>
<a name="wtxObjModuleInfoGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleInfoGet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleInfoGet</strong> - return information about an object module</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleInfoGet <i>objModuleId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a list of information about the module specified 
by <i>objModuleId</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A list with five initial elements: the ID, name, format code, group, and
load flags of the module. This is followed by a three-element list for
each section in the module: the section flags, the address, and the length
of the section.
<p>
</blockquote><h4>CAVEATS</h4><blockquote><p>
Section entries are unnamed.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
This script prints a table of all loaded object module IDs and their names.
<pre>tcl&gt; foreach mod [wtxObjModuleList] {
tcl&gt;   puts stdout [lrange [wtxObjModuleInfoGet $mod] 0 1]
tcl&gt; }
0x98860 vxWorks
0x4a5c48 tc68k.o
</pre>

</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_OBJ_MODULE_INFO_GET" >WTX_OBJ_MODULE_INFO_GET</a></b>, wtxtcl, wtxObjModuleList, wtxObjModuleFind,  
wtxObjModuleLoad, wtxObjModuleUnload

<hr>
<a name="wtxObjModuleInfoAndPathGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleInfoAndPathGet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleInfoAndPathGet</strong> - return information about an object module</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleInfoAndPathGet <i>objModuleId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a list of information about the module specified 
by <i>objModuleId</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A list with five initial elements: the ID, path and name, format code, 
group, and load flags of the module. This is followed by a three-element 
list for each section in the module: the section flags, the address, and 
the length of the section.
<p>
</blockquote><h4>CAVEATS</h4><blockquote><p>
Section entries are unnamed.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
This script prints a table of all loaded object module IDs and their names.
<pre>tcl&gt; foreach mod [wtxObjModuleList] {
tcl&gt;   puts stdout [lrange [wtxObjModuleInfoAndPathGet $mod] 0 1]
tcl&gt; }
0xcea38 /view/wrs.tor2_0.tempest-a/vobs/wpwr/target/config/mv1604vxWorks
0xe6f20 /view/pas.t2.ref/vobs/wpwr/target/lib/objPPC604gnutest/bcopyTest.o
</pre>

</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_OBJ_MODULE_INFO_GET" >WTX_OBJ_MODULE_INFO_GET</a></b>, wtxtcl, wtxObjModuleInfoGet, wtxObjModuleList,  
wtxObjModuleFind, wtxObjModuleLoad, wtxObjModuleUnload

<hr>
<a name="wtxObjModuleFind"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleFind</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleFind</strong> - find an object module given a name or an ID</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleFind <i>nameOrId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function finds the name or ID of an object module given the other
piece of information.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A list of two elements: the module ID and the module name for the module
matching the <i>nameOrId</i> argument if one is found.  This function is 
useful for converting between module names and IDs.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>tcl&gt; wtxObjModuleFind tc68k.o
0x4a5c48 tc68k.o
</pre>

</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_OBJ_MODULE_FIND" >WTX_OBJ_MODULE_FIND</a></b>, wtxtcl, wtxObjModuleList, wtxObjModuleInfoGet,  
wtxObjModuleLoad, wtxObjModuleUnload

<hr>
<a name="wtxObjModuleUnload"></a>
<p align=right>
<a href="rtnIndex.html"><i>WTX Tcl Library :  Tcl Procedures</i></a></p>

</blockquote><h1>wtxObjModuleUnload</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxObjModuleUnload</strong> - unload an object module</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxObjModuleUnload <i>nameOrId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command removes the given object module from the target, reclaiming 
agent pool memory.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
Unload a module given its ID and another one given its name:
<pre>tcl&gt; wtxObjModuleUnload 0xfb3008
0
tcl&gt; wtxObjModuleUnload big.o
0
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
WTX Status.