131 lines
8.1 KiB
HTML
131 lines
8.1 KiB
HTML
|
<html lang="en">
|
||
|
|
<head>
|
||
|
|
<title>RX-Opts - Using as</title>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html">
|
||
|
|
<meta name="description" content="Using as">
|
||
|
|
<meta name="generator" content="makeinfo 4.13">
|
||
|
|
<link title="Top" rel="start" href="index.html#Top">
|
||
|
|
<link rel="up" href="RX_002dDependent.html#RX_002dDependent" title="RX-Dependent">
|
||
|
|
<link rel="next" href="RX_002dModifiers.html#RX_002dModifiers" title="RX-Modifiers">
|
||
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
||
|
|
<!--
|
||
|
|
This file documents the GNU Assembler "as".
|
||
|
|
|
||
|
|
Copyright (C) 1991-2019 Free Software Foundation, Inc.
|
||
|
|
|
||
|
|
Permission is granted to copy, distribute and/or modify this document
|
||
|
|
under the terms of the GNU Free Documentation License, Version 1.3
|
||
|
|
or any later version published by the Free Software Foundation;
|
||
|
|
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||
|
|
Back-Cover Texts. A copy of the license is included in the
|
||
|
|
section entitled ``GNU Free Documentation License''.
|
||
|
|
|
||
|
|
-->
|
||
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
||
|
|
<style type="text/css"><!--
|
||
|
|
pre.display { font-family:inherit }
|
||
|
|
pre.format { font-family:inherit }
|
||
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
||
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
||
|
|
pre.smallexample { font-size:smaller }
|
||
|
|
pre.smalllisp { font-size:smaller }
|
||
|
|
span.sc { font-variant:small-caps }
|
||
|
|
span.roman { font-family:serif; font-weight:normal; }
|
||
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
||
|
|
--></style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<div class="node">
|
||
|
|
<a name="RX-Opts"></a>
|
||
|
|
<a name="RX_002dOpts"></a>
|
||
|
|
<p>
|
||
|
|
Next: <a rel="next" accesskey="n" href="RX_002dModifiers.html#RX_002dModifiers">RX-Modifiers</a>,
|
||
|
|
Up: <a rel="up" accesskey="u" href="RX_002dDependent.html#RX_002dDependent">RX-Dependent</a>
|
||
|
|
<hr>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h4 class="subsection">9.40.1 RX Options</h4>
|
||
|
|
|
||
|
|
<p><a name="index-options_002c-RX-2015"></a><a name="index-RX-options-2016"></a>
|
||
|
|
The Renesas RX port of <code>as</code> has a few target specific
|
||
|
|
command-line options:
|
||
|
|
|
||
|
|
|
||
|
|
<a name="index-g_t_0040samp_007b_002dm32bit_002ddoubles_007d-2017"></a>
|
||
|
|
<dl><dt><code>-m32bit-doubles</code><dd>This option controls the ABI and indicates to use a 32-bit float ABI.
|
||
|
|
It has no effect on the assembled instructions, but it does influence
|
||
|
|
the behaviour of the ‘<samp><span class="samp">.double</span></samp>’ pseudo-op.
|
||
|
|
This is the default.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dm64bit_002ddoubles_007d-2018"></a><br><dt><code>-m64bit-doubles</code><dd>This option controls the ABI and indicates to use a 64-bit float ABI.
|
||
|
|
It has no effect on the assembled instructions, but it does influence
|
||
|
|
the behaviour of the ‘<samp><span class="samp">.double</span></samp>’ pseudo-op.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmbig_002dendian_007d-2019"></a><br><dt><code>-mbig-endian</code><dd>This option controls the ABI and indicates to use a big-endian data
|
||
|
|
ABI. It has no effect on the assembled instructions, but it does
|
||
|
|
influence the behaviour of the ‘<samp><span class="samp">.short</span></samp>’, ‘<samp><span class="samp">.hword</span></samp>’, ‘<samp><span class="samp">.int</span></samp>’,
|
||
|
|
‘<samp><span class="samp">.word</span></samp>’, ‘<samp><span class="samp">.long</span></samp>’, ‘<samp><span class="samp">.quad</span></samp>’ and ‘<samp><span class="samp">.octa</span></samp>’ pseudo-ops.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmlittle_002dendian_007d-2020"></a><br><dt><code>-mlittle-endian</code><dd>This option controls the ABI and indicates to use a little-endian data
|
||
|
|
ABI. It has no effect on the assembled instructions, but it does
|
||
|
|
influence the behaviour of the ‘<samp><span class="samp">.short</span></samp>’, ‘<samp><span class="samp">.hword</span></samp>’, ‘<samp><span class="samp">.int</span></samp>’,
|
||
|
|
‘<samp><span class="samp">.word</span></samp>’, ‘<samp><span class="samp">.long</span></samp>’, ‘<samp><span class="samp">.quad</span></samp>’ and ‘<samp><span class="samp">.octa</span></samp>’ pseudo-ops.
|
||
|
|
This is the default.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmuse_002dconventional_002dsection_002dnames_007d-2021"></a><br><dt><code>-muse-conventional-section-names</code><dd>This option controls the default names given to the code (.text),
|
||
|
|
initialised data (.data) and uninitialised data sections (.bss).
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmuse_002drenesas_002dsection_002dnames_007d-2022"></a><br><dt><code>-muse-renesas-section-names</code><dd>This option controls the default names given to the code (.P),
|
||
|
|
initialised data (.D_1) and uninitialised data sections (.B_1).
|
||
|
|
This is the default.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmsmall_002ddata_002dlimit_007d-2023"></a><br><dt><code>-msmall-data-limit</code><dd>This option tells the assembler that the small data limit feature of
|
||
|
|
the RX port of GCC is being used. This results in the assembler
|
||
|
|
generating an undefined reference to a symbol called <code>__gp</code> for
|
||
|
|
use by the relocations that are needed to support the small data limit
|
||
|
|
feature. This option is not enabled by default as it would otherwise
|
||
|
|
pollute the symbol table.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmpid_007d-2024"></a><br><dt><code>-mpid</code><dd>This option tells the assembler that the position independent data of the
|
||
|
|
RX port of GCC is being used. This results in the assembler
|
||
|
|
generating an undefined reference to a symbol called <code>__pid_base</code>,
|
||
|
|
and also setting the RX_PID flag bit in the e_flags field of the ELF
|
||
|
|
header of the object file.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmint_002dregister_007d-2025"></a><br><dt><code>-mint-register=</code><var>num</var><dd>This option tells the assembler how many registers have been reserved
|
||
|
|
for use by interrupt handlers. This is needed in order to compute the
|
||
|
|
correct values for the <code>%gpreg</code> and <code>%pidreg</code> meta registers.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmgcc_002dabi_007d-2026"></a><br><dt><code>-mgcc-abi</code><dd>This option tells the assembler that the old GCC ABI is being used by
|
||
|
|
the assembled code. With this version of the ABI function arguments
|
||
|
|
that are passed on the stack are aligned to a 32-bit boundary.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmrx_002dabi_007d-2027"></a><br><dt><code>-mrx-abi</code><dd>This option tells the assembler that the official RX ABI is being used
|
||
|
|
by the assembled code. With this version of the ABI function
|
||
|
|
arguments that are passed on the stack are aligned to their natural
|
||
|
|
alignments. This option is the default.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmcpu_003d_007d-2028"></a><br><dt><code>-mcpu=</code><var>name</var><dd>This option tells the assembler the target CPU type. Currently the
|
||
|
|
<code>rx100</code>, <code>rx200</code>, <code>rx600</code>, <code>rx610</code>, <code>rxv2</code>,
|
||
|
|
<code>rxv3</code> and <code>rxv3-dfpu</code> are recognised as valid cpu names.
|
||
|
|
Attempting to assemble an instructionnot supported by the indicated
|
||
|
|
cpu type will result in an error message being generated.
|
||
|
|
|
||
|
|
<p><a name="index-g_t_0040samp_007b_002dmno_002dallow_002dstring_002dinsns_007d-2029"></a><br><dt><code>-mno-allow-string-insns</code><dd>This option tells the assembler to mark the object file that it is
|
||
|
|
building as one that does not use the string instructions
|
||
|
|
<code>SMOVF</code>, <code>SCMPU</code>, <code>SMOVB</code>, <code>SMOVU</code>, <code>SUNTIL</code>
|
||
|
|
<code>SWHILE</code> or the <code>RMPA</code> instruction. In addition the mark
|
||
|
|
tells the linker to complain if an attempt is made to link the binary
|
||
|
|
with another one that does use any of these instructions.
|
||
|
|
|
||
|
|
<p>Note - the inverse of this option, <code>-mallow-string-insns</code>, is
|
||
|
|
not needed. The assembler automatically detects the use of the
|
||
|
|
the instructions in the source code and labels the resulting
|
||
|
|
object file appropriately. If no string instructions are detected
|
||
|
|
then the object file is labelled as being one that can be linked with
|
||
|
|
either string-using or string-banned object files.
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
</body></html>
|
||
|
|
|