wtdoc.html

vxworks相关论文

<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_OBJ_MODULE_UNLOAD_2" >WTX_OBJ_MODULE_UNLOAD_2</a></b>, wtxtcl, wtxObjModuleList, wtxObjModuleInfoGet,  
wtxObjModuleLoad, wtxObjModuleFind

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

</blockquote><h1>wtxMemChecksum</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemChecksum</strong> - compute the checksum on target memory</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemChecksum <i>startAddr</i> <i>nBytes</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function computes and returns the checksum of the block of memory
that starts at <i>startAddr</i> and extends <i>nBytes</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The block checksum in hexadecimal.
<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_MEM_CHECKSUM" >WTX_MEM_CHECKSUM</a></b>, wtxtcl, wtxMemWrite, wtxMemRead

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

</blockquote><h1>wtxMemScan</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemScan</strong> - scan target memory for the presence or absence of a pattern</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemScan [-notmatch] <i>startAddr</i> <i>endAddr</i> {-string <i>string</i> | -memblk <i>mblk</i>}
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine scans the target memory from <i>startAddr</i> to <i>endAddr</i>. When
<b>-notmatch</b> is specified, it returns the first address not matching the
pattern. Otherwise it returns the first address matching the pattern. The
pattern can be specified to be either a string or a block of memory.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The first address matching <i>string</i> or <i>mblk</i> unless <b>-notmatch</b> is specified.
When <b>-notmatch</b> is specified, it returns the first address not
matching <i>string</i> or <i>mblk</i>.
<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_MEM_SCAN" >WTX_MEM_SCAN</a></b>, wtxtcl, wtxMemWrite, wtxMemRead, wtxMemChecksum

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

</blockquote><h1>wtxMemSet</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemSet</strong> - set a block of memory to a specified value</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemSet <i>startAddr</i> <i>nBytes</i> <i>value</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function fills a block of memory beginning at <i>startAddr</i> and 
extending <i>nBytes</i> with a 4-byte <i>value</i>.
<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_MEM_SET" >WTX_MEM_SET</a></b>, wtxtcl, wtxMemWrite, wtxMemRead, wtxMemChecksum

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

</blockquote><h1>wtxMemAlloc</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemAlloc</strong> - allocate memory from the agent pool</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemAlloc <i>nBytes</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
A memory block of <i>nBytes</i> is allocated from the target pool.  To allocate
memory from the target run-time, you call its memory manager with 
wtxFuncCall.  Memory obtained from wtxMemAlloc can be freed 
with wtxMemFree.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the newly allocated block.
<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_MEM_ALLOC" >WTX_MEM_ALLOC</a></b>, wtxtcl, wtxMemFree, wtxMemAlign, wtxMemAddToPool

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

</blockquote><h1>wtxMemRealloc</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemRealloc</strong> - reallocate a block of agent pool memory</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemRealloc <i>address</i> <i>size</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command resizes a block of memory obtained from the wtxMemAlloc
service to the new <i>size</i>.  <i>Address</i> is the value returned
by wtxMemAlloc.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the new block of memory, which may have moved.
<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_MEM_REALLOC" >WTX_MEM_REALLOC</a></b>, wtxtcl, wtxMemAlloc, wtxMemFree

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

</blockquote><h1>wtxMemAlign</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemAlign</strong> - allocate a block of aligned memory from the agent pool</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemAlign <i>alignment</i> <i>size</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
A block of memory is obtained which is aligned
on an <i>alignment</i>-byte boundary. This function is similar to wtxMemAlloc 
with the addition of alignment.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The address of the allocated block.
<p>
wtxMemFree, wtxMemAlloc
<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_MEM_ALIGN" >WTX_MEM_ALIGN</a></b>, wtxtcl

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

</blockquote><h1>wtxMemAddToPool</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemAddToPool</strong> - add memory to the agent pool</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemAddToPool <i>address</i> <i>size</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function adds the block of memory starting at <i>address</i> and spanning
<i>size</i> bytes to the agent pool, enlarging it.  It is possible to enlarge
the agent's pool with memory obtained from the run-time memory manager
or with any currently unclaimed memory.
<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_MEM_ADD_TO_POOL" >WTX_MEM_ADD_TO_POOL</a></b>, wtxtcl, wtxMemAlloc, wtxMemFree

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

</blockquote><h1>wtxMemFree</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemFree</strong> - free a block of agent pool memory</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemFree <i>address</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command frees a block of memory obtained by a call to wtxMemAlloc,
wtxMemRealloc or wtxMemAlign, returning it to the agent pool.
<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_MEM_FREE" >WTX_MEM_FREE</a></b>, wtxtcl, wtxMemAlloc, wtxMemAlign

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

</blockquote><h1>wtxMemWrite</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemWrite</strong> - write a memory block to the target</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemWrite <i>blockId</i> <i>address</i> [<i>offset</i>] [<i>nBytes</i>]
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command writes the memory block named by <i>blockId</i> to the target
memory starting at <i>address</i>.  If <i>offset</i> is given, writing starts at
that offset in the memory block.  If <i>nBytes</i> is absent, the entire memory
block (starting at <i>offset</i> if supplied) is written; otherwise <i>nBytes</i> of
data are written to target memory.
<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_MEM_WRITE" >WTX_MEM_WRITE</a></b>, wtxtcl, wtxMemRead, memBlockCreate

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

</blockquote><h1>wtxMemWidthWrite</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemWidthWrite</strong> - write a memory block to the target</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemWidthWrite <i>blockId</i> <i>address</i> [<i>width</i>] [<i>offset</i>] [<i>nBytes</i>]
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command writes the memory block named by <i>blockId</i> to the target
memory starting at <i>address</i>.  If <i>offset</i> is given, writing starts at
that offset in the memory block.  If <i>nBytes</i> is absent, the entire memory
block (starting at <i>offset</i> if supplied) is written; otherwise <i>nBytes</i> of
data are written to target memory. If <i>width</i> is given, it must be set to
1 (byte), 2 (word) or 4 (long word), by default, <i>width</i> is set to 4.
<p>
</blockquote><h4>CAVEAT</h4><blockquote><p>
Because this request is not implemented on WDB side, wtxMemWidthWrite uses
<b><a href="../wdbpcl/wdb.html#WDB_MEM_WRITE" >WDB_MEM_WRITE</a></b> and the <i>width</i> parameter is simply ignored.
<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_MEM_WIDTH_WRITE" >WTX_MEM_WIDTH_WRITE</a></b>, wtxtcl, wtxMemWidthRead, memBlockCreate

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

</blockquote><h1>wtxMemRead</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemRead</strong> - read target memory into a memory block</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>wtxMemRead <i>address</i> <i>nBytes</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
The block of target memory starting at <i>address</i> and spanning <i>nBytes</i> is
read into a memory block.  The handle of the memory block is returned.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A memory block handle.
<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_MEM_READ" >WTX_MEM_READ</a></b>, wtxtcl, wtxMemWrite, memBlockCreate, memBlockGet

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

</blockquote><h1>wtxMemWidthRead</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>wtxMemWidthRead</strong> - read memory from the target</p>