rcxref(CP)                     6 January 1993                     rcxref(CP)


 Name

    rcxref - generate C program cross-reference

 Syntax

    rcxref [ options ] files

 Description

    The rcxref command analyzes a collection of C files and attempts to build
    a cross-reference table.  The rcxref command 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 sym-
    bol contains an asterisk (*) before the declaring reference.

    In addition to the -D, -I, and -U options (which are interpreted just as
    they are by rcc(CP) and cpp(CP.)

    The following options are interpreted by rcxref:

    -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 will default to 80 if <num> is not specified or
        is less than 51.

    -Dname=def
        Define name with value def as if by a #define.  If no =def is given,
        name is defined with value 1.

    -o file
        Direct output to file.

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

    -t  Format listing for 80-column width.

 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.

 Notes

    The rcxref command considers a formal argument in a #define macro defini-
    tion to be a declaration of that symbol.  For example, a program that
    #includes ctype.h, will contain many declarations of the variable c.

 See also

    rcc(CP), cpp(CP)

 Standards conformance

    rcxref is conformant with:
    AT&T SVID Issue 2;
    and X/Open Portability Guide, Issue 3, 1989.