term% cat index.txt NLIST(3) Library Functions Manual NLIST(3)
NAME
nlist - get entries from name list
SYNOPSIS
#include <nlist.h>
nlist(filename, nl)
char *filename;
struct nlist nl[];
DESCRIPTION
Nlist examines the name list in the given executable output file and
selectively extracts a list of values. The name list consists of an
array of structures containing names, types and values. The list is
terminated with a null name. Each name is looked up in the name list
of the file. If the name is found, the type and value of the name are
inserted in the next two fields. If the name is not found, both en‐
tries are set to 0. See a.out(5) for the structure declaration.
This subroutine is useful for examining the system name list kept in
`/unix' . In this way programs can obtain system addresses that are up
to date.
SEE ALSO
a.out(5)
DIAGNOSTICS
All type entries are set to 0 if the file cannot be found or if it is
not a valid namelist.
BUGS
On other versions of UNIX you must include <a.out.h> rather than
<nlist.h>. This is unfortunate, but <a.out.h> can't be used on the VAX
because it contains a union, which can't be initialized.
NLIST(3)