vxwmodule.html

vxworks相关论文

<hr>
<a name="VXWModule::VXWModule_2"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::VXWModule</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::VXWModule</i>(&nbsp;)</strong> - load an object module into memory</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWModule
    (
    int fd,
    int symFlag
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This constructor loads an object module from the file descriptor
<i>fd</i>, and places the code, data, and BSS into memory allocated from
the system memory pool.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::VXWModule_3"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::VXWModule</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::VXWModule</i>(&nbsp;)</strong> - create and initialize an object module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWModule
    (
    char * name,
    int    format,
    int    flags
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This constructor creates an object module descriptor.  It is usually
called from another constructor.
<p>
The arguments specify the name of the object module file, 
the object module format, and a collection of options <i>flags</i>.
<p>
Space for the new module is dynamically allocated.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::~VXWModule"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::~VXWModule</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::~VXWModule</i>(&nbsp;)</strong> - unload an object module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    ~VXWModule ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This destructor unloads the object module from the target system.  
For a.out and ECOFF format modules, unloading does the following:
<dl>
<dt>
(1)
<dd>

It frees the space allocated for text, data,
and BSS segments, unless <b><i><a href="./VXWModule.html#VXWModule::VXWModule">VXWModule::VXWModule</a></i>(&nbsp;)</b> was called with specific
addresses, in which case the application is responsible for freeing space.
<p>
<dt>
(2)
<dd>

It removes all symbols associated with the object module from the
system symbol table.
<p>
<dt>
(3)
<dd>
 It removes the module descriptor from the module list. 
</dl>

<p>

For other modules of other formats, unloading has similar effects.
<p>
Unloading modules with this interface has no effect on breakpoints
in other modules.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::flags"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::flags</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::flags</i>(&nbsp;)</strong> - get the flags associated with this module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    int flags ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the flags associated with its module.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The option flags.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::info"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::info</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::info</i>(&nbsp;)</strong> - get information about object module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS info
    (
    MODULE_INFO * pModuleInfo
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine fills in a <b>MODULE_INFO</b> structure with information about the
object module.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::name"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::name</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::name</i>(&nbsp;)</strong> - get the name associated with module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    char * name ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a pointer to the name associated with its module.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the module name.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

<hr>
<a name="VXWModule::segFirst"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::segFirst</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::segFirst</i>(&nbsp;)</strong> - find the first segment in module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    SEGMENT_ID segFirst ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns information about the first segment of a module
descriptor.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the segment ID.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWModule.html#VXWModule::segGet">VXWModule::segGet</a></i>(&nbsp;)</b>

<hr>
<a name="VXWModule::segGet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::segGet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::segGet</i>(&nbsp;)</strong> - get (delete and return) the first segment from module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    SEGMENT_ID segGet ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns information about the first segment of a module
descriptor, and then deletes the segment from the module.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the segment ID, or NULL if the segment list is empty.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWModule.html#VXWModule::segFirst">VXWModule::segFirst</a></i>(&nbsp;)</b>

<hr>
<a name="VXWModule::segNext"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWModule::segNext</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWModule::segNext</i>(&nbsp;)</strong> - find the next segment in module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>SEGMENT_ID segNext
    (
    SEGMENT_ID segmentId
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the segment in the list immediately following
<i>segmentId</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the segment ID, or NULL if there is no next segment.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWModule.html#top">VXWModule</a></b>

</body>
</html>