nlist
- retrieve symbol table name list from an executable file
LIBRARY
Lb libc
SYNOPSIS
#include <nlist.h> int
nlist (const char *filename struct nlist *nl);
DESCRIPTION
The
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.