Intel XENIX 286 Programmers Guide (86) - Tenox.tc

Intel XENIX 286 Programmers Guide (86) - Tenox.tc Intel XENIX 286 Programmers Guide (86) - Tenox.tc

09.06.2013 Views

XENIX Programming Programming Commands cref - Makes a cross-reference listing. Syntax cref [ -acilnostux123 ] file ... Description cref makes a cross-reference listing of assembler or C programs. The program searches the given files for symbols in the appropriate C or assembly language syntax. The output report is in four columns: 1. Symbol 2. File name 3. Current symbol or line number 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 newlines. 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 the "Files" section later in this entry.) Assembler-predefined symbols and 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, it is the current function name. The -1 option causes the line number within the file to be put in colu mn 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. B-33

Programming Commands cref (continued) The cref options are a Uses assembler format (default) c Uses C format Uses an ignore file I Puts line number (instead of current symbol) in column 3 n Omits colu mn 4 (no context) o Uses an only file (see above) s Current symbol in column 3 (default) t User-supplied temporary file u Prints symbols that occur exactly once x Prints C-external symbols 1 Sorts output on column 1 (default) 2 Sorts output on column 2 3 Sorts output on column 3 Files /usr/lib/ cref/* Assembler-specific files See Also as, cc, xref sort in "Commands" in the XENIX 286 Reference Manual Notes XENIX Programming 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. B-34

<strong>XENIX</strong> Programming Programming Commands<br />

cref - Makes a cross-reference listing.<br />

Syntax<br />

cref [ -acilnostux123 ] file ...<br />

Description<br />

cref makes a cross-reference listing of assembler or C programs. The program searches<br />

the given files for symbols in the appropriate C or assembly language syntax.<br />

The output report is in four columns:<br />

1. Symbol<br />

2. File name<br />

3. Current symbol or line number<br />

4. Text as it appears in the file<br />

cref uses either an ignore file or an only file. If the -i option is given, the next<br />

argument is taken to be an ignore file; if the -o option is given, the next argument is<br />

taken to be an only file. ignore and only files are lists of symbols separated by newlines.<br />

All symbols in an ignore file are ignored in columns 1 and 3 of the output. If an only file<br />

is given, only symbols in that file will appear in column 1. Only one of these options<br />

may be given; the default setting is -i using the default ignore file. (See the "Files"<br />

section later in this entry.) Assembler-predefined symbols and C keywords are ignored.<br />

The -s option causes current symbols to be put in column 3. In the assembler, the<br />

current symbol is the most recent name symbol; in C, it is the current function name.<br />

The -1 option causes the line number within the file to be put in colu mn 3.<br />

The -t option causes the next available argument to be used as the name of the<br />

intermediate file (instead of the temporary file /tmp/crt??). This file is created and is<br />

not removed at the end of the process.<br />

B-33

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!