NAME

cxref − generate C program cross-reference

SYNOPSIS

cxref [ options ] files

DESCRIPTION

Cxref analyzes a collection of C files and attempts to build a cross-reference table.  Cxref utilizes a special version of cpp to include #define’d information in its symbol table.  It produces a listing on standard output of all symbols (auto, static, and global) in each file separately, or with the −c option, in combination.  Each symbol contains an asterisk (∗) before the declaring reference. 

In addition to the −D, −I and −U options (which are identical to their interpretation by cc(1)), the following options are interpreted by cxref:

−c Print a combined cross-reference of all input files. 

−w<num> Width option, which formats output no wider than <num> (decimal) columns.  This option defaults to 80 if <num> is not specified or is less than 51. 

−o file Direct output to the named file. 

−s Operate silently; does not print input file names. 

−t Format listing for 80-column width. 

DIAGNOSTICS

Error messages are unusually cryptic, but usually mean that you cannot compile these files, anyway. 

EXAMPLES

The command:

cxref -c orange.c blue.c color.h

creates a combined cross-reference of the files orange.c, blue.c, and color.h. 

The command:

cxref -c -o rainbow.x orange.c blue.c

creates a combined cross-reference of the files orange.c, blue.c, and color.h, and directs the output to the file rainbow.x. 

WARNINGS

Cxref considers a formal argument in a #define macro definition to be a declaration of that symbol.  For example, a program that #includes ctype.h will contain many declarations of the variable c. 

DEPENDENCIES

Series 300
Cxref uses a special version of the C compiler front end.  The size of the internal compiler tables can be adjusted by using the -Wc and -N options, as described in the manual page for cc(1). 

FILES

/usr/lib/xcpp special version of C-preprocessor. 

/usr/lib/xpass special version of C compiler front end. 

SEE ALSO

cc(1). 

INTERNATIONAL SUPPORT

8- and 16-bit data, 8-bit filenames. 

Hewlett-Packard Company  —  May 11, 2021