CREF(1)                 GENIX Programmer's Manual                 CREF(1)



      NAME
           cref - make cross-reference listing

      SYNOPSIS
           cref [ -acilnostux123 ] files

      DESCRIPTION
           Cref makes a cross-reference listing of  assembler  or  C  programs;
           files are searched for symbols in the appropriate syntax.

           The output report is in four columns:

                1.  symbol;
                2.  file name;
                3.  see below;
                4.  text as it appears in the file.

           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 symbols 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 will
           appear in column 1.  Only one of these options  may  be  given;  the
           default  setting  is  -i  using  the  default ignore file (see FILES
           below).  Assembler pre-defined 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  file  (instead  of  the  temporary file
           /tmp/crt??).  This file is created and is not removed at the end  of
           the process.

           The cref options are:

                a   assembler format (default)
                c   C format input
                i   use an ignore file (see above)
                l   put line number in column 3 (instead of current symbol)
                n   omit column 4 (no context)
                o   use an only file (see above)
                s   current symbol in column 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
                3   sort output on column 3.



      Printed 11/16/83                                                        1

      CREF(1)                 GENIX Programmer's Manual                 CREF(1)



      FILES
           /tmp/crt??     temporaries
           /usr/lib/cref/aign
                          default assembler ignore file
           /usr/lib/cref/atab
                          grammar table for assembler files
           /usr/lib/cref/cign
                          default C ignore file
           /usr/lib/cref/ctab
                          grammar table for C files
           /usr/lib/cref/crpost
                          post-processor
           /usr/lib/cref/upost
                          post-processor for -u option

      SEE ALSO
           as(1), cc(1), sort(1), xref(1).

      BUGS
           Cref inserts an ASCII DEL character into the intermediate file after
           the  eighth  character of each name that is eight or more characters
           long in the source file.  Cref only considers the first eight  char-
           acters  of  an  identifier  to  be  significant.  Only VAX or PDP-11
           assembly language is supported,  not NS16000 assembly language.































      Printed 11/16/83                                                        2