nlist_ia.4 (2010 09)

nlist_ia(4)

Integrity Systems Only

nlist_ia(4)

NAME

nlist_ia: nlist, nlist64 - structure formats for Integrity systems

SYNOPSIS

#include <nlist.h>

Remarks

The exact content of the structure deﬁned below can be best found by examining

/usr/include/nlist.h

. It varies somewhat between various HP-UX implementations.

This manpage describes

<nlist.h> on Integrity systems. For

<nlist.h> on PA-RISC systems, see

nlist_pa (4).

DESCRIPTION

nlist() and nlist64() can be used to extract information from the symbol table in an object ﬁle (see

nlist (3C)). They are basically the same tool, and both can process SOM and Elf ﬁles. Since symbol tables

are machine dependent (as deﬁned in each implementation’s copy of

<a.out.h>), a header ﬁle,

nlist.h is deﬁned to encapsulate the differences.

The nlist function, either

nlist() or nlist64()

, when used with the corresponding nlist structure,

can be used to extract certain information about selected symbols in the symbol table. The data associ-

ated with each symbol is machine speciﬁc, thus only the name and position of the n_name ﬁeld 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 ﬁelds not standardized will change no more than necessary.

The

nlist structure is the same as the nlist64 structure and is used for source compatibility pur-

poses.

struct nlist64 {

char *n_name;

/* other fields as needed;

the following are suggested if they apply */

char *n_qual;

unsigned short n_type;

unsigned short n_scope;

unsigned long n_info;

unsigned long long n_value;

unsigned int is_elf:1;

unsigned int is_32:1;

unsigned int reserved1:30;

unsigned long long reserved2;

unsigned long long reserved3;

};