ldgetname(3X)                                       ldgetname(3X)



NAME
     ldgetname - retrieves 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 preobject file.  Thus, ldgetname can be used to
     retrieve names from object files without any backward
     compatibility problems.

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

     Programs using this routine should be loaded with the object
     file access library libld.a.

STATUS MESSAGES AND VALUES
     The ldgetname command 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 (for
          example, if an auxiliary entry is handed to ldgetname
          that looks like a reference to a name in a nonexistent
          string table).

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




January 1992                                                    1

ldgetname(3X)                                       ldgetname(3X)



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




















































2                                                    January 1992