cxref(1) — Dell System V Release 4 Issue 2.2



cxref(1)                         UNIX System V                         cxref(1)


NAME
      cxref - generate C program cross-reference

SYNOPSIS
      cxref [options] files

DESCRIPTION
      The cxref command analyzes a collection of C files and builds a cross-
      reference table.  cxref uses a special version of cc to include #define'd
      information in its symbol table.  It generates a list of all symbols
      (auto, static, and global) in each individual file, or, with the -c
      option, in combination.  The table includes four fields: NAME, FILE,
      FUNCTION, and LINE. The line numbers appearing in the LINE field also
      show reference marks as appropriate. The reference marks include:

            assignment  =
            declaration -
            definition  *


      If no reference marks appear, you can assume a general reference.

OPTIONS
      cxref interprets the -D, -I, -U options in the same manner that cc does.
      In addition, cxref interprets the following options:

      -c      Combine the source files into a single report.  Without the -c
              option, cxref generates a separate report for each file on the
              command line.

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

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

      -o file Direct output to file.

      -s      Operates silently; does not print input file names.

      -t      Format listing for 80-column width.

      -wnum   Width option that formats output no wider than num (decimal)
              columns.  This option will default to 80 if num is not specified
              or is less than 51.

      -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
              or lint.

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




10/89                                                                    Page 1



cxref(1)                         UNIX System V                         cxref(1)


      -Lcols  Modifies the number of columns in the LINE field. If you do not
              specify a number, cxref defaults to five columns.

      -V      Prints version information on the standard error.


















































Page 2                                                                    10/89



cxref(1)                         UNIX System V                         cxref(1)


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

                    Field          Characters

                    NAME              15
                    FILE              13
                    FUNCTION          15
                    LINE              20 (4 per column)

FILES
      TMPDIR/tcx.*        temporary files

      TMPDIR/cx.*         temporary files

      LIBDIR/xref         accessed by cxref

      LIBDIR              usually /usr/ccs/lib

      TMPDIR              usually /var/tmp but can be redefined by setting the
                          environment variable TMPDIR [see tempnam in
                          tmpnam(3S)].

EXAMPLE
      a.c

      1     main()
      2     {
      3           int i;
      4           extern char c;
      5
      6           i=65;
      7           c=(char)i;
      8     }


      Resulting cross-reference table:

      NAME   FILE         FUNCTION   LINE
      c      a.c          ---        4-     7=
      i      a.c          main       3*     6=   7
      main   a.c          ---        2*
      u3b2   predefined   ---        0*
      unix   predefined   ---        0*

SEE ALSO
      cc(1), lint(1)

DIAGNOSTICS
      Error messages usually mean you cannot compile the files.



10/89                                                                    Page 3

Museum

Related Articles