cxref(1)						      General Commands Manual							  cxref(1)

NAME

       cxref - Creates a C program cross-reference listing

SYNOPSIS

       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.

STANDARDS

       Interfaces documented on this reference page conform to industry standards 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 listing 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  directo-
       ries  in  which	the lint program searches for #include files.  Directs the output to the specified file.  Does not display the input file-
       names.  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 component of the full path is printed.  [Tru64 UNIX]  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.  [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-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).

       [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 prototype 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: 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 loca-
       tion 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)