modulelib.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

        )
</pre>

This routine is called after all fields of the module ID have been filled in.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
<p>
Modules do not have information about their object segments when they are
created.  This information is not available until after the entire load
process has finished.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>, <b><a href="./moduleLib.html#moduleCreateHookDelete">moduleCreateHookDelete</a>(&nbsp;)</b>

<hr>
<a name="moduleCreateHookDelete"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleCreateHookDelete(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleCreateHookDelete(&nbsp;)</strong> - delete a previously added module create hook routine</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS moduleCreateHookDelete
    (
    FUNCPTR moduleCreateHookRtn /* routine called when module is added */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine removes a specified routine from the list of
routines to be called at each <b><a href="./moduleLib.html#moduleCreate">moduleCreate</a>(&nbsp;)</b> call.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the routine is not in the table of module create
hook routines.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>, <b><a href="./moduleLib.html#moduleCreateHookAdd">moduleCreateHookAdd</a>(&nbsp;)</b>

<hr>
<a name="moduleFindByName"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleFindByName(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleFindByName(&nbsp;)</strong> - find a module by name</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>MODULE_ID moduleFindByName
    (
    char * moduleName         /* name of module to find */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches for a module with a name matching <i>moduleName</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>MODULE_ID</b>, or NULL if no match is found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleFindByNameAndPath"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleFindByNameAndPath(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleFindByNameAndPath(&nbsp;)</strong> - find a module by file name and path</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>MODULE_ID moduleFindByNameAndPath
    (
    char * moduleName,        /* file name to find */
    char * pathName           /* path name to find */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches for a module with a name matching <i>moduleName</i>
and path matching <i>pathName</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>MODULE_ID</b>, or NULL if no match is found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleFindByGroup"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleFindByGroup(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleFindByGroup(&nbsp;)</strong> - find a module by group number</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>MODULE_ID moduleFindByGroup
    (
    int groupNumber           /* group number to find */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches for a module with a group number matching
<i>groupNumber</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>MODULE_ID</b>, or NULL if no match is found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleIdListGet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleIdListGet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleIdListGet(&nbsp;)</strong> - get a list of loaded modules</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int moduleIdListGet
    (
    MODULE_ID * idList,       /* array of module IDs to be filled in */
    int         maxModules    /* max modules <i>idList</i> can accommodate */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine provides the calling task with a list of all loaded
object modules.  An unsorted list of module IDs for no more than
<i>maxModules</i> modules is put into <i>idList</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The number of modules put into the ID list, or ERROR.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleInfoGet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleInfoGet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleInfoGet(&nbsp;)</strong> - get information about an object module</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS moduleInfoGet
    (
    MODULE_ID     moduleId,   /* module to return information about */
    MODULE_INFO * pModuleInfo /* pointer to module info struct */
    )
</pre>

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

<hr>
<a name="moduleCheck"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleCheck(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleCheck(&nbsp;)</strong> - verify checksums on all modules</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS moduleCheck
    (
    int options               /* validation options */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine verifies the checksums on the segments of all loaded
modules.  If any of the checksums are incorrect, a message is printed to
the console, and the routine returns ERROR.
<p>
By default, only the text segment checksum is validated.
<p>
Bits in the <i>options</i> parameter may be set to control specific checks:
<dl>
<dt>
<b>MODCHECK_TEXT</b>
<dd>
Validate the checksum for the TEXT segment (default).
<dt>
<b>MODCHECK_DATA</b>
<dd>
Validate the checksum for the DATA segment.
<dt>
<b>MODCHECK_BSS</b>
<dd>
Validate the checksum for the BSS segment.
<dt>
<b>MODCHECK_NOPRINT</b>
<dd>
Do not print a message (<b><a href="./moduleLib.html#moduleCheck">moduleCheck</a>(&nbsp;)</b> still returns ERROR on failure.)
</dl>

See the definitions in <b>moduleLib.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the checksum is invalid.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleNameGet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

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

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * moduleNameGet
    (
    MODULE_ID moduleId
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a pointer to the name associated with a module ID.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the module name, or NULL if the module ID is invalid.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

<hr>
<a name="moduleFlagsGet"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>moduleFlagsGet(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>moduleFlagsGet(&nbsp;)</strong> - get the flags associated with a module ID</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int moduleFlagsGet
    (
    MODULE_ID moduleId
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the flags associated with a module ID.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
The flags associated with the module ID, or NULL if the module ID
is invalid.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./moduleLib.html#top">moduleLib</a></b>

</body>
</html>