XLIST(S) XENIX System V XLIST(S)
Name
xlist, fxlist - Gets name list entries from files.
Syntax
#include <a.out.h>
int xlist(filename, xl)
char *filename;
struct xlist xl[ ];
#include <a.out.h>
#include <stdio.h>
int fxlist(fp, xl)
FILE *fp;
struct xlist xl[ ];
Description
fxlist performs the same function as xlist, except that
fxlist accepts a pointer to a previously opened file intead
of a filename.
xlist examines the name list in the given executable output
file and selectively extracts a list of values. The name
list structure xl consists of an array of xlist structures
containing names, types, values, and segment values (if
applicable). The list is terminated by either a pointer to a
null name or a null pointer. 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 into the next two fields. The
segment value (if it exists) is inserted in the third field.
If the name is not found, both entries are set to zero. See
a.out(F) for a discussion of the xlist structure.
x.out and a.out formats are understood, as well as 8086
relocatable and x.out segmented formats.
If the symbol table is in a.out format, and if the symbol
name given to xlist is longer than eight characters, only
the first eight characters are used for comparison. In all
other cases, the name given to xlist must be the same length
as a name list entry in order to match.
If two or more symbols happen to match the name given to
xlist, then the type and value used will be those of the
last symbol found.
See Also
a.out(F)
Diagnostics
xlist returns -1 and sets all type entries to zero if the
file cannot be read, is not an object file, or contains an
Page 1 (printed 8/7/87)
XLIST(S) XENIX System V XLIST(S)
invalid name list. Otherwise, xlist returns zero. A return
value of zero does not indicate that any or all of the given
symbols were found.
Page 2 (printed 8/7/87)