NAME    [Toc]    [Back]

     nlist - retrieve symbol table name list from  an  executable
file

SYNOPSIS    [Toc]    [Back]

     #include <nlist.h>

     int
     nlist(const char *filename, struct nlist *nl);

DESCRIPTION    [Toc]    [Back]

     The  nlist()  function  retrieves name list entries from the
symbol table of
     an executable 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 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 always  has  its  n_name
field set to
     NULL.

RETURN VALUES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     a.out(5)

HISTORY    [Toc]    [Back]

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

OpenBSD      3.6                          April      19,     1994