Next: 3.2.9 Intermediate Dump Options
Up: 3.2 Command Line Options
Previous: 3.2.7 Optimization Options
Contents
Index
3.2.8 Other Options
- [-c --compile-only]will
compile and assemble the source, but will not call the linkage editor.
- [--c1mode]reads the preprocessed
source from standard input and compiles it. The file name for the
assembler output must be specified using the -o option.
- [-E]Run only the C preprocessor. Preprocess all
the C source files specified and output the results to standard output.
- [-o <path/file>]The output path
resp. file where everything will be placed. If the parameter is a
path, it must have a trailing slash (or backslash for the Windows
binaries) to be recognized as a path.
- [--stack-auto]All functions in
the source file will be compiled as reentrant,
i.e. the parameters and local variables will be allocated on the stack.
see section Parameters and Local Variables for more details. If this
option is used all source files in the project should be compiled
with this option.
- [--callee-saves]function1[,function2][,function3]....
The compiler by default uses a caller saves convention for register
saving across function calls, however this can cause unnecessary register
pushing & popping when calling small functions from larger functions.
This option can be used to switch the register saving convention for
the function names specified. The compiler will not save registers
when calling these functions, no extra code will be generated at the
entry & exit (function prologue
& epilogue) for these functions
to save & restore the registers used by these functions, this can
SUBSTANTIALLY reduce code & improve run time performance of the generated
code. In the future the compiler (with inter procedural analysis)
will be able to determine the appropriate scheme to use for each function
call. DO NOT use this option for built-in functions such as _mulint...,
if this option is used for a library function the appropriate library
function needs to be recompiled with the same option. If the project
consists of multiple source files then all the source file should
be compiled with the same --callee-saves option string. Also see
#pragma callee_saves.
- [--debug]When this option is used the
compiler will generate debug information. The debug information collected
in a file with .cdb extension can be used with the SDCDB. For more
information see documentation for SDCDB. Another file with no extension
contains debug information in AOMF or AOMF51
format which is commonly used by third party tools.
- [-S]Stop after the stage of compilation proper;
do not assemble. The output is an assembler code file for the input
file specified.
- [--int-long-reent]Integer
(16 bit) and long (32 bit) libraries have been compiled as reentrant.
Note by default these libraries are compiled as non-reentrant. See
section Installation for more details.
- [--cyclomatic]This option will
cause the compiler to generate an information message for each function
in the source file. The message contains some important information
about the function. The number of edges and nodes the compiler detected
in the control flow graph of the function, and most importantly the
cyclomatic complexity see section
on Cyclomatic Complexity for more details.
- [--float-reent]Floating point
library is compiled as reentrant. See section Installation
for more details.
- [--main-return]This option can
be used when the code generated is called by a monitor program. The
compiler will generate a 'ret' upon return from the 'main'
function. The default setting is to lock up i.e. generate a 'sjmp
.'.
- [--nostdincl]This will prevent
the compiler from passing on the default include path to the preprocessor.
- [--nostdlib]This will prevent the
compiler from passing on the default library path
to the linker.
- [--verbose]Shows the various actions
the compiler is performing.
- [-V]Shows the actual commands the compiler is
executing.
- [--no-c-code-in-asm]Hides
your ugly and inefficient c-code from the asm file, so you can always
blame the compiler :).
- [--i-code-in-asm]Include i-codes
in the asm file. Sounds like noise but is most helpful for debugging
the compiler itself.
- [--less-pedantic]Disable some
of the more pedantic warnings (jwk burps: please
be more specific here, please!). If you want rather more than less
warnings you should consider using a separate tool dedicated to syntax
checking like splint www.splint.org.
- [--print-search-dirs]Display
the directories in the compiler's search path
- [--vc]Display errors and warnings using
MSVC style, so you can use SDCC with visual studio.
- [--use-stdout]Send errors and
warnings to stdout instead of stderr.
- [-Wa asmOption[,asmOption]...]Pass
the asmOption to the assembler.
See file sdcc/as/doc/asxhtm.html for assembler options.
Next: 3.2.9 Intermediate Dump Options
Up: 3.2 Command Line Options
Previous: 3.2.7 Optimization Options
Contents
Index
Bernhard Held
2004-02-21