cxref(1)                                                 cxref(1)



NAME
     cxref - generates a C program cross-reference

SYNOPSIS
     cxref [-c] [-o file] [-s] [-t] [-w[num]] file...

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

     file Specifies the file from which a cross-reference is to
          be generated.

     -o file
          Directs output to named file.

     -s   Operates silently; does not print input filenames.

     -t   Formats listing for 80-column width.

     -w[num]
          Specifies the 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.

DESCRIPTION
     cxref analyzes a collection of C files and attempts to build
     a cross-reference table.  The cxref command utilizes a
     special version of cpp to include information from #define
     statements in its symbol table.  It produces a separate
     listing on standard output of all symbols (auto, static, and
     global) in each file, or with the -c option, of all symbols
     in combination.  Each symbol contains an asterisk (*) before
     the declaring reference.

     The -D, -I, and -U options are identical to the
     corresponding options in cc(1).

LIMITATIONS
     The cxref command considers a formal argument in a #define
     macro definition to be a declaration of that symbol.  For
     example, a program that contains the line

        #include <ctype.h>

     will contain many declarations of the variable c.

     When using the -o option, the space between the -o and the
     file argument is critical.  If you omit the space, as in

        cxref -otest test.c

     then the input file test.c will be destroyed.



January 1992                                                    1

cxref(1)                                                 cxref(1)



STATUS MESSAGES AND VALUES
     Error messages are unusually cryptic, but usually mean that
     you can't compile these files anyway.

FILES
     /usr/bin/cxref
          Executable file
     /usr/lib/xpass
          File that parses the input file
     /usr/lib/xcpp
          File containing a special version of C-preprocessor

SEE ALSO
     cc(1)









































2                                                    January 1992