NLIST
Section: Misc. Reference Manual Pages (3bsd)
Page Index
BSD mandoc
NAME
nlist
- retrieve symbol table name list from an executable file
LIBRARY
Lb libbsd
SYNOPSIS
In nlist.h
(See
libbsd(7)
for include usage.)
Ft int
Fn nlist const char *filename struct nlist *nl
DESCRIPTION
The
Fn nlist
function
retrieves name list entries from the symbol table of an
executable file (see
a.out5).
The argument
Fa nl
is set to reference the
beginning of the list.
The list is preened of binary and invalid data;
if an entry in the
name list is valid, the
Fa n_type
and
Fa n_value
for the entry are copied into the list
referenced by
Fa nl .
No other data is copied.
The last entry in the list is always
NULL
RETURN VALUES
The number of invalid entries is returned if successful; otherwise,
if the file
Fa filename
does not exist or is not executable, the returned value is -1.
SEE ALSO
a.out5
HISTORY
A
Fn nlist
function appeared in
AT&T System
v6 .