nlist3
Retrieve symbol table name list from an executable file
Usage
#include <nlist.h>
int
nlist(const char *filename, struct nlist *nl);
Library
Standard C Library (libc, -lc)
Overview
The nlist() function retrieves name list entries from elf(5) sections with type SHT_DYNSYM or SHT_SYMTAB in an ELF object (for example, an executable file or shared library). This function is provided for compatibility with legacy applications. Its use is discouraged.
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.
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.
Releases
87 releases since FreeBSD 2.0.5-RELEASE; the text changed 42 times.