1NLIST(3)                 BSD Library Functions Manual                 NLIST(3)
2

NAME

4     nlist — retrieve symbol table name list from an executable file
5

LIBRARY

7     Utility functions from BSD systems (libbsd, -lbsd)
8

SYNOPSIS

10     #include <nlist.h>
11
12     int
13     nlist(const char *filename, struct nlist *nl);
14

DESCRIPTION

16     The nlist() function retrieves name list entries from the symbol table of
17     an executable file (see a.out(5)).  The argument nl is set to reference
18     the beginning of the list.  The list is preened of binary and invalid
19     data; if an entry in the name list is valid, the n_type and n_value for
20     the entry are copied into the list referenced by nl.  No other data is
21     copied.  The last entry in the list is always NULL.
22

RETURN VALUES

24     The number of invalid entries is returned if successful; otherwise, if
25     the file filename does not exist or is not executable, the returned value
26     is -1.
27

SEE ALSO

29     a.out(5)
30

HISTORY

32     A nlist() function appeared in Version 6 AT&T UNIX.
33
34BSD                             April 19, 1994                             BSD