CXREF(1)                 DOMAIN/IX SYS5                  CXREF(1)



NAME
     cxref - generate a C program cross-reference

USAGE
     cxref [ options ] files

DESCRIPTION
     Cxref analyzes a collection of C files and attempts to build
     a cross-reference table.  It uses a special version of
     cpp(1) to include #define'd information in its symbol table.
     Cxref then prints, on standard output, a separate or com-
     bined listing of all symbols (auto, static, and global) in
     each file.  An asterisk (*) precedes the declaring reference
     for each symbol.

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

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

     -ofile         Direct output to named file.

     -s             Operate silently; do not print input
                    filenames.

     -t             Produce format listing for 80-column width.

     -Uname         Remove any initial definition of name, where
                    name is a reserved symbol predefined by the
                    particular preprocessor.  The current list of
                    these possibly reserved symbols includes:

                    operating system: ibm, gcos, os, tss, unix
                    hardware: apollo, interdata, pdp11, u370,
                    u3b, u3b5, vax
                    UNIX system variant: RES, RT
                    lint(1): lint

     -Dname
     -Dname=def     Define name as if by a #define directive.  If
                    no =def is given, define name as 1.  This
                    option has lower precedence than the -U
                    option.  That is, if the same name is used in
                    both a -U option and a -D option, the name is
                    undefined regardless of the order of the
                    options.




Printed 12/4/86                                           CXREF-1

CXREF(1)                 DOMAIN/IX SYS5                  CXREF(1)



     -Idir          Change the algorithm for searching for
                    #include files whose names do not begin with
                    / to look in dir before looking in the direc-
                    tories on the standard list.  Thus, #include
                    files whose names are enclosed in double
                    quotes (``'') are first sought in the direc-
                    tory of the file with the #include line, then
                    in directories named in -I options, and
                    finally in directories on a standard list.
                    For #include files whose names are enclosed
                    in <>, the directory of the file with the
                    #include line is not searched.
CAUTIONS
     Cxref considers a formal argument in a #define macro defini-
     tion to be a declaration of that symbol.  For example, a
     program which #includes ctype.h, contains many declarations
     of the variable c.
FILES
     /usr/lib/xcpp    special version of the C preprocessor
DIAGNOSTICS
     Error messages are unusually cryptic, but usually mean that
     you cannot compile certain files.
RELATED INFORMATION
     cc(1), cpp(1).





























CXREF-2                                           Printed 12/4/86