LDGETNAME(3X)                                       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
          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).

     ORIGIN
          MIPS Computer Systems










     Page 1                                        (last mod. 8/20/87)