Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ldgetname(3x) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                            ldgetname(3x)



        _________________________________________________________________
        ldgetname                                              Subroutine
        retrieve symbol name for executable file symbol table entry in
        _________________________________________________________________
        DG/UX


        SYNTAX

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

        char *ldgetname (ldptr, symbol)
        LDFILE *ldptr;
        SYMENT *symbol;


        DESCRIPTION

        Ldgetname returns a pointer to the name associated with symbol as
        a string.  The string is contained in a static buffer local to
        ldgetname that is overwritten by each call to ldgetname, and
        therefore must be copied by the caller if the name is to be
        saved.

        Ldgetname will return NULL (defined in stdio.h) if the name
        cannot be retrieved.

        Typically, ldgetname will be called immediately after a
        successful call to ldtbread to retrieve the name associated with
        the symbol table entry filled by ldtbread.

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


        SEE ALSO

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


        CAVEATS

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






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



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