LDGETNAME(3X)							 LDGETNAME(3X)

NAME    [Toc]    [Back]

     ldgetname - retrieve symbol name for object file symbol table entry

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>
     #include <filehdr.h>
     #include <sym.h>
     #include <ldfcn.h>

     char *ldgetname (ldptr, symbol)
     LDFILE *ldptr;
     pSYMR *symbol;

DESCRIPTION    [Toc]    [Back]

     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:


     o	  the string table cannot be found

     o	  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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111