ldgetname(3X)                                       ldgetname(3X)



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

     SYNOPSIS
          #include <stdio.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.  Because the buffer is
          overwritten by each call to ldgetname, it must be copied by
          the caller if the name is to be saved.

          The common object file format has been extended to handle
          arbitrary length symbol names with the addition of a "string
          table".  ldgetname returns the symbol name associated with a
          symbol table entry for either an object file or a pre-object
          file.  Thus, ldgetname can be used to retrieve names from
          object files without any backward compatibility problems.
          ldgetname returns NULL (defined in <stdio.h>) for an object
          file if the name cannot be retrieved.  This occurs when:


               the string table cannot be found.

               not enough memory can be allocated for the string
               table.

               the string table appears not to be a string table
               (e.g., if an auxiliary entry is handed to ldgetname
               that looks like a reference to a name in a non-existent
               string table).

               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 to retrieve the name associated
          with the symbol table entry filled by ldtbread.

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




     Page 1                                        (last mod. 1/14/87)

     ldgetname(3X)                                       ldgetname(3X)



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




















































     Page 2                                        (last mod. 1/14/87)