man(1) Manual page archive


     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 list is
          terminated with a null name.
          struct nlist {
                 char *n_name;          symbol name
                 unsigned char n_type;  type flag
                 char n_other;          unused
                 short n_desc;          unused
                 unsigned long n_value; value (or offset) of this symbol
          };
          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 `n_type' and `n_value' respectively.  If the name is not
          found, both entries are set to 0.

          This subroutine is useful for examining the system name list
          kept in 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 some UNIX systems you must include rather than This is
          unfortunate, but can't be used on the VAX because it con-
          tains a union, which can't be initialized.