hpux man page for nlist_ia

Query: nlist_ia

OS: hpux

Section: 3c

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

nlist_ia(3C)															      nlist_ia(3C)

NAME
nlist_ia: nlist(), nlist64() - get entries from name list on Integrity systems
SYNOPSIS
Command: [flag]... [library]... Remarks The use of symbol table type and value information is inherently nonportable. The use of or should reduce the effort required to port a program that uses such information, but complete portability across all HP-UX implementations cannot be expected. This manpage describes and for Itanium-based systems. For and on PA-RISC systems, see nlist_pa(3C).
DESCRIPTION
and have basically the same functionality and they can process SOM or ELF files. The structure is the same as and is used for source code compatibility. The or function examines the name list in the executable file whose name is pointed to by file_name, and selectively extracts a list of values and puts them in the array of structures pointed to by nl. The array of structures initially contains only the names of variables. Once the or function has been called, the variable names are augmented with symbol information. The list is terminated by a null name, which consists of a null string in the variable-name position of the structure. The name list of the file is searched for each variable name. If the name is found, the symbol's type, scope, and value in the file is inserted into the name list structure. If the file searched is an ELF file, the section index is also inserted. For SOM files, the subspace index is inserted. The symbol value is 64-bit. If the file searched is a SOM file, then the value field is zero padded. If the name is not found, the fields in the name list structure are set to 0. The structures and are defined in the include file See a.out(4) and nlist(4) for further description of the symbol table structure. The file must have the organization and symbol table described for an file in a.out(4). The information is extracted from the symbol table used by the linker, ld(1). On machines that have such a file, this subroutine is useful for examining the system name list kept in file In this way programs can obtain system addresses that are up to date.
RETURN VALUE
All structure fields are set to 0 if the file cannot be found or if it is not a valid object file containing a linker symbol table. and return: An error occurred. Success.
WARNINGS
The header file is automatically included by for compatibility. However, including is discouraged if the only information needed from is for use by or If is included, the line may need to follow it.
SEE ALSO
ld(1), elf(3E), a.out(4), nlist(4).
STANDARDS CONFORMANCE
Integrity Systems Only nlist_ia(3C)
Related Man Pages
kvm_nlist(3kvm) - opensolaris
kvm_nlist(3kvm) - sunos
dladdr(3c) - hpux
kvm_nlist(3kvm) - osx
kvm_nlist(3kvm) - debian
Similar Topics in the Unix Linux Community
Issue with AIX 5.3 and nlist/nlist64/knlist
Concate 2 line into 1 line