This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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

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

SYNOPSIS
     #include <mach-o/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
     <mach-o/nlist.h>) The argument 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 n_type and n_value 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 executable, the returned value is -1.

SEE ALSO
     Mach-O(5)

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

Darwin                          April 19, 1994                          Darwin