Starting Method; Startup Format; Command-Line Options - Epson S5U1C17001C Manual

4 C Compiler
 Object file

File format: Binary file
File name:
<filename>.o
A relocatable object file to be input to the ld linker. This file is generated when the -c option is specified.
Description:
Note: The xgcc C compiler generates an elf format executable object file or preprocessed source file according
to the option specified.

4.3 Starting Method

4.3.1

Startup Format

To invoke the xgcc C compiler, use the command shown below.
xgcc <
> <
options filename
<options> See Section 4.3.2 Command-line Options.
<filename> Specify C source file name(s) including the extension (.c).
4.3.2

Command-line Options

The compiler provided in this package formally supports the command line options described below.
All other command line options lie beyond the scope of the performance guarantee, and use thereof is solely the user's
responsibility.
-c
Function: Output relocatable object file
Description: This option is used to output a relocatable object file (<input file name>.o). When this option is specified, the
xgcc C compiler stops processing after the stage of assembly has finished and does not link. Do not specify the
-S or -E option simultaneously when this option is used.
Default: The xgcc C compiler generates the elf executable object file.
-S
Function: Output assembly code
Description: This option is used to output an assembly source file (<input file name>.s). When this option is specified, the
xgcc C compiler stops processing after the stage of compilation has finished and does not assemble the compiled
code. Do not specify the -c or -E option simultaneously when this option is used.
Default: The xgcc C compiler generates the elf executable object file.
-E
Execute C preprocessor only
Function:
Description: When this option is specified, the xgcc C compiler stops processing after the stage of preprocessing has finished
and does not compile or assemble the preprocessed code. The results are output to the standard output device.
Do not specify the -S or -c option simultaneously when this option is used.
Default: The xgcc C compiler generates the elf executable object file.
-B<directory>
Function: Specify compiler search path
Description: This option is used to add the <directory> to the search paths of the xgcc C compiler.
Input <directory> immediately after -B. Multiple directories can be specified. In this case, input as many
instances of –B<directory> as necessary. The sub-programs (cpp, cc1, etc.) and other data files of the compiler
itself are searched in the order they appear in the command line.
File search is performed in order of priorities, i.e., current directory, -B option, and PATH in that order.
Default: The xgcc C compiler searches sub-programs in the current directory and the PATH directory.
4-2
>
Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)