NLIST(3)                GENIX Programmer's Manual                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  declara-
           tion.

           This subroutine is useful for examining the system name list kept in
           the  file /vmunix.  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.





















      Printed 11/16/83                                                        1