nlist(3)           UNIX System V(BSD Compatibility Package)            nlist(3)


NAME
      nlist - get entries from symbol table

SYNOPSIS
      cc [ flag. . . ] file . . . -lucb
      #include <nlist.h>

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

DESCRIPTION
      nlist examines the symbol table from the executable image whose name is
      pointed to by filename, and selectively extracts a list of values and
      puts them in the array of nlist structures pointed to by nl.  The name
      list pointed to by nl consists of an array of structures containing
      names, types and values.  The nname field of each such structure is
      taken to be a pointer to a character string representing a symbol name.
      The list is terminated by an entry with a NULL pointer (or a pointer to a
      NULL string) in the nname field.  For each entry in nl, if the named
      symbol is present in the executable image's symbol table, its value and
      type are placed in the nvalue and ntype fields.  If a symbol cannot be
      located, the corresponding ntype field of nl is set to zero.

RETURN VALUE
      Upon normal completion, nlist returns the number of symbols that were not
      located in the symbol table.  If an error occurs, nlist returns -1 and
      sets all of the ntype fields in members of the array pointed to by nl to
      zero.

SEE ALSO
      a.out(4) in the Programmer's Reference Manual






















10/89                                                                    Page 1