man(1) Manual page archive


NAME
     cref  -  make cross reference listing

SYNOPSIS
     cref [ -acilostux123 ] name ...

DESCRIPTION
     Cref makes a cross reference listing of program files in
     assembler or C format. The files named as arguments in the
     command line are searched for symbols in the appropriate
     syntax.

     The output report is in four columns:

     (1)     (2)     (3)     (4)
     symbol  file    see     text as it appears in file
                     below

     Cref uses either an ignore file or an only file.  If the -i
     option is given, the next argument is taken to be an ignore
     file; if the -o option is given, the next argument is taken
     to be an only file.  Ignore and only files are lists of sym-
     bols separated by new lines.  All symbols in an ignore file
     are ignored in columns (1) and (3) of the output.  If an
     only file is given, only symbols in that file appear in col-
     umn (1).  At most one of -i and -o may be used.  The default
     setting is -i.  Assembler predefined symbols or C keywords
     are ignored.

     The -s option causes current symbols to be put in column 3.
     In the assembler, the current symbol is the most recent name
     symbol; in C, the current function name.  The -l option
     causes the line number within the file to be put in column
     3.

     The -t option causes the next available argument to be used
     as the name of the intermediate temporary file (instead of
     /tmp/crt??).  The file is created and is not removed at the
     end of the process.

     Options:

       a  assembler format (default)
       c  C format input
       i  use ignore file (see above)
       l  put line number in col. 3 (instead of current symbol)
       o  use only file (see above)
       s  current symbol in col. 3 (default)
       t  user supplied temporary file
       u  print only symbols that occur exactly once
       x  print only C external symbols
       1  sort output on column 1 (default)
       2  sort output on column 2

 1

       3  sort output on column 3

FILES
     /tmp/crt??      temporaries
     /usr/lib/aign   default assembler ignore file
     /usr/lib/cign   default C ignore file
     /usr/bin/crpost post processor
     /usr/bin/upost  post processor for -u option
     /bin/sort       used to sort temporaries

SEE ALSO
     as (I), cc (I)

BUGS

 2