DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

xlist(S)


xlist, fxlist -- gets name list entries from files

Syntax

#include <x.out.h>

int xlist (filename, xl) char *filename; struct xlist xl[];

#include <x.out.h>
#include <stdio.h>

int fxlist (fp, xl) FILE *fp; struct xlist xl [];

Description

xlist- gets name list entries from file

fxlist- gets name list entries from file pointer

The fxlist and xlist macros examine the name list in an OMF or COFF executable and selectively extract values.

fxlist performs the same function as xlist, except that fxlist accepts a pointer to a previously opened file instead of a filename.

xlist examines the name list in the given executable output file and selectively extracts a list of values. The given executable file can be either OMF format or COFF. 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(FP) 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 are those of the last symbol found.

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 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.

See also

a.out(FP)

Standards conformance

xlist and fxlist are not part of any currently supported standard; they are an extension of AT&T System V developed by the Santa Cruz Operation and maintained by The SCO Group.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003