CXREF(1)                             SysV                             CXREF(1)



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 uses 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 interpreted just as
     they are by cc(1) and cpp(1)], the following options are interpreted by
     cxref.

OPTIONS
     -c        Prints a combined cross-reference of all input files.

     -w<num>   Formats output no wider than <num> (decimal) columns.  Defaults
               to 80 if <num> is not specified or is less than 51.

     -o file   Directs output to file.

     -s        Operate silently; do not print input file names.

     -t        Lists format for 80-column width.

NOTES
     The cxref utility is supported only for Domain/C programs that compile
     with the -A nansi (/bin/cc) or -nansi (/com/cc) options, that do not use
     function prototypes or the #attribute[aligned] modifier, and that do not
     use header files (such as <stdio.h>) issued with the SR10.3 or later
     versions of Domain/OS.

FILES
     LLIBDIR       usually /usr/lib

     LLIBDIR/xcpp  special version of the C preprocessor.

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

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, contains many declarations of the variable c.

SEE ALSO
     cc(1), cpp(1).