ldgetname(3X)           LIBRARY FUNCTIONS           ldgetname(3X)



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).













                                                                1