memblock.html

vxworks相关论文

</dl>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
* wtxtcl, memBlockSet, memBlockGet

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

</blockquote><h1>memBlockWriteFile</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockWriteFile</strong> - write the memory block contents to a file</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockWriteFile [-append | -seek <i>offset</i>] <i>blockId</i> [|]<i>file</i> [<i>offset</i>] [<i>count</i>]
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command writes a memory block to the named file.  The file name <b>-</b> 
represents stdout.  If the file name starts with
the pipe character (|), a pipe to the named process is used 
instead.  An <i>offset</i> and <i>count</i> (in bytes) may be specified.  No swapping
is done; the block is written in raw binary form.
<p>
If a pipe is not selected, by default the file is opened for writing
and truncated after the block is written.  The <b>-append</b> argument 
causes the block to be written to the end of the file.  The <b>-seek</b> argument
opens the file for update (it must exist) and seek before writing;
the file is not truncated after writing in this case.  Neither <b>-seek</b>
nor <b>-append</b> may be used with pipes. 
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<dl>
<dt>
expecting seek offset
<dd>

The option <b>-seek</b> is missing its offset parameter.
<p>
<dt>
block not found
<dd>

The block ID does not exist.
<p>
<dt>
cannot use -seek or -append with a pipe
<dd>

You must change flags or use a file.
<p>
<dt>
invalid count
<dd>

The count value is negative.
<p>
<dt>
bad offset/count parameters for given block
<dd>

The offset is negative or offset + count is greater than the block size.
<p>
<dt>
bad write mode
<dd>

Internal error; you attempted to open a file using an option lower than -1.
<p>
<dt>
write failed
<dd>

The write operation did not succeed.
<p>
<dt>
could not open output file
<dd>

The file or pipe could not be opened.
<p>
<dt>
could not seek in file
<dd>
 The seek operation failed.
<p>
</dl>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
* wtxtcl, memBlockGet, memBlockGetString

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

</blockquote><h1>memBlockDup</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockDup</strong> - create a new block exactly like a given one</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockDup <i>blockId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function clones a memory block, returning a new block handle.  The 
old block is not modified.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A new block handle.
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
<dl>
<dt>
block not found
<dd>

The block ID does not exist.
<p>
<dt>
could not duplicate block
<dd>
 A new block could not be created.
<p>
</dl>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
* wtxtcl, memBlockCreate, memBlockDelete

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

</blockquote><h1>memBlockSwap</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockSwap</strong> - switch the endianness of a block</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockSwap <i>blockId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
The endian flag of the named memory block is switched.  The data themselves
are not reorganized.
<p>
</blockquote><h4>ERROR</h4><blockquote><p>
<dl>
<dt>
block not found
<dd>
 The block ID does not exist.
<p>
</dl>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
* wtxtcl, memBlockCreate

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

</blockquote><h1>memBlockList</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockList</strong> - list the handles of all existing memory blocks</p>

<p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This command returns a list of the handles of all existing memory blocks.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A list of all outstanding memory blocks.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
This script cleans up all memory blocks:
<pre>foreach block [memBlockList] {memBlockDelete $block}
</pre>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
wtxtcl, memBlockCreate, memBlockDelete

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

</blockquote><h1>memBlockInfo</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockInfo</strong> - get information about a memory block</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockInfo <i>blockId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function returns a vector of information about a memory block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A four element list.  The first is the size of the block; the second is 
the amount of memory allocated for the block (this may be larger than 
the size by a small amount for the sake of efficiency); the third is the 
endianness of the block (<b>B</b> or <b>L</b>); and the fourth is the block's
fill character in hexadecimal.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
wtxtcl, memBlockCreate, memBlockList, memBlockDelete, memBlockSwap

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

</blockquote><h1>memBlockDelete</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockDelete</strong> - delete a memory block, freeing its resources</p>

<p>

</blockquote><h4>LOCALE</h4><blockquote><p>
WTX Tcl
<p>
</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockDelete <i>blockId</i>
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
The named memory block is deleted and the associated heap memory freed.
The handle becomes invalid and is never reused.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
This script recovers the memory of all existing blocks:
<p>
<pre>foreach block [memBlockList] {memBlockDelete $block}
</pre>

</blockquote><h4>SEE ALSO</h4><blockquote><p>
wtxtcl, memBlockCreate, memBlockList

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

</blockquote><h1>memBlockDis</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>memBlockDis</strong> - disassemble a memory block</p>

<p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>memBlockDis [-printaddr <i>cmd</i>] [-offset <i>n</i>] <i>format</i> <i>blockId</i> [<i>count</i>]
            <i>address</i>
</pre>

This API is not supported anymore. Use and Refer to wtxMemDisassemble for
further explanations.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>TCL_ERROR</b>
<p>
</blockquote><h4>ERRORS</h4><blockquote><p>
API not supported
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./memBlock.html#top">memBlock</a></b>

</body>
</html>