nlist_pa(4) [hpux man page]

nlist_pa(4)						     Kernel Interfaces Manual						       nlist_pa(4)

NAME

       nlist_pa: nlist, nlist64 - structure formats for PA-RISC systems

SYNOPSIS

   Remarks
       The exact content of the structures defined below can be best found by examining It varies somewhat between various HP-UX implementations.

       This manpage describes on PA-RISC systems.  For on Integrity systems, see nlist_ia(4).

DESCRIPTION

       and  can  be  used to extract information from the symbol table in an object file (see nlist(3C)).  They are basically the same tool except
       can only process SOM files on a PA-RISC 32-bit system while can process SOM and ELF files on either a  PA-RISC  32-bit  or  64-bit  system.
       Since symbol tables are machine dependent (as defined in each implementation's copy of a header file, is defined to encapsulate the differ-
       ences.

       The nlist function, either or when used with the corresponding nlist structure, can be used to extract certain information  about  selected
       symbols in the symbol table.  The data associated with each symbol is machine specific, thus only the name and position of the field in the
       function is standardized by HP-UX.  The rest of the structure includes at least the value and type of the symbol.  The names  and  meanings
       of all fields not standardized will change no more than necessary.

SEE ALSO

       nlist(3C), a.out(4).

PA-RISC Systems Only														       nlist_pa(4)

nlist(3UCB)					     SunOS/BSD Compatibility Library Functions					       nlist(3UCB)

NAME

       nlist - get entries from symbol table

SYNOPSIS

       /usr/ucb/cc [ flag ... ] file ...
       #include <nlist.h>

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

DESCRIPTION

       nlist() examines the symbol table from the executable image whose name is pointed to by filename, and selectively extracts a list of values
       and puts them in the array of nlist structures pointed to by nl. The name list pointed to by nl consists of an array of structures contain-
       ing  names,  types and values. The n_name field of each such structure is taken to be a pointer to a character string representing a symbol
       name. The list is terminated by an entry with a NULL pointer (or a pointer to a NULL string) in the n_name field. For each entry in nl,	if
       the  named  symbol  is present in the executable image's symbol table, its value and type are placed in the n_value and n_type fields. If a
       symbol cannot be located, the corresponding n_type field of nl is set to zero.

RETURN VALUES

       Upon normal completion, nlist() returns the number of symbols that were not located in the  symbol  table.  If  an  error  occurs,  nlist()
       returns -1 and sets all of the n_type fields in members of the array pointed to by nl to zero.

SEE ALSO

       nlist(3ELF), a.out(4)

NOTES

       Use of these interfaces should be restricted to only applications written on BSD platforms.  Use of these interfaces with any of the system
       libraries or in multi-thread applications is unsupported.

       Only the n_value field is compatibly set.  Other fields in the nlist structure are filled with the  ELF	(Executable  and  Linking  Format)
       values (see  nlist(3ELF) and  a.out(4)).

SunOS 5.10							    3 May 1994							       nlist(3UCB)