Content-type: text/html
cxref - Creates a C program cross-reference listing
cxref [-cFlstV] [-o file] [-w [number]|[-L cols] ] [-D name[=def]]... [-I dir]... [-U name]... [-Ndnumber] [-Nlnumber] [-Nnnumber] [-Ntnumber] 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.
Interfaces documented on this reference page conform to industry standards as follows:
cxref: SVID 3, XPG4, XPG4-UNIX
Refer to the
standards(5)
reference page for more information
about industry standards and associated tags.
The following options conform to both the X/Open and SVID 3 standards: Displays a combined listing of the cross-references in all input files. Does not display the input filenames. Directs the output to the specified file. Formats the output no wider than number (decimal) columns. This option defaults to 80 if number is unspecified or is less than 51. 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. Removes any initial definition of name, where name is a reserved symbol that is predefined by the particular preprocessor.
The following are additional DIGITAL and SVID 3 options:
[Compaq] Prints the full path of the referenced file names.
By default, only the last component of the full path is printed.
[Compaq] Specifies the maximum number of columns that can
be printed in the LINE field to the
cols
argument.
The default is five columns for this field.
[Compaq] Suppresses printing of local variables. Only global
variables and file scope statistics are printed.
[Compaq] Changes the dimension table size to
number. The default is 2000.
[Compaq] Changes the number of type nodes to
number. The default is 8000.
[Compaq] Changes the symbol table size to
number. The default is 1500.
[Compaq] Changes the number of tree nodes to
number. The default is 1000.
[Compaq] Makes the listing 80 bytes wide.
[SVID 3] Prints the version number information for the
cxref
command to standard error.
The cxref command analyzes C program files and creates a cross-reference 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).
[Compaq] 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 prototype is
an old-style function definition. When a reference to a symbol is that symbol's
declaration, an asterisk (*) precedes it.
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
The following environment variables affect the behavior of
cxref():
Provides a default value for the locale category variables
that are not set or null.
If set, overrides the values of all other locale variables.
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 diagnostic messages displayed by the command.
Determines the location of message catalogs for processing
of
LC_MESSAGES.
Special version of C preprocessor.
Standards: standards(5)