cxref(1) cxref(1)
NAME
cxref - generate C program cross-reference
SYNOPSIS
cxref [options] files
DESCRIPTION
The cxref command analyzes a collection of C files and builds
a cross-reference table. cxref uses a special version of cc
to include #define'd information in its symbol table. It
generates a list of all symbols (auto, static, and global) in
each individual file, or, with the -c option, in combination.
The table includes four fields: NAME, FILE, FUNCTION, and
LINE. The line numbers appearing in the LINE field also show
reference marks as appropriate. The reference marks include:
assignment =
declaration -
definition *
If no reference marks appear, you can assume a general
reference.
cxref processes supplementary code set characters according to
the locale specified in the LC_CTYPE environment variable [see
LANG on environ(5)].
The -D, -I, and -U options are interpreted as by cc. In
addition, cxref interprets the following options:
-c Combine the source files into a single report.
Without the -c option, cxref generates a separate
report for each file on the command line.
-d Disables printing declarations, making the report
easier to read.
-l Does not print local variables; prints only global
and file scope statistics.
-o file Direct output to file.
-s Operates silently; does not print input file names.
-t Format listing for 80-column width.
Copyright 1994 Novell, Inc. Page 1
cxref(1) cxref(1)
-w num Width option that formats output no wider than num
(decimal) columns. This option will default to 80
if num is not specified or is less than 51.
-C Runs only the first pass of cxref, creating a .cx
file that can later be passed to cxref. This is
similar to the -c option of cc or lint.
-F Prints the full path of the referenced file names.
-L cols Modifies the number of table columns in the LINE
field. If you do not specify a number, cxref
defaults to five columns.
-V Prints version information on the standard error.
-Wname, file, function, line
Changes the default width of at least one field.
The default widths are:
Field Columns
__________________________________
NAME 15
FILE 13
FUNCTION 15
LINE 20 (4 per table column)
Files
TMPDIR/tcx.* temporary files
TMPDIR/cx.* temporary files
LIBDIR/xref accessed by cxref
LIBDIR usually /usr/ccs/lib
TMPDIR usually /var/tmp but can be redefined by
setting the environment variable TMPDIR
[see tempnam in tmpnam(3S)].
EXAMPLES
a.c
1 main()
2 {
3 int i;
4 extern char c;
5
6 i=65;
7 c=(char)i;
8 }
Copyright 1994 Novell, Inc. Page 2
cxref(1) cxref(1)
Resulting cross-reference table:
NAME FILE FUNCTION LINE
c a.c --- 4- 7=
i a.c main 3* 6= 7
main a.c --- 2*
u3b2 predefined --- 0*
unix predefined --- 0*
Errors
Error messages usually mean you cannot compile the files.
REFERENCES
cc(1), lint(1)
Copyright 1994 Novell, Inc. Page 3