NLIST(III)                   6/12/72                   NLIST(III)







NAME

     nlist - get entries from name list



SYNOPSIS

            jsrr5,nlist; file; list

            ...

     file:  <file name\0>; .even

     list:  <name1xxx>; type1; value1

            <name2xxx>; type2; value2

            ...

            0



     nlist(filename, nl)

     char *filename;

     struct {

             char    name[8];

             int     type;

             int     value;

     } 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 a list of 8-character names  (null  padded)

     each  followed  by two words.  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 placed in the two words following the name.  If the name

     is not found, the type entry is set to -1.



     This subroutine is useful for examining the system name list

     kept  in  the  file /usr/sys/unix.  In this way programs can

     obtain system addresses that are up to date.



SEE ALSO

     a.out(V)



DIAGNOSTICS

     All type entries are set to -1 if the file cannot  be  found

     or if it is not a valid namelist.



BUGS