CREF(I) 2/5/73 CREF(I)
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)
symbol file see text 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:
a assembler format (default)
c C format input
i use ignore file (see above)
l put line number in col. 3 (instead of current symbol)
o use only file (see above)
s current symbol in col. 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/aign default assembler ignore file
/usr/lib/cign default C ignore file
/usr/bin/crpost post processor
/usr/bin/upost post processor for -u option
/bin/sort used to sort temporaries
SEE ALSO
as (I), cc (I)
BUGS