cxref(1)cxref(1)NAMEcxref - Creates a C program cross-reference listing
SYNOPSIScxref [-cFlstV] [-o file] [-w [number] | [-L cols] ] [-D name[=def]]...
[-I dir]... [-U name]... [-Ndnumber] [-Nlnumber] [-Nnnumber] [-Ntnum‐
ber] file...
The token -- (double-dash) is accepted as a delimiter indicating the
end of options. Any following arguments are treated as operands, even
if they begin with the - character.
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
cxref: XCU5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
The following options are included in XCU5.0: Displays a combined list‐
ing of the cross-references in all input files. Defines name, as if by
a C-language #define directive. If no =def is given, a value of 1 is
used. Adds the directory specified by dir to the list of directories
in which the lint program searches for #include files. Directs the
output to the specified file. Does not display the input filenames.
Removes any initial definition of name, where name is a reserved symbol
that is predefined by the particular preprocessor. Formats the output
no wider than number (decimal) columns. This option defaults to 80 if
number is unspecified or is less than 51.
The following options are not included in XCU5.0. They are included in
a System V specification or are proprietary. [Tru64 UNIX] Prints the
full path of the referenced file names. By default, only the last com‐
ponent of the full path is printed. [Tru64 UNIX] Specifies the maxi‐
mum number of columns that can be printed in the LINE field to the cols
argument. The default is five columns for this field. [Tru64
UNIX] Suppresses printing of local variables. Only global variables
and file scope statistics are printed. [Tru64 UNIX] Changes the
dimension table size to number. The default is 2000. [Tru64
UNIX] Changes the number of type nodes to number. The default is
8000. [Tru64 UNIX] Changes the symbol table size to number. The
default is 1500. [Tru64 UNIX] Changes the number of tree nodes to
number. The default is 1000. [Tru64 UNIX] Makes the listing 80 bytes
wide. [SVID3] Prints the version number information for the cxref
command to standard error.
DESCRIPTION
The cxref command analyzes C program files and creates a cross-refer‐
ence table, using a version of the cpp macro preprocessor to include
#define directives in its symbol table.
The cxref command writes to standard output a listing of all symbols in
each file processed, either separately or in combination (see the -c
option).
[Tru64 UNIX] Function prototypes are handled in a special way: for an
old-style function declaration, the function prototype name is listed,
but the optional prototype identifiers are not. The formal parameters
in a function definition are always listed, whether or not the proto‐
type is an old-style function definition. When a reference to a symbol
is that symbol's declaration, an asterisk (*) precedes it.
EXAMPLES
To provide a combined cross-reference listing of stdin1.c and stdin2.c,
making the output 60 columns wide, enter: cxref-c-w 60 stdin1.c
stdin2.c > output
ENVIRONMENT VARIABLES
The following environment variables affect the behavior of cxref: Pro‐
vides a default value for the locale category variables that are not
set or null. If set, overrides the values of all other locale vari‐
ables. Determines the order in which output is sorted for the -x
option. Determines the locale for the interpretation of byte sequences
as characters (single-byte or multibyte) in input parameters and files.
Determines the locale used to affect the format and contents of diag‐
nostic messages displayed by the command. Determines the location of
message catalogs for processing of LC_MESSAGES.
FILES
Special version of C preprocessor.
SEE ALSO
Commands: cc(1), c89(1)
Standards: standards(5)cxref(1)