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. 

OPTIONS

cxref interprets the -D, -I, -U options in the same manner that cc does.  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. 

−wnum 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.  Note that num specifies number of columns, not bytes. 

−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. 

−Lcols Modifies the number of 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   Characters
 NAME    15
FILE13
FUNCTION15
LINE20 (4 per 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)]. 

EXAMPLE

a.c
 1main()
2{
3int i;
4extern char c;
5
6i=65;
7 c=(char)i;
8} 
Resulting cross-reference table:

INTERNATIONAL FUNCTIONS

Characters from supplementary code sets can be used in input C source files. 

SEE ALSO

cc(1), lint(1)

DIAGNOSTICS

Error messages usually mean you cannot compile the files.