Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nlist(3) [x11r4 man page]

NLIST(3)						   BSD Library Functions Manual 						  NLIST(3)

NAME
nlist -- retrieve symbol table name list from an executable file LIBRARY
Utility functions from BSD systems (libbsd, -lbsd) SYNOPSIS
#include <bsd/nlist.h> int nlist(const char *filename, struct nlist *nl); DESCRIPTION
The nlist() function retrieves name list entries from the symbol table of an executable file (see a.out(5)). The argument nl is set to ref- erence the beginning of the list. The list is preened of binary and invalid data; if an entry in the name list is valid, the n_type and n_value for the entry are copied into the list referenced by nl. No other data is copied. The last entry in the list is always NULL. RETURN VALUES
The number of invalid entries is returned if successful; otherwise, if the file filename does not exist or is not executable, the returned value is -1. SEE ALSO
a.out(5) HISTORY
A nlist() function appeared in Version 6 AT&T UNIX. BSD
April 19, 1994 BSD

Check Out this Related Man Page

nlist(3ELF)						       ELF Library Functions						       nlist(3ELF)

NAME
nlist - get entries from name list SYNOPSIS
cc [ flag... ] file ... -lelf [ library ... ] #include <nlist.h> int nlist(const char *filename, struct nlist *nl); DESCRIPTION
nlist() examines the name list in the executable file 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 nl consists of an array of structures containing names of variables, types, and values. The list is terminated with a null name, that is, 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, value, storage class, and section number of the name are inserted in the other fields. The type field may be set to 0 if the file was not compiled with the -g option to cc(1B). nlist() will always return the information for an external symbol of a given name if the name exists in the file. If an external symbol does not exist, and there is more than one symbol with the specified name in the file (such as static symbols defined in separate files), the values returned will be for the last occurrence of that name in the file. If the name is not found, all fields in the structure except n_name are set to 0. This function is useful for examining the system name list kept in the file /dev/ksyms. In this way programs can obtain system addresses that are up to date. RETURN VALUES
All value entries are set to 0 if the file cannot be read or if it does not contain a valid name list. nlist() returns 0 on success, -1 on error. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Stable | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
cc(1B), elf(3ELF), kvm_nlist(3KVM), kvm_open(3KVM), libelf(3LIB), a.out(4), attributes(5), ksyms(7D), mem(7D) SunOS 5.11 11 Jul 2001 nlist(3ELF)
Man Page

4 More Discussions You Might Find Interesting

1. AIX

Issue with AIX 5.3 and nlist/nlist64/knlist

I have encountered a problem that I cannot resolve. We have two different AIX 5.3 boxes. On one box, regardless of whether it is booted in 32 bit mode or 64 bit mode, I can obtain kernel metrics (i.e, using kernel symbol names sysinfo or avenrun) via the nlink or nlink64 system call. On... (0 Replies)
Discussion started by: lawrence
0 Replies

2. AIX

Problem with knlist in AIX 5.3 for Power5 processor

Hi all, I have a AIX 5.3 Installation on the Power5 processor. I am using the knlist API for getting the details of the CPU details like user cpu, kernel cpu, idle cpu and wait cpu. My code is working fine on other Installations of AIX like PowerPC_POWER4 but it is giving wrong values on Power5... (0 Replies)
Discussion started by: rajesht
0 Replies

3. AIX

knlist API on AIX 5.3

Hi, I have written an application which reports the CPU information like user cpu%, sys cpu%, idle cpu% and wait cpu%. The application is built on an AIX 5.1 machine. The appliaction runs fine on AIX 5.1 and 5.2 and their results match with that of the topas command. But when I run the... (1 Reply)
Discussion started by: allthanksquery
1 Replies

4. HP-UX

Ftp command nlist not supporting in sftp

Hi, We are using HP-UX. Previously we were using ftp to connect to remote list the text file name and copy into local file with .ls extension. For this we are using nlist RBOBAR*.txt DMSFT.ls now we want to convert the integration with sftp. So In sftp nlist command is not supported. How can we... (8 Replies)
Discussion started by: Pelins
8 Replies