NAME

cref  −  make cross reference listing

SYNOPSIS

cref [ −acilostux123 ] name ... 

DESCRIPTION

Cref makes a cross reference listing of program files in assembler or C format. The files named as arguments in the command line are searched for symbols in the appropriate syntax.  The output report is in four columns:

(1)(2)(3)(4)
symbolfileseetext as it appears in file
below

Cref uses either an ignore file or an only file.  If the −i option is given, the next argument is taken to be an ignore file; if the −o option is given, the next argument is taken to be an only file.  Ignore and only files are lists of symbols separated by new lines.  All symbols in an ignore file are ignored in columns (1) and (3) of the output.  If an only file is given, only symbols in that file appear in column (1).  At most one of −i and −o may be used.  The default setting is −i.  Assembler predefined symbols or C keywords are ignored.  The −s option causes current symbols to be put in column 3.  In the assembler, the current symbol is the most recent name symbol; in C, the current function name.  The −l option causes the line number within the file to be put in column 3.  The −t option causes the next available argument to be used as the name of the intermediate temporary file (instead of /tmp/crt??).  The file is created and is not removed at the end of the process.  Options:

aassembler format (default)

cC format input

iuse ignore file (see above)

lput line number in col. 3 (instead of current symbol)

ouse only file (see above)

scurrent symbol in col. 3 (default)

tuser supplied temporary file

uprint only symbols that occur exactly once

xprint only C external symbols

1sort output on column 1 (default)

2sort output on column 2

3sort output on column 3

FILES

/tmp/crt??temporaries
/usr/lib/aigndefault assembler ignore file
/usr/lib/cigndefault C ignore file
/usr/bin/crpostpost processor
/usr/bin/upostpost processor for −u option
/bin/sortused to sort temporaries

SEE ALSO

as (I), cc (I)

BUGS