Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ldtbread(3x) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                             ldtbread(3x)



        _________________________________________________________________
        ldtbread                                               Subroutine
        read an indexed symbol table entry of an executable file
        _________________________________________________________________


        SYNTAX

        #include <stdio.h>
        #include <sys/types.h>
        #include <filehdr.h>
        #include <syms.h>
        #include <ldfcn.h>

        int ldtbread (ldptr, symindex, symbol)
        LDFILE *ldptr;
        long symindex;
        SYMENT *symbol;


        DESCRIPTION

        Ldtbread reads the symbol table entry specified by symindex of
        the executable file currently associated with ldptr into the area
        of memory beginning at symbol.

        Ldtbread returns SUCCESS or FAILURE.  Ldtbread will fail if
        symindex is greater than the number of symbols in the executable
        file or if it cannot read the specified symbol table entry.

        Note that the first symbol in the symbol table has an index of 0.

        The program must be loaded with the executable file access
        routine library libld.a.


        SEE ALSO

        ldclose(3X), ldopen(3X), ldtbseek(3X), ldgetname(3X), ldfcn(4).


        CAVEATS

        The executable file format is used only for executable files
        (load modules), not for object files.


        BUGS

        This function can be very slow since the symbol table is
        currently searched linearly.



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026