Epson S5U1C17001C, Manual

Page: 368 / 742

6-2
EPSOn
S5U1C17001C ManUal
(C COMPilEr PaCkagE fOr S1C17 faMily) (Ver. 1.5.0)
6 C COMPilEr
Object file
File format: Binary file
File name:
<filename>
.o
Description: A relocatable object file to be input to the ld linker. This file is generated when the
-c
option is
specified.
note : The xgcc C compiler generates an elf format executable object file or preprocessed source file
according to the option specified.
6.3 Starting Method
6.3.1 Startup format
To invoke the xgcc C compiler, use the command shown below.
xgcc
<options> <filename>
<options> See Section 6.3.2.
<filename> Specify C source file name(s) including the extension (
.c
).
6.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. The basic make file generated by the
IDE
specifies this option when invoking the
xgcc
C
compiler. 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
Function:
Execute C preprocessor only
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.