ldgetname(3x) [ultrix man page]

ldgetname(3x)															     ldgetname(3x)

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

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

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

Description
       The  function  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 the caller must copy the buffer if the name is to be saved.

       If the name cannot be retrieved, returns null (defined in <stdio.h>) for an object file.  This occurs in the following instances:

       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, is called immediately after a successful call to retrieves the name associated with the symbol table entry filled by	the  func-
       tion,

See Also
       intro(3x), ldclose(3x), ldopen(3x), ldtbseek(3x), ldtbread(3x), ldfcn(5).

								       RISC							     ldgetname(3x)

ldgetname(3)						     Library Functions Manual						      ldgetname(3)

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

       The  ldgetname  routine	returns  a  pointer  to  the name associated with symbol.  The pointer is returned as a string 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 can-
       not 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 ta-
       ble entry filled by ldtbread.

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

       [Tru64 UNIX]  For C++, ldgetname returns the demangled name.

RELATED INFORMATION

       ldclose(3), ldopen(3), ldtbseek(3), ldtbread(3), ldfcn(4).  delim off

																      ldgetname(3)