NAME

cref − make cross-reference listing

SYNOPSIS

cref [ −acilnostux123 ] files

DESCRIPTION

Cref makes a cross-reference listing of assembler or C programs; files are searched for symbols in the appropriate syntax. 

The output report is in four columns:

1.  symbol;

2.  file name;

3.  see below;

4.  text as it appears in the file. 

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 will appear in column 1.  Only one of these options may be given; the default setting is −i using the default ignore file (see FILES below).  Assembler pre-defined 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 file (instead of the temporary file /tmp/crt??). This file is created and is not removed at the end of the process. 

The cref options are:

a assembler format (default)

c C format input

i use an ignore file (see above)

l put line number in column 3 (instead of current symbol)

n omit column 4 (no context)

o use an only file (see above)

s current symbol in column 3 (default)

t user-supplied temporary file

u print only symbols that occur exactly once

x print only C external symbols

1 sort output on column 1 (default)

2 sort output on column 2

3 sort output on column 3. 

FILES

/tmp/crt??  temporaries

/usr/lib/cref/aign default assembler ignore file

/usr/lib/cref/atab grammar table for assembler files

/usr/lib/cref/cign default C ignore file

/usr/lib/cref/ctab grammar table for C files

/usr/lib/cref/crpost
post-processor

/usr/lib/cref/upost post-processor for −u option

SEE ALSO

as(1), cc(1), sort(1), xref(1). 

BUGS

Cref inserts an ASCII DEL character into the intermediate file after the eighth character of each name that is eight or more characters long in the source file. 

May 16, 1980