nlist_pa(3C)nlist_pa(3C)NAME
nlist_pa: nlist(), nlist64() - get entries from name list on PA-RISC
systems
SYNOPSISnlist()
Command: [flag]... cfile...
nlist64()
Command: [flag]... cfile... [library]...
Remarks
The use of symbol table type and value information is inherently non‐
portable. 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 PA-RISC systems. For and on Integrity
systems, see nlist_ia(3C).
DESCRIPTION
and have basically the same functionality except that uses the struc‐
ture and can process SOM or ELF files. uses the structure and can only
process SOM files.
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 struc‐
ture. 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. For if the file searched is
an ELF file, the section index is also inserted. For and SOM files,
the subspace index is inserted. On wide-mode systems, 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 exam‐
ining 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. How‐
ever, 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 ALSOld(1), elf(3E), a.out(4), nlist(4).
STANDARDS CONFORMANCEPA-RISC Systems Only nlist_pa(3C)
