Printed 1/15/91                   Page 1

LDGETNAME(3X-SysV)  RISC/os Reference Manual   LDGETNAME(3X-SysV)



NAME
     ldgetname - retrieve 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 ;

DESCRIPTION
     Ldgetname returns a pointer to the name associated with sym-
     bol 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 success-
     ful call to ldtbread. Ldgetname retrieves the name associ-
     ated with the symbol table entry filled by ldtbread.

     The program must be loaded with the object file access rou-
     tine library libmld.a.

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













                         Printed 1/15/91                   Page 1