Table of Contents
Advertisement
8.3 Starting Method
8.3.1 Startup format
To invoke the as assembler, use the command shown below.
as <options> <filename>
<options>
See Section 8.3.2.
Specify assembly source file name(s) including the extension (.s).
<filename>
8.3.2 Command-line Options
The as assembler accepts the gnu assembler standard options. The following lists the principal options only. Refer
to the gnu assembler manual for more information.
-o<filename>
Specify output file name
Function:
Description: This option is used to specify the name of the object file output by the as assembler.
The <filename> must be the same as the input file and input immediately after -o.
Default:
The default output file name is a.out.
-a[<sub-option>]
Output assembly list file
Function:
Description: Outputs an assembly list file. The <sub-option> controls the output contents.
Example: -adhl
Default:
No assembly list file is output.
--gstabs
Function:
Add debugging information with relative path to source files
Description: This option is used to creates an output file containing debugging information.
The source file location information is output as a relative path.
Default:
No debugging information is output.
In addition to the standard options, the following S1C17 option is available:
-mpointer16
Specify 16-bit pointer mode
Function:
Description: This option is used to generate object files for the 16-bit pointer mode (64KB memory model).
This option just sets a flag to indicate that the 16-bit pointer mode is specified and it does not af-
This option just sets a flag to indicate that the 16-bit pointer mode is specified and it does not af-
fect the object code that will be generated.
Default:
The assembler generates object files for the 24-bit pointer mode (16MB or 1MB memory model).
-mc17_ext <dump file name> <link map file name>
Optimize extended instructions
Function:
Description: This option is used to remove unnecessary ext instructions, which were inserted when s*/x*
extended instructions were expanded by the assembler in the first pass, according to the actual
distance to each symbol that has been determined during linkage process. Perform until linkage
process in the first pass and specify this assembler option in the second pass. For more information
on the extended instruction and optimization, refer to Sections 8.6 and 8.7.
Default:
The assembler does not optimizes extended instructions.
When entering options in the command line, you need to place one or more spaces before and after the option.
Example: as -otest.o -adhl test.s
S5U1C17001C ManUal
(C COMPilEr PaCkagE fOr S1C17 faMily) (Ver. 1.5.0)
Requests high-level assembly listing without debugging directives.
EPSOn
8 aSSEMBlEr
8
Assemblr
8-3
Advertisement
Table of Contents
