DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

ldgetname(S)


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

Syntax

cc . . . -lld

#include <filehdr.h>
#include <syms.h>
#include <ldfcn.h>

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

Description

The ldgetname function returns a pointer to the name associated with symbol as a string. The string is contained in a static buffer local to ldgetname that is overwritten by each call to ldgetname, and therefore must be copied by the caller if the name is to be saved.

The ldgetname function can be used to retrieve names from object files without any backward compatibility problems. The ldgetname function returns NULL (defined in stdio.h) for an object file if the name cannot be retrieved. This situation can occur:

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

See also

ldfcn(FP), ldtbindex(S), ldtbread(S), ldtbseek(S)

Standards conformance

ldgetname is not part of any currently supported standard; it is an extension of AT&T System V provided by the Santa Cruz Operation.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003