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)
