nlist (3)

Leading comments

 Copyright (c) 1980, 1991, 1993
	The Regents of the University of California.  All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the fol...

(The comments found at the beginning of the groff file "man3/nlist.3bsd".)

NAME

nlist - retrieve symbol table name list from an executable file

LIBRARY

Lb libbsd

SYNOPSIS

In nlist.h (See libbsd(7) for include usage.) Ft int Fn nlist const char *filename struct nlist *nl

DESCRIPTION

The Fn nlist function retrieves name list entries from the symbol table of an executable file (see a.out5). The argument Fa 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 Fa n_type and Fa n_value for the entry are copied into the list referenced by Fa 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 Fa filename does not exist or is not executable, the returned value is -1.

SEE ALSO

a.out5

HISTORY

A Fn nlist function appeared in AT&T System v6 .