Compiler Option Flags

+Compiler Option Flags + +The compiler recognizes several command-line option flags which +modify the compilation process where needed. All flags are +recognized before compilation commences so the flags may be placed +anywhere on the command line. Flags may be ran together as in "-ro", +except where a flag is followed by something else; see "-f=" and +"-d" for examples. + + +-A +suppresses assembly, leaving the output as assembler code in a +file whose name is postfixed ".a". + + +-E=<number> +Set the edition number constant byte to the number given. This is +an OS-9 convention for memory modules. + + +-O +inhibits the assembly code optimizer pass. The optimizer will +shorten object code by about 11% with a comparable increase in speed +and is recommended for production versions of de-bugged programs. + + +-P +invokes the profiler to generate function frequency +statistics after program execution. + + +-R +suppresses linking library modules into an executable program. +Outputs are left in files with postfixes ".r". + + +-M=<memory size> +will instruct the linker to allocate <memory size> +for data, stack, and parameter area. Memory size may be expressed +in pages (an integer) or in kilobytes by appending "k" to an +integer. For more details of the use of this option, see the +"Memory Management" section of this manual. + + +-L=<filename> +specifies a library to be searched by the linker +before the Standard Library and system interface. + + +-F=<path> +overrides the above output file naming. The output file +will be left with <filename> as its name. This flag does not make +sense in multiple source mode, and either the -a or -r flag is also +present. The module will be called the last name in <path>. + + +-C +will output the source code as comments with the assembler code. + + +-S +stops the generation of stack-checking code. -S should only be +used with great care when the appication is extremely time-critical +and when the use of the stack by compiler generated code is fully +understood. + + +-D<identifier> +is equivalent to "#define <identifier>" written in +the source file. -D is useful where different versions of a program +are maintained in one source file and differentiated by means of the +"#ifdef" of "#ifndef" pre-processor directives. If the <identifier> +is used as a macro for expansion by the pre-processor, "1"(one) will +be the expanded "value" unless the form "-d<identifier>=<string>" is +used in which case the expansion will be <string>. + + +Command Line and Option Flag Examples + + + + + + + command line + action + output file(s) + + + + + cc prg.c + compile to an executable program + prg + + + + cc prg.c -a + compile to assembly language source code + prg.a + + + cc prg.c -r + compile to relocatable module + prg.r + + + cc prg1.c prg2.c prg3.c + compile to executable program + prg1.r, prg2.r, prg3.r, output + + + cc prg1.c prg2.a prg3.r + compile prg1.c, assemble prg2.a and combine all into +and executable program + prg1.r, prg2.r + + + cc prg1.c prg2.c -a + compile to assembly language source code + prg1.a, prg2.a + + + cc prg1.c prg2.c -f=prg + compile to executable program + prg + + + +