NAME

cxref − generate C program cross-reference

SYNOPSIS

cxref [ options ] files

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: System V

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, −U, and −Y 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. 

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

HARDWARE DEPENDENCIES

Series 200:

cxref utilizes 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). 

DIAGNOSTICS

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

BUGS

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.  Since cxref operates by running special versions of the C preprocessor and the C compiler front end, if a file cannot be compiled, it cannot be processed by cxref. 

Hewlett-Packard  —  last mod. May 11, 2021