symlib.html

vxworks相关论文

<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

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

</blockquote><h1><i>symFindByValue</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>symFindByValue</i>(&nbsp;)</strong> - look up a symbol by value</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS symFindByValue
    (
    SYMTAB_ID  symTblId, /* ID of symbol table to look in */
    UINT       value,    /* value of symbol to find */
    char *     name,     /* where to put symbol name string */
    int *      pValue,   /* where to put symbol value */
    SYM_TYPE * pType     /* where to put symbol type */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches a symbol table for a symbol matching a specified
value.  If there is no matching entry, it chooses the table entry with the
next lower value.  The symbol name (with terminating EOS), the actual
value, and the type are copied to <i>name</i>, <i>pValue</i>, and <i>pType</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if <i>value</i> is less than the lowest value in the table.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

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

</blockquote><h1><i>symByValueFind</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>symByValueFind</i>(&nbsp;)</strong> - look up a symbol by value</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS symByValueFind
    (
    SYMTAB_ID  symTblId, /* ID of symbol table to look in */
    UINT       value,    /* value of symbol to find */
    char * *   name,     /* where to put symbol name string */
    int *      pValue,   /* where to put symbol value */
    SYM_TYPE * pType     /* where to put symbol type */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches a symbol table for a symbol matching a specified
value.  If there is no matching entry, it chooses the table entry with the
next lower value.  The symbol name (with terminating EOS), the actual
value, and the type are copied to <i>name</i>, <i>pValue</i>, and <i>pType</i>.
<i>name</i> is a pointer allocated by the function and the memory must be
freed after the use of <i>name</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if <i>value</i> is less than the lowest value in the table.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

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

</blockquote><h1><i>symFindByValueAndType</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>symFindByValueAndType</i>(&nbsp;)</strong> - look up a symbol by value and type</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS symFindByValueAndType
    (
    SYMTAB_ID  symTblId, /* ID of symbol table to look in */
    UINT       value,    /* value of symbol to find */
    char *     name,     /* where to put symbol name string */
    int *      pValue,   /* where to put symbol value */
    SYM_TYPE * pType,    /* where to put symbol type */
    SYM_TYPE   sType,    /* symbol type to look for */
    SYM_TYPE   mask      /* bits in <i>sType</i> to pay attention to */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches a symbol table for a symbol matching both value and
type (<i>value</i> and <i>sType</i>).  If there is no matching entry, it chooses the
table entry with the next lower value.  The symbol name (with terminating
EOS), the actual value, and the type are copied to <i>name</i>, <i>pValue</i>, and
<i>pType</i>.  The <i>mask</i> parameter can be used to match sub-classes of type.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if <i>value</i> is less than the lowest value in the table.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

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

</blockquote><h1><i>symByValueAndTypeFind</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>symByValueAndTypeFind</i>(&nbsp;)</strong> - look up a symbol by value and type</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS symByValueAndTypeFind
    (
    SYMTAB_ID  symTblId, /* ID of symbol table to look in */
    UINT       value,    /* value of symbol to find */
    char * *   ppName,   /* where to put symbol name string */
    int *      pValue,   /* where to put symbol value */
    SYM_TYPE * pType,    /* where to put symbol type */
    SYM_TYPE   sType,    /* symbol type to look for */
    SYM_TYPE   mask      /* bits in <i>sType</i> to pay attention to */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine searches a symbol table for a symbol matching both value and
type (<i>value</i> and <i>sType</i>).  If there is no matching entry, it chooses the
table entry with the next lower value.  The symbol name (with terminating
EOS), the actual value, and the type are copied to <i>name</i>, <i>pValue</i>, and
<i>pType</i>.  The <i>mask</i> parameter can be used to match sub-classes of type.
<i>name</i> is a pointer allocated by the function and the memory must be
freed after the use of <i>name</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR if <i>value</i> is less than the lowest value in the table.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>

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

</blockquote><h1><i>symEach</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>symEach</i>(&nbsp;)</strong> - call a routine to examine each entry in a symbol table</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>SYMBOL * symEach
    (
    SYMTAB_ID symTblId,  /* pointer to symbol table */
    FUNCPTR   routine,   /* func to call for each tbl entry */
    int       routineArg /* arbitrary user-supplied arg */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine calls a user-supplied routine to examine each entry in the
symbol table; it calls the specified routine once for each entry.  The
routine should be declared as follows:
<pre>    BOOL routine
        (
        char      *name,  /* entry name                  */
        int       val,    /* value associated with entry */
        SYM_TYPE  type,   /* entry type                  */
        int       arg,    /* arbitrary user-supplied arg */
        UINT16    group   /* group number                */
        )
</pre>
The user-supplied routine should return TRUE if <b><i><a href="./symlib.html#symEach">symEach</a></i>(&nbsp;)</b> is to continue
calling it for each entry or FALSE if it is done and <b><i><a href="./symlib.html#symEach">symEach</a></i>(&nbsp;)</b> can exit.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the last symbol reached or NULL if all symbols are reached.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./symlib.html#top">symlib</a></b>, <i>API Programmer's Guide: Object Module Loader </i>
<p>


</body>
</html>