ldgetname(3) [osf1 man page]

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)

ldtbread(3)						     Library Functions Manual						       ldtbread(3)

NAME

       ldtbread - Read an indexed symbol table entry of a common object file

SYNOPSIS

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

       int ldtbread (ldptr, symindex, symbol) LDFILE *ldptr ; long symindex ; pSYMR *symbol ;

DESCRIPTION

       The  ldtbread routine reads the symbol table entry specified by symindex of the common object file currently associated with ldptr into the
       area of memory beginning at symbol.

       It returns SUCCESS or FAILURE.  If symindex is greater than the number of symbols in the object file or if it  cannot  read  the  specified
       symbol table entry, ldtbread fails.

       The  local  and	external  symbols  are	concatenated  into  a  linear  list.   Symbols	are  accessible  from  symbol  index  zero to SYM-
       HEADER(ldptr).isymMax + SYMHEADER(ldptr).iextMax.  The index and iss fields of the SYMR are made absolute (rather than  file  relative)	so
       that  the routines ldgetname(3), ldgetaux(3), and ldtbread proceed normally given those indices.  Only the SYMR part of the external symbol
       structure is returned.

       NOTE: The first symbol in the symbol table has an index of zero.

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

RELATED INFORMATION

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

																       ldtbread(3)