[ Previous | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 1

cxref Command

Purpose

Creates a C and C++ program cross-reference listing.

Syntax

cxref-c ] [ -o File ] [ -qOption ] [ -s ] [ -t ] [ -w Number ] [ [ -D Name =Definition ] ] [ -I Directory ] [ -U Name ] ] ... [ -NdNumber ] [ -NlNumber ] [ -NnNumber ] [ -NtNumber ] File ...

Description

The cxref command analyzes C and C++ program Files and creates a cross-reference table, using the cpp command to include #define directives in its symbol table. It writes to standard output a listing of all symbols in each file processed, either separately or in combination (see the -c flag). The formal parameters in a function definition are always listed; but if a function is only prototyped and not defined, the parameters are not listed. When a reference to a symbol is that symbol's declaration, an * (asterisk) precedes it.

Flags

-c Displays a combined listing of the cross-references in all input files.
-o File Directs the output to the specified File.
-s Does not display the input file names.
-t Makes the listing 80 columns wide.
-w Number Makes the listing Number columns wide, where Number is a decimal integer greater than or equal to 51. If Number is less than 51, the listing will be 80 columns wide.
-NdNumber Changes the dimension table size to Number. The default is 2000.
-NlNumber Changes the number of type nodes to Number. The default is 8000.
-NnNumber Changes the symbol table size to Number. The default is 1500.
-NtNumber Changes the number of tree nodes to Number. The default is 1000.

In addition, the cxref command recognizes the following flags of the cpp command (macro preprocessor):

-D Name[=Definition] Defines Name as in a #define directive. The default definition is 1.
-I Directory Looks first in directory, then looks in the directories on the standard list for #include files with names that do not begin with a slash (/) (see the cpp command).
-U Name Removes any initial definition of Name, where Name is a reserved symbol predefined by the preprocessor.
-qOption Pass -qOption to the preprocessor. For example, -qmbcs sets multibyte mode specified by the current locale, and -qidirfirst modifies the search order for files included with the #include file_name directive.

Examples

To provide a combined cross-reference listing of stdin1.c and stdin2.c , making the output 80 columns wide, enter:

cxref -c -t stdin1.c stdin2.c > output

Files

/usr/ccs/lib/xpass Special version of C compiler first-pass.
/usr/ccs/bin/cxref Contains the cxref command.

Related Information

The cc command, cpp command.


[ Previous | Contents | Glossary | Home | Search ]