NLIST(3)                    BSD Programmer's Manual                   NLIST(3)

NAME
     nlist - retrieve symbol table name list from an executable file

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 exectutable file. (See a.out(5).)  The argument nl is set to reference
     the beginning of the list.  The list is preened of binary and invalid da-
     ta; if an entry in the name list is valid, the ntype and nvalue for the
     entry are copied into the list referenced by 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 filename does not exist or is not exectuable, the returned value
     is -1.

SEE ALSO
     a.out(5)

HISTORY
     A nlist() function appeared in Version 6 AT&T UNIX.

4th Berkeley Distribution       March 26, 1993                               1