NLIST(S)                 XENIX System V                  NLIST(S)



     Name
          nlist - Gets entries from name list.

     Syntax
          #include <a.out.h>

          int 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(F) for a discussion of the
          symbol table structure.

     See Also
          a.out(F), xlist(S)

     Diagnostics
          nlist return -1 and sets all type entries to 0 if the file
          cannot be read, is not an object file, or contains an
          invalid name list.  Otherwise, nlist returns 0.  A return
          value of 0 does not indicate that any or all symbols were
          found.

























     Page 1                                           (printed 8/7/87)