.TH NLIST 3
.SH NAME
nlist \- get namelist entries
.SH SYNOPSIS
.ft B
.nf
#include <a.out.h>

int nlist(const char *\fIfile\fP, struct nlist \fInl\fP[])
.fi
.ft P
.SH DESCRIPTION
.B Nlist()
fills fields
.B n_sclass
and
.B n_value
of array
.I nl
with values found in the non-stripped executable
.BR file ,
whose
.I n_name
strings are identical to those in
.BR nl .
Entries in
.BR nl
that are not found have their
.BR n_value / n_sclass
fields set to 0.
.PP
.I Nl
ends with an entry with a null pointer or empty string
.BR n_name .
.SH "SEE ALSO"
.BR nm (1).
.SH DIAGNOSTICS
The return value is -1 on failure, else the number of entries not
found in
.IR file .
\".
\". $PchId: nlist.3,v 1.3 1995/11/27 20:21:14 philip Exp $