CREF(CP) XENIX System V CREF(CP)
Name
cref - Makes a cross-reference listing.
Syntax
cref [ -acilnostux123 ] files
Description
cref makes a cross-reference listing of assembler or C
programs. The program searches the given files for symbols
in the appropriate C or assembly language syntax.
The output report is in four columns:
1. Symbol
2. Filename
3. Current symbol or line number
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 newlines. 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 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 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 Uses assembler format (default)
c Uses C format
i Uses an ignore file (see above)
l Puts line number in column 3 (instead of current symbol)
n Omits column 4 (no context)
Page 1 (printed 8/7/87)
CREF(CP) XENIX System V CREF(CP)
o Uses an only file (see above)
s Current symbol in column 3 (default)
t User-supplied temporary file
u Prints only symbols that occur exactly once
x Prints only C external symbols
1 Sorts output on column 1 (default)
2 Sorts output on column 2
3 Sorts output on column 3
Files
/usr/lib/cref/* Assembler specific files
See Also
as(CP), cc(CP), sort(C), xref(CP)
Notes
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.
Page 2 (printed 8/7/87)