CXREF(1)                  USER COMMANDS                  CXREF(1)


NAME
     cxref --  generate C program cross-reference


SYNOPSIS
     cxref [ options ] files


DESCRIPTION
     The  cxref  command  analyzes  a  collection  of C files and
     attempts to build a cross-reference table.   cxref  includes
     #defined  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 symbol contains an asterisk (*) before the
     declaring reference.

     If  a  -hkr option is not specified, cxref processes supple-
     mentary code set according to the locale  specified  in  the
     LC_CTYPE environment variable[see LANG on environ(5)].
     options  accepts the following options.  In addition to them
     -D, -I, and -U options (which are interpreted just  as  they
     are by cc(1)).


     -hsuboptions
               Accepts  suboptions like cc(1) does. Multiple sub-
               options must be separated by a comma.  If  contra-
               dictory  suboptions  are specified, the latest one
               is effective.
               The following suboptions are available.

               ansi / kr
                         ansi(default value) sets object as  ANSI
                         C program.
                         kr sets object as K&R C program.
                         The  suboption kr cannot be specified on
                         SX-5.

               If -hansi(default value) option is specified,  the
               following suboptions can be specified.

               float0 / float1 / float2[,int64]
                         Specifies   floating   point  type.  The
                         default value is float0.  If  the  envi-
                         ronment  variable  FLMOD is defined, its
                         value is used as default.  The suboption
                         float1, float2 or int64 cannot be speci-
                         fied on SX-5.



     -c   Print a combined cross-reference of all input files.




SUPER-UX            Last change: Nov 16, 1998                   1





CXREF(1)                  USER COMMANDS                  CXREF(1)


     -wnum
          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.


     -o file
          Direct output to file.


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


     -t   Format listing for 80-column width.


     The following cannot be specified when -hkr option is speci-
     fied.


     -d   Disables  printing  declarations,   making  the  report
          easier to read.


     -C   Runs only the first pass of cxref, creating a .cx  file
          that  can later be passed to cxref.  This is similar to
          the -c option of cc(1) or lint(1).


     -F   Prints the full path of the referenced file names.


     -l   Does not print local variables;  prints   only   global
          and file scope statistics.


     -Lcols
          Modifies  the  number  of table  columns  in  the  LINE
          field.  If cols is not  specified,  cxref  defaults  to
          five columns.


     -V   Print  on  standard error output the  version  of cxref
          invoked.


     -Wname,file,function,line
          Changes the default width of at least  one  field.  The
          default widths are:

               Field          Default Value
               NAME                 15
               FILE                 13
               FUNCTION             15



SUPER-UX            Last change: Nov 16, 1998                   2





CXREF(1)                  USER COMMANDS                  CXREF(1)


               LINE                  4




SEE ALSO
     cc(1), cpp(1), lint(1)


DIAGNOSTICS
     Error  messages are unusually cryptic, but usually mean that
     you cannot compile these files.


NOTES
     When -hkr option is  specified,  cxref  considers  a  formal
     argument  in  a #define macro definition to be a declaration
     of that symbol.   For  example,  a  program  that  #includes
     ctype.h will contain many declarations of the variable c.






































SUPER-UX            Last change: Nov 16, 1998                   3