Shell Control Options
SC100 C Compiler
3-23
3.3.7 Setting the Options for Listings and Messages
The options in this section enable you to control the retention, display and printing of diagnostic and
informational messages, and the generation of various listing and map files.
3.3.7.1 Generating listing files
By default the shell program does not retain the diagnostic and cross-reference information produced at
different processing stages. You can select to retain one or more different types of information in listing
files.
Use any combination of the following options to generate listing files containing the types of information
you require. Each individual option can only be specified once in a shell command line.
-de
[file]
The Front End creates a file containing all error messages generated during the
compilation. The
-de
option retains this error file. If this option is not specified, the
errors are displayed during processing, but not kept. If no file name is specified, a file is
created with the same name as the source file, and the extension
.err
.
-dm
[file]
Generates a link map file listing all the specific variables, applications and addresses
used by the linker. If no file name is specified, a file is created with the same name as the
executable, and the extension
.map
.
-do
Includes the details of C data structures in the output assembly file, showing the offsets
for all field definitions in each data structure. Refer to
Chapter 4,
“
Interfacing C and
Assembly Code,
”
for a detailed description of the C/assembler interface.
-dL
[file]
Generates a C list file, listing the entire contents of the source file. If no file name is
specified, a file is created with the same name as the source file, and the extension
.lis
.
-dL1
[file]
Generates a C list file, listing the entire contents of the source file, with the addition of a
list of
#include
files used by the source. If no file name is specified, a file is created
with the same name as the source file, and the extension
.lis
.
-dL2
[file]
Generates a C list file, listing the entire contents of the source file, with the addition of
expansions, such as macro expansions, line splices and trigraphs. If no file name is
specified, a file is created with the same name as the source file, and the extension
.lis
.
-dL3
[file]
Generates a C list file, listing the entire contents of the source file, with the addition of a
list of
#include
files, and expansions, such as macro expansions, line splices and
trigraphs. If no file name is specified, a file is created with the same name as the source
file, and the extension
.lis
.
-dx
[file]
Generates a cross-reference information file, providing details of cross-references in the
source file. If no file name is specified, a file is created with the same name as the source
file, and the extension
.xrf
.
-dc [0-4]
Generates a file showing calls in graphical tree form, which can be printed using a
postscript printer. Specify the size of the paper to be used for the printout: 0 for paper
size A0, 1 for A1, and so on.