Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nlist(3) [freebsd man page]

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

nlist -- retrieve symbol table name list from an executable file LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <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(3)						     Library Functions Manual							  nlist(3)

nlist - Gets entries from name list. SYNOPSIS
#include <nlist.h> nlist(filename, nl) char *filename; struct nlist nl[]; cc ... -lmld DESCRIPTION
NOTE: The nlist subroutine has moved from the standard C library to the libmld.a library due to the difference in the object file format. Programs that need to use nlist must be linked with the -lmld flag. The nlist subroutine examines the name list in the given executable output file and selectively 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. For BSD compatibility, the nlist subroutine allows symbol names to be preceded by an underscore. If it does not find a symbol that matches the name as specified, nlist attempts to locate the symbol name with the leading underscore removed. For the structure declaration, see /usr/include/nlist.h. To obtain up-to-date system addresses from the system name list kept in the file /vmunix, use the knlist subroutine. Alternatively, use the getsysinfo function to obtain the name of the file from which the kernel was booted, prepend a slash character ("/") to this name, and supply the prepended name to the nlist subroutine. Do not specify /vmunix as the filename to the nlist subroutine; nlist may return invalid symbol addresses. ERRORS
If the file cannot be found or if it is not a valid namelist, -1 is returned; otherwise, the number of unfound namelist entries is returned. The type entry is set to 0 if the symbol is not found. RELATED INFORMATION
getsysinfo(2), knlist(3), a.out(4) delim off nlist(3)
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 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