NLIST(3) BSD Library Functions Manual NLIST(3)NAME
nlist -- retrieve symbol table name list from an executable file
nlist(const char *filename, struct nlist *nl);
The nlist() function retrieves name list entries from the symbol table of an executable file. (See <mach-o/nlist.h>) The argument nl is set
to reference 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.
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 Mach-O(5)HISTORY
A nlist() function appeared in Version 6 AT&T UNIX.
Darwin April 19, 1994 Darwin
Check Out this Related Man Page
nlist(3) Library Functions Manual nlist(3)NAME
nlist - Gets entries from name list.
nlist(filename, nl) char *filename; struct nlist nl;
cc ... -lmld
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.
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
The type entry is set to 0 if the symbol is not found.
RELATED INFORMATION getsysinfo(2), knlist(3), a.out(4) delim off
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)
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)
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)
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)