NLIST(3)                                                 NLIST(3)

     NAME
          nlist - get entries from name list

     SYNOPSIS
          #include <nlist.h>
          nlist(filename, nl)
          char *filename;
          struct nlist nl[];

     DESCRIPTION
          Nlist examines the name list in the given executable output
          file and selectively extracts a list of values.  The name
          list consists of an array of structures containing names,
          types and values.  The list is terminated with a null name.
          Each name is looked up in the name list of the file.  If the
          name is found, the type and value of the name are inserted
          in the next two fields.  If the name is not found, both
          entries are set to 0.  See a.out(5) for the structure decla-
          ration.

          This subroutine is useful for examining the system name list
          kept in `/unix' .  In this way programs can obtain system
          addresses that are up to date.

     SEE ALSO
          a.out(5)

     DIAGNOSTICS
          All type entries are set to 0 if the file cannot be found or
          if it is not a valid namelist.

     BUGS
          On other versions of UNIX you must include <a.out.h> rather
          than <nlist.h>.  This is unfortunate, but <a.out.h> can't be
          used on the VAX because it contains a union, which can't be
          initialized.