Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NLIST(3)		     Library Functions Manual			NLIST(3)

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

LIBRARY
     Standard C Library (libc, -lc)

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 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 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
     elf(5)

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

FreeBSD ports 15.quarterly	 April 19, 1994 			NLIST(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nlist&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help