ldgetname(3X)

NAME
     ldgetname - Retrieves symbol name for object file symbol table entry

SYNOPSIS
     #include <stdio.h>
     #include <filehdr.h>
     #include <sym.h>
     #include <ldfcn.h>

     char *ldgetname ("ldptr, symbol")
     LDFILE *ldptr;
     pSYMR *symbol;

IMPLEMENTATION
     IRIX systems (o32 ABI only)

DESCRIPTION
     ldgetname returns a pointer to the name associated with symbol as a
     string.  The string is contained in a static buffer.  Because the
     buffer can be overwritten by later calls to ldgetname, the caller must
     copy the buffer if the name is to be saved.

     If the name cannot be retrieved, ldgetname returns NULL (defined in
     <stdio.h>) for an object file.  This occurs when:

     * The string table cannot be found.

     * The name's offset into the string table is beyond the end of the
       string table

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

     The program must be loaded with the object file access routine
     library, libmld.a.

SEE ALSO
     ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X)

     ldfcn(4)

     This man page is available only online.