tgtmem.html

vxworks相关论文

on the cache memory attribute of the destination block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>, <b><i><a href="./tgtmem.html#tgtMemWrite">tgtMemWrite</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemWriteShort"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemWriteShort</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemWriteShort</i>(&nbsp;)</strong> - write a <b>short</b> to the target</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemWriteShort
    (
    REMPTR destination,
    UINT16 value
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine writes a <b>short</b> to the target. Actual operation depends
on the cache memory attribute of the destination block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>, <b><i><a href="./tgtmem.html#tgtMemWrite">tgtMemWrite</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemWriteInt"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemWriteInt</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemWriteInt</i>(&nbsp;)</strong> - write an <b>int</b> to the target</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemWriteInt
    (
    REMPTR destination,
    int    value
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine writes a integer to the target. Actual operation depends
on the cache memory attribute of the destination block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>, <b><i><a href="./tgtmem.html#tgtMemWrite">tgtMemWrite</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemWrite"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemWrite</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemWrite</i>(&nbsp;)</strong> - write a block to the target</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemWrite
    (
    void * source,
    REMPTR destination,
    int    nBytes
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine writes a block of memory to the target. Actual operation depends
on the cache memory attribute of the destination block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemWidthWrite"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemWidthWrite</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemWidthWrite</i>(&nbsp;)</strong> - write a block to the target</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemWidthWrite
    (
    void * source,
    REMPTR destination,
    int    nBytes,
    int    width
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine writes a block of memory to the target. Actual operation depends
on the cache memory attribute of the destination block.
The memory is written <i>width</i> bytes by <i>width</i> bytes.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemMove"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemMove</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemMove</i>(&nbsp;)</strong> - move a block on the target</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemMove
    (
    REMPTR source,
    REMPTR destination,
    int    nBytes
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine copies a block of memory from one target location to another
target location and updates the host memory cache.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operations fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemCacheSet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemCacheSet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemCacheSet</i>(&nbsp;)</strong> - give a block of target memory an attribute</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemCacheSet
    (
    REMPTR     pRem,      /* pointer to block of memory to map */
    int        nBytes,    /* block size */
    MEM_ATTRIB attribute, /* attribute of memory */
    BOOL       pushBlock  /* push the block to target memory */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine specifies the attribute of a block of host-mapped
target memory.  Blocks with attributes may not overlap, but block
attributes mapped previously with this routine may be changed with
this routine.  All allocation routines return memory with the
attribute <b>MEM_NONE</b>.
<p>
The possible values for <b>MEM_ATTRIBUTE</b> are:
<p>
<dl>
<dt>
<b>MEM_NO_WRITE</b>
<dd>

Flag write operations as errors.  Perform read operations from the
target.  This is typically used to protect read-only data
structures.  Note that this does not protect the memory from a
target-originated write, only from writes originating from the host.
<p>

<dt>
<b>MEM_HOST</b>
<dd>

Allocate a block of memory to store all reads and writes locally.
Do not update the target memory when the block is modified.  This
mode is utilized to prefill an entire block of memory before the
block is transferred to the target.  When relocating a new object
module into target memory, for instance, the object module can be
staged in this way to avoid all target intrusion during the link.
<p>

<dt>
<b>MEM_TEXT</b>
<dd>
 Allocate a block of memory to cache all reads from this region.
Handle writes as write-through requests, updating both the
cache and the target memory. 
</dl>

<p>

Setting the attribute of a block the first time does not synchronize the
target and host memory.  However, when changing an attribute to turn off
<b>MEM_HOST</b>, a <b><i><a href="./tgtmem.html#tgtMemWrite">tgtMemWrite</a></i>(&nbsp;)</b> of the block is performed to update target memory.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
OK or ERROR if passed an invalid block pointer, if the block is not
mapped or if the target server cache for agent memory is full.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemCacheGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemCacheGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemCacheGet</i>(&nbsp;)</strong> - get a block descriptor for target memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS tgtMemCacheGet
    (
    REMPTR       pRem,      /* pointer to block of memory to map */
    BLOCK_DESC * pBlockDesc /* memory descriptor to fill in */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine fills in a block descriptor for the block of memory in which
the specified remote pointer resides.  
<p>
<pre>typedef struct                  /* BLOCK_DESC */
   {
   MEM_DESC            memDesc;        /* block descriptor */
   REMPTR              base;           /* block pointer */
   void *              pLocal;         /* local cached copy */
   int                 nBytes;         /* block size */
   MEM_ATTRIB          attrib;         /* memory attribute */
   } BLOCK_DESC;
</pre>

The size of the block is returned in the field <b>nBytes</b>.  If the block has
no attribute set, the attribute <b>MEM_NONE</b> is returned, and the <b>nBytes</b>
field contains the number of bytes to the beginning of the next highest
block with an attribute set or NONE if there is no higher block.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if the operation fails.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>, <b><i><a href="./tgtmem.html#tgtMemCacheSet">tgtMemCacheSet</a></i>(&nbsp;)</b>,  
<i>API Programmer's Guide: Object Module Loader </i>

<hr>
<a name="tgtMemAlignGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Target Server Internal Routines :  Routines</i></a></p>

</blockquote><h1><i>tgtMemAlignGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>tgtMemAlignGet</i>(&nbsp;)</strong> - return the alignment value for the target memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>

UINT tgtMemAlignGet (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This function returns the alignment value for the target memory.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
An integer or ERROR if the operation fails.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./tgtmem.html#top">tgtmem</a></b>

</body>
</html>