Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

nlist(3) OSS Library Calls Reference Manual
NAME
nlist - Gets entries from name list
LIBRARY
G-series native OSS processes: /G/system/sysnn/zutilsrl
H-series OSS processes: /G/system/zdllnnn/zutildll
SYNOPSIS
#include <nlist.h>
int nlist(
char *filename,
struct nlist n1[] );
PARAMETERS
filename Specifies the name of the file to examine.
n1[] Specifies the array in which the entry list is returned.
DESCRIPTION
The nlist() function examines the name list in the executable file specified by filename and selec-
tively extracts a list of values. The name list consists of an array of structures containing names,
types, and values. The list is terminated with a null name. 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 the next two
fields. If the name is not found, both entries are set to 0 (zero). See the header file nlist.h for the
structure declaration.
RETURN VALUES
If the file cannot be found, the file is not an HP NonStop server object file, or the name list is not
valid, -1 is returned. Otherwise, the number of unfound name list entries is returned.
ERRORS
None. This function does not set errno.
RELATED INFORMATION
Commands: nm(1).
5−14 Hewlett-Packard Company 527187-007