A/UX® Programmer's Reference Sections

nlist(3C)
NAME
nlist - get entries from name list
SYNOPSIS
finclude
int nlist (filename, ni)
char *filename;
struct nlist *nl;
nlist(3C)
DESCRIPTION
nl i s t examines the name list in the executable file whose name
is pointed to by filename; it selectively extracts a list of values and
puts them in the array of nlist structures pointed to by nl. The
name list nl consists of an array of structures containing names of
variables, types, and values. The list is tenninated with a null
name; Le., 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 and value of the name are inserted in the
next two fields. The type filed will be set to 0 unless the file was
compiled with the -g option. If the name is not found, both entries
are set to O. See a. out(4) for a discussion of the symbol
table structure.
This function is useful for examining the system name list kept in
the file / unix. In this way programs can obtain system addresses
that are up to date.
RETURN VALUE
nlist returns -1 upon error; otherwise it returns O.
All value entries are set to 0 if the file cannot be read or if it does
not contain a valid name list
SEE ALSO
a.out(4).
February, 1990
RevisionC
1