ELF Library Functions                                 nlist(3ELF)



NAME
     nlist - get entries from name list

SYNOPSIS
     cc [ flag... ] file ... -lelf [ library ... ]
     #include 

     int nlist(const char *filename, struct nlist *nl);


DESCRIPTION
     nlist() examines the name list in the executable file  whose
     name  is  pointed to by filename, and selectively extracts a
     list of values and puts them in the array of nlist()  struc-
     tures  pointed  to  by  nl.  The name list nl consists of an
     array of structures containing names  of  variables,  types,
     and  values.  The  list is terminated with a null name, that
     is, a null string is in the name position of the  structure.
     Each  variable  name  is  looked  up in the name list of the
     file. If the name is found, the type, value, storage  class,
     and  section  number  of  the name are inserted in the other
     fields. The type field may be set to 0 if the file  was  not
     compiled with the -g option to  cc(1B).


     nlist() will always return the information for  an  external
     symbol of a given name if the name exists in the file. If an
     external symbol does not exist, and there is more  than  one
     symbol  with the specified name  in the file (such as static
     symbols defined in separate files), the values returned will
     be  for the last occurrence of that name in the file. If the
     name is not found, all fields in the structure except nname
     are set to 0.


     This function is useful for examining the system  name  list
     kept in the file /dev/ksyms. In this way programs can obtain
     system addresses that are up to date.

RETURN VALUES
     All value entries are set to 0 if the file cannot be read or
     if it does not contain a valid name list.


     nlist() returns 0 on success, -1 on error.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:






SunOS 5.11          Last change: 11 Jul 2001                    1






ELF Library Functions                                 nlist(3ELF)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     Safe                        
    


SEE ALSO
     cc(1B),    elf(3ELF),    kvmnlist(3KVM),    kvmopen(3KVM),
     libelf(3LIB), a.out(4), attributes(5), ksyms(7D), mem(7D)











































SunOS 5.11          Last change: 11 Jul 2001                    2