2005-03-03 01:29:54 +00:00
|
|
|
@c Copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
|
2001-03-08 23:24:26 +00:00
|
|
|
@c Free Software Foundation, Inc.
|
1999-05-03 07:29:11 +00:00
|
|
|
@c This is part of the GAS manual.
|
|
|
|
@c For copying conditions, see the file as.texinfo.
|
|
|
|
|
|
|
|
@ifset GENERIC
|
|
|
|
@page
|
|
|
|
@node ARM-Dependent
|
|
|
|
@chapter ARM Dependent Features
|
|
|
|
@end ifset
|
|
|
|
|
|
|
|
@ifclear GENERIC
|
|
|
|
@node Machine Dependencies
|
|
|
|
@chapter ARM Dependent Features
|
|
|
|
@end ifclear
|
|
|
|
|
|
|
|
@cindex ARM support
|
|
|
|
@cindex Thumb support
|
|
|
|
@menu
|
|
|
|
* ARM Options:: Options
|
|
|
|
* ARM Syntax:: Syntax
|
|
|
|
* ARM Floating Point:: Floating Point
|
|
|
|
* ARM Directives:: ARM Machine Directives
|
|
|
|
* ARM Opcodes:: Opcodes
|
2003-11-13 14:19:01 +00:00
|
|
|
* ARM Mapping Symbols:: Mapping Symbols
|
1999-05-03 07:29:11 +00:00
|
|
|
@end menu
|
|
|
|
|
|
|
|
@node ARM Options
|
|
|
|
@section Options
|
|
|
|
@cindex ARM options (none)
|
|
|
|
@cindex options for ARM (none)
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@table @code
|
2000-04-24 23:57:30 +00:00
|
|
|
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@cindex @code{-mcpu=} command line option, ARM
|
2002-01-21 00:20:58 +00:00
|
|
|
@item -mcpu=@var{processor}[+@var{extension}@dots{}]
|
1999-05-03 07:29:11 +00:00
|
|
|
This option specifies the target processor. The assembler will issue an
|
|
|
|
error message if an attempt is made to assemble an instruction which
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
will not execute on the target processor. The following processor names are
|
|
|
|
recognized:
|
|
|
|
@code{arm1},
|
|
|
|
@code{arm2},
|
|
|
|
@code{arm250},
|
|
|
|
@code{arm3},
|
|
|
|
@code{arm6},
|
|
|
|
@code{arm60},
|
|
|
|
@code{arm600},
|
|
|
|
@code{arm610},
|
|
|
|
@code{arm620},
|
|
|
|
@code{arm7},
|
|
|
|
@code{arm7m},
|
|
|
|
@code{arm7d},
|
|
|
|
@code{arm7dm},
|
|
|
|
@code{arm7di},
|
|
|
|
@code{arm7dmi},
|
|
|
|
@code{arm70},
|
|
|
|
@code{arm700},
|
|
|
|
@code{arm700i},
|
|
|
|
@code{arm710},
|
|
|
|
@code{arm710t},
|
|
|
|
@code{arm720},
|
|
|
|
@code{arm720t},
|
|
|
|
@code{arm740t},
|
|
|
|
@code{arm710c},
|
|
|
|
@code{arm7100},
|
|
|
|
@code{arm7500},
|
|
|
|
@code{arm7500fe},
|
|
|
|
@code{arm7t},
|
|
|
|
@code{arm7tdmi},
|
2004-09-01 16:34:29 +00:00
|
|
|
@code{arm7tdmi-s},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{arm8},
|
|
|
|
@code{arm810},
|
|
|
|
@code{strongarm},
|
|
|
|
@code{strongarm1},
|
|
|
|
@code{strongarm110},
|
|
|
|
@code{strongarm1100},
|
|
|
|
@code{strongarm1110},
|
|
|
|
@code{arm9},
|
|
|
|
@code{arm920},
|
|
|
|
@code{arm920t},
|
|
|
|
@code{arm922t},
|
|
|
|
@code{arm940t},
|
|
|
|
@code{arm9tdmi},
|
|
|
|
@code{arm9e},
|
2003-12-29 16:43:37 +00:00
|
|
|
@code{arm926e},
|
2004-09-01 16:34:29 +00:00
|
|
|
@code{arm926ej-s},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{arm946e-r0},
|
|
|
|
@code{arm946e},
|
2005-09-27 13:23:38 +00:00
|
|
|
@code{arm946e-s},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{arm966e-r0},
|
|
|
|
@code{arm966e},
|
2005-09-27 13:23:38 +00:00
|
|
|
@code{arm966e-s},
|
|
|
|
@code{arm968e-s},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{arm10t},
|
2005-09-27 13:23:38 +00:00
|
|
|
@code{arm10tdmi},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{arm10e},
|
|
|
|
@code{arm1020},
|
|
|
|
@code{arm1020t},
|
2003-12-29 16:43:37 +00:00
|
|
|
@code{arm1020e},
|
2005-09-27 13:23:38 +00:00
|
|
|
@code{arm1022e},
|
2004-09-01 16:34:29 +00:00
|
|
|
@code{arm1026ej-s},
|
|
|
|
@code{arm1136j-s},
|
|
|
|
@code{arm1136jf-s},
|
2005-09-27 13:23:38 +00:00
|
|
|
@code{arm1156t2-s},
|
|
|
|
@code{arm1156t2f-s},
|
2004-09-30 16:21:50 +00:00
|
|
|
@code{arm1176jz-s},
|
|
|
|
@code{arm1176jzf-s},
|
|
|
|
@code{mpcore},
|
|
|
|
@code{mpcorenovfp},
|
2006-02-24 Paul Brook <paul@codesourcery.com>
gas/
* config/arm/tc-arm.c (arm_ext_v6_notm, arm_ext_div, arm_ext_v7,
arm_ext_v7a, arm_ext_v7r, arm_ext_v7m): New variables.
(struct asm_barrier_opt): Define.
(arm_v7m_psr_hsh, arm_barrier_opt_hsh): New variables.
(parse_psr): Accept V7M psr names.
(parse_barrier): New function.
(enum operand_parse_code): Add OP_oBARRIER.
(parse_operands): Implement OP_oBARRIER.
(do_barrier): New function.
(do_dbg, do_pli, do_t_barrier, do_t_dbg, do_t_div): New functions.
(do_t_cpsi): Add V7M restrictions.
(do_t_mrs, do_t_msr): Validate V7M variants.
(md_assemble): Check for NULL variants.
(v7m_psrs, barrier_opt_names): New tables.
(insns): Add V7 instructions. Mark V6 instructions absent from V7M.
(md_begin): Initialize arm_v7m_psr_hsh and arm_barrier_opt_hsh.
(arm_cpu_option_table): Add Cortex-M3, R4 and A8.
(arm_arch_option_table): Add armv7, armv7a, armv7r and armv7m.
(struct cpu_arch_ver_table): Define.
(cpu_arch_ver): New.
(aeabi_set_public_attributes): Use cpu_arch_ver. Set
Tag_CPU_arch_profile.
* doc/c-arm.texi: Document new cpu and arch options.
gas/testsuite/
* gas/arm/thumb32.d: Fix expected msr and mrs output.
* gas/arm/arch7.d: New test.
* gas/arm/arch7.s: New test.
* gas/arm/arch7m-bad.l: New test.
* gas/arm/arch7m-bad.d: New test.
* gas/arm/arch7m-bad.s: New test.
include/opcode/
* arm.h: Add V7 feature bits.
opcodes/
* arm-dis.c (arm_opcodes): Add V7 instructions.
(thumb32_opcodes): Ditto. Handle V7M MSR/MRS variants.
(print_arm_address): New function.
(print_insn_arm): Use it. Add 'P' and 'U' cases.
(psr_name): New function.
(print_insn_thumb32): Add 'U', 'C' and 'D' cases.
2006-02-24 15:36:36 +00:00
|
|
|
@code{cortex-a8},
|
|
|
|
@code{cortex-r4},
|
|
|
|
@code{cortex-m3},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{ep9312} (ARM920 with Cirrus Maverick coprocessor),
|
|
|
|
@code{i80200} (Intel XScale processor)
|
2003-03-25 20:56:01 +00:00
|
|
|
@code{iwmmxt} (Intel(r) XScale processor with Wireless MMX(tm) technology coprocessor)
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
and
|
|
|
|
@code{xscale}.
|
|
|
|
The special name @code{all} may be used to allow the
|
|
|
|
assembler to accept instructions valid for any ARM processor.
|
|
|
|
|
|
|
|
In addition to the basic instruction set, the assembler can be told to
|
|
|
|
accept various extension mnemonics that extend the processor using the
|
|
|
|
co-processor instruction space. For example, @code{-mcpu=arm920+maverick}
|
|
|
|
is equivalent to specifying @code{-mcpu=ep9312}. The following extensions
|
|
|
|
are currently supported:
|
|
|
|
@code{+maverick}
|
2003-03-25 20:56:01 +00:00
|
|
|
@code{+iwmmxt}
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
and
|
|
|
|
@code{+xscale}.
|
|
|
|
|
|
|
|
@cindex @code{-march=} command line option, ARM
|
2002-01-21 00:20:58 +00:00
|
|
|
@item -march=@var{architecture}[+@var{extension}@dots{}]
|
1999-05-03 07:29:11 +00:00
|
|
|
This option specifies the target architecture. The assembler will issue
|
|
|
|
an error message if an attempt is made to assemble an instruction which
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
will not execute on the target architecture. The following architecture
|
|
|
|
names are recognized:
|
|
|
|
@code{armv1},
|
|
|
|
@code{armv2},
|
|
|
|
@code{armv2a},
|
|
|
|
@code{armv2s},
|
|
|
|
@code{armv3},
|
|
|
|
@code{armv3m},
|
|
|
|
@code{armv4},
|
|
|
|
@code{armv4xm},
|
|
|
|
@code{armv4t},
|
|
|
|
@code{armv4txm},
|
|
|
|
@code{armv5},
|
|
|
|
@code{armv5t},
|
|
|
|
@code{armv5txm},
|
|
|
|
@code{armv5te},
|
2003-12-06 01:25:29 +00:00
|
|
|
@code{armv5texp},
|
2003-12-23 18:48:02 +00:00
|
|
|
@code{armv6},
|
2003-12-18 05:45:13 +00:00
|
|
|
@code{armv6j},
|
2004-09-30 16:21:50 +00:00
|
|
|
@code{armv6k},
|
|
|
|
@code{armv6z},
|
|
|
|
@code{armv6zk},
|
2006-02-24 Paul Brook <paul@codesourcery.com>
gas/
* config/arm/tc-arm.c (arm_ext_v6_notm, arm_ext_div, arm_ext_v7,
arm_ext_v7a, arm_ext_v7r, arm_ext_v7m): New variables.
(struct asm_barrier_opt): Define.
(arm_v7m_psr_hsh, arm_barrier_opt_hsh): New variables.
(parse_psr): Accept V7M psr names.
(parse_barrier): New function.
(enum operand_parse_code): Add OP_oBARRIER.
(parse_operands): Implement OP_oBARRIER.
(do_barrier): New function.
(do_dbg, do_pli, do_t_barrier, do_t_dbg, do_t_div): New functions.
(do_t_cpsi): Add V7M restrictions.
(do_t_mrs, do_t_msr): Validate V7M variants.
(md_assemble): Check for NULL variants.
(v7m_psrs, barrier_opt_names): New tables.
(insns): Add V7 instructions. Mark V6 instructions absent from V7M.
(md_begin): Initialize arm_v7m_psr_hsh and arm_barrier_opt_hsh.
(arm_cpu_option_table): Add Cortex-M3, R4 and A8.
(arm_arch_option_table): Add armv7, armv7a, armv7r and armv7m.
(struct cpu_arch_ver_table): Define.
(cpu_arch_ver): New.
(aeabi_set_public_attributes): Use cpu_arch_ver. Set
Tag_CPU_arch_profile.
* doc/c-arm.texi: Document new cpu and arch options.
gas/testsuite/
* gas/arm/thumb32.d: Fix expected msr and mrs output.
* gas/arm/arch7.d: New test.
* gas/arm/arch7.s: New test.
* gas/arm/arch7m-bad.l: New test.
* gas/arm/arch7m-bad.d: New test.
* gas/arm/arch7m-bad.s: New test.
include/opcode/
* arm.h: Add V7 feature bits.
opcodes/
* arm-dis.c (arm_opcodes): Add V7 instructions.
(thumb32_opcodes): Ditto. Handle V7M MSR/MRS variants.
(print_arm_address): New function.
(print_insn_arm): Use it. Add 'P' and 'U' cases.
(psr_name): New function.
(print_insn_thumb32): Add 'U', 'C' and 'D' cases.
2006-02-24 15:36:36 +00:00
|
|
|
@code{armv7},
|
2006-12-13 16:06:39 +00:00
|
|
|
@code{armv7-a},
|
|
|
|
@code{armv7-r},
|
|
|
|
@code{armv7-m},
|
2003-03-25 20:56:01 +00:00
|
|
|
@code{iwmmxt}
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
and
|
|
|
|
@code{xscale}.
|
|
|
|
If both @code{-mcpu} and
|
|
|
|
@code{-march} are specified, the assembler will use
|
|
|
|
the setting for @code{-mcpu}.
|
|
|
|
|
|
|
|
The architecture option can be extended with the same instruction set
|
|
|
|
extension options as the @code{-mcpu} option.
|
|
|
|
|
|
|
|
@cindex @code{-mfpu=} command line option, ARM
|
|
|
|
@item -mfpu=@var{floating-point-format}
|
|
|
|
|
|
|
|
This option specifies the floating point format to assemble for. The
|
|
|
|
assembler will issue an error message if an attempt is made to assemble
|
|
|
|
an instruction which will not execute on the target floating point unit.
|
|
|
|
The following format options are recognized:
|
|
|
|
@code{softfpa},
|
|
|
|
@code{fpe},
|
2002-01-19 12:48:32 +00:00
|
|
|
@code{fpe2},
|
|
|
|
@code{fpe3},
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
@code{fpa},
|
|
|
|
@code{fpa10},
|
|
|
|
@code{fpa11},
|
|
|
|
@code{arm7500fe},
|
|
|
|
@code{softvfp},
|
|
|
|
@code{softvfp+vfp},
|
|
|
|
@code{vfp},
|
|
|
|
@code{vfp10},
|
|
|
|
@code{vfp10-r0},
|
|
|
|
@code{vfp9},
|
|
|
|
@code{vfpxd},
|
2003-12-06 01:25:29 +00:00
|
|
|
@code{arm1020t},
|
|
|
|
@code{arm1020e},
|
2004-09-01 16:34:29 +00:00
|
|
|
@code{arm1136jf-s}
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
and
|
2003-12-10 12:11:26 +00:00
|
|
|
@code{maverick}.
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
|
|
|
|
In addition to determining which instructions are assembled, this option
|
|
|
|
also affects the way in which the @code{.double} assembler directive behaves
|
|
|
|
when assembling little-endian code.
|
|
|
|
|
|
|
|
The default is dependent on the processor selected. For Architecture 5 or
|
|
|
|
later, the default is to assembler for VFP instructions; for earlier
|
|
|
|
architectures the default is to assemble for FPA instructions.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-mthumb} command line option, ARM
|
|
|
|
@item -mthumb
|
* NEWS: Mention new ARM command-line options and VFP support.
* config/tc-arm.c (ARM_CEXT_XSCALE): Replaces ARM_EXT_XSCALE. All
uses changed.
(ARM_CEXT_MAVERICK): Similarly.
(ARM_ANY): Now means any core instruction.
(CPU_DEFAULT): Default to ARM_ANY.
(uses_apcs_26, atcps, support_interwork, uses_apcs_float)
(pic_code): Declare for all object types. Make type int.
(legacy_cpu, legacy_fpu, mcpu_cpu_opt, mcpu_fpu_opt, march_cpu_opt)
(march_fpu_opt, mfpu_opt): Declare.
(md_longopts): Tidy up conditional definitions.
(arm_opts, arm_cpus, arm_archs, arm_fpus, arm_extensions)
(arm_long_opts): New tables.
(arm_parse_cpu, arm_parse_arch, arm_parse_fpu): New functions.
(arm_parse_extension): New function.
(md_parse_option): Rewrite using new table-driven system.
(md_show_usage): Use new table-driven system.
(md_begin): Calculate cpu_variant from command line option data.
* doc/as.texinfo (ARM ISA options): Docuement new ARM-specific
command-line options.
* doc/c-arm.texi: Likewise.
Testsuite:
* gas/arm/vfp1.d: Use new command-line options.
* gas/arm/vfp1xD.d: Likewise.
* gas/arm/arm.exp (vfp-bad): Likewise.
* gas/arm/maverick.d: Likewise.
2002-01-18 17:01:55 +00:00
|
|
|
This option specifies that the assembler should start assembling Thumb
|
|
|
|
instructions; that is, it should behave as though the file starts with a
|
|
|
|
@code{.code 16} directive.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-mthumb-interwork} command line option, ARM
|
|
|
|
@item -mthumb-interwork
|
|
|
|
This option specifies that the output generated by the assembler should
|
|
|
|
be marked as supporting interworking.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-mapcs} command line option, ARM
|
2000-08-14 09:02:45 +00:00
|
|
|
@item -mapcs @code{[26|32]}
|
1999-05-03 07:29:11 +00:00
|
|
|
This option specifies that the output generated by the assembler should
|
|
|
|
be marked as supporting the indicated version of the Arm Procedure.
|
|
|
|
Calling Standard.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
2000-11-25 00:21:40 +00:00
|
|
|
@cindex @code{-matpcs} command line option, ARM
|
|
|
|
@item -matpcs
|
|
|
|
This option specifies that the output generated by the assembler should
|
|
|
|
be marked as supporting the Arm/Thumb Procedure Calling Standard. If
|
|
|
|
enabled this option will cause the assembler to create an empty
|
|
|
|
debugging section in the object file called .arm.atpcs. Debuggers can
|
|
|
|
use this to determine the ABI being used by.
|
|
|
|
|
2000-04-24 23:57:30 +00:00
|
|
|
@cindex @code{-mapcs-float} command line option, ARM
|
1999-05-03 07:29:11 +00:00
|
|
|
@item -mapcs-float
|
2003-11-06 11:58:58 +00:00
|
|
|
This indicates the floating point variant of the APCS should be
|
1999-05-03 07:29:11 +00:00
|
|
|
used. In this variant floating point arguments are passed in FP
|
2000-01-10 22:22:56 +00:00
|
|
|
registers rather than integer registers.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
|
|
|
@cindex @code{-mapcs-reentrant} command line option, ARM
|
1999-05-03 07:29:11 +00:00
|
|
|
@item -mapcs-reentrant
|
|
|
|
This indicates that the reentrant variant of the APCS should be used.
|
|
|
|
This variant supports position independent code.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
2003-12-10 12:11:26 +00:00
|
|
|
@cindex @code{-mfloat-abi=} command line option, ARM
|
|
|
|
@item -mfloat-abi=@var{abi}
|
|
|
|
This option specifies that the output generated by the assembler should be
|
|
|
|
marked as using specified floating point ABI.
|
|
|
|
The following values are recognized:
|
|
|
|
@code{soft},
|
|
|
|
@code{softfp}
|
|
|
|
and
|
|
|
|
@code{hard}.
|
|
|
|
|
2004-03-23 23:05:52 +00:00
|
|
|
@cindex @code{-eabi=} command line option, ARM
|
|
|
|
@item -meabi=@var{ver}
|
|
|
|
This option specifies which EABI version the produced object files should
|
|
|
|
conform to.
|
2006-07-24 13:49:50 +00:00
|
|
|
The following values are recognized:
|
2006-03-10 17:20:30 +00:00
|
|
|
@code{gnu},
|
|
|
|
@code{4}
|
2004-03-23 23:05:52 +00:00
|
|
|
and
|
2006-03-10 17:20:30 +00:00
|
|
|
@code{5}.
|
2004-03-23 23:05:52 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-EB} command line option, ARM
|
|
|
|
@item -EB
|
|
|
|
This option specifies that the output generated by the assembler should
|
|
|
|
be marked as being encoded for a big-endian processor.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-EL} command line option, ARM
|
|
|
|
@item -EL
|
|
|
|
This option specifies that the output generated by the assembler should
|
|
|
|
be marked as being encoded for a little-endian processor.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{-k} command line option, ARM
|
|
|
|
@cindex PIC code generation for ARM
|
|
|
|
@item -k
|
2001-01-13 22:39:55 +00:00
|
|
|
This option specifies that the output of the assembler should be marked
|
|
|
|
as position-independent code (PIC).
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@end table
|
|
|
|
|
|
|
|
|
|
|
|
@node ARM Syntax
|
|
|
|
@section Syntax
|
|
|
|
@menu
|
|
|
|
* ARM-Chars:: Special Characters
|
|
|
|
* ARM-Regs:: Register Names
|
2006-05-11 15:17:34 +00:00
|
|
|
* ARM-Relocations:: Relocations
|
1999-05-03 07:29:11 +00:00
|
|
|
@end menu
|
|
|
|
|
|
|
|
@node ARM-Chars
|
|
|
|
@subsection Special Characters
|
|
|
|
|
|
|
|
@cindex line comment character, ARM
|
|
|
|
@cindex ARM line comment character
|
2000-01-10 22:22:56 +00:00
|
|
|
The presence of a @samp{@@} on a line indicates the start of a comment
|
|
|
|
that extends to the end of the current line. If a @samp{#} appears as
|
|
|
|
the first character of a line, the whole line is treated as a comment.
|
|
|
|
|
|
|
|
@cindex line separator, ARM
|
|
|
|
@cindex statement separator, ARM
|
|
|
|
@cindex ARM line separator
|
2001-01-13 22:39:55 +00:00
|
|
|
The @samp{;} character can be used instead of a newline to separate
|
|
|
|
statements.
|
2000-01-10 22:22:56 +00:00
|
|
|
|
|
|
|
@cindex immediate character, ARM
|
|
|
|
@cindex ARM immediate character
|
|
|
|
Either @samp{#} or @samp{$} can be used to indicate immediate operands.
|
1999-05-03 07:29:11 +00:00
|
|
|
|
|
|
|
@cindex identifiers, ARM
|
|
|
|
@cindex ARM identifiers
|
|
|
|
*TODO* Explain about /data modifier on symbols.
|
|
|
|
|
|
|
|
@node ARM-Regs
|
|
|
|
@subsection Register Names
|
|
|
|
|
|
|
|
@cindex ARM register names
|
|
|
|
@cindex register names, ARM
|
|
|
|
*TODO* Explain about ARM register naming, and the predefined names.
|
|
|
|
|
|
|
|
@node ARM Floating Point
|
|
|
|
@section Floating Point
|
|
|
|
|
|
|
|
@cindex floating point, ARM (@sc{ieee})
|
|
|
|
@cindex ARM floating point (@sc{ieee})
|
|
|
|
The ARM family uses @sc{ieee} floating-point numbers.
|
|
|
|
|
2006-05-11 15:17:34 +00:00
|
|
|
@node ARM-Relocations
|
|
|
|
@subsection ARM relocation generation
|
|
|
|
|
|
|
|
@cindex data relocations, ARM
|
|
|
|
@cindex ARM data relocations
|
|
|
|
Specific data relocations can be generated by putting the relocation name
|
|
|
|
in parentheses after the symbol name. For example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
.word foo(TARGET1)
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
This will generate an @samp{R_ARM_TARGET1} relocation against the symbol
|
|
|
|
@var{foo}.
|
|
|
|
The following relocations are supported:
|
|
|
|
@code{GOT},
|
|
|
|
@code{GOTOFF},
|
|
|
|
@code{TARGET1},
|
|
|
|
@code{TARGET2},
|
|
|
|
@code{SBREL},
|
|
|
|
@code{TLSGD},
|
|
|
|
@code{TLSLDM},
|
|
|
|
@code{TLSLDO},
|
|
|
|
@code{GOTTPOFF}
|
|
|
|
and
|
|
|
|
@code{TPOFF}.
|
|
|
|
|
|
|
|
For compatibility with older toolchains the assembler also accepts
|
|
|
|
@code{(PLT)} after branch targets. This will generate the deprecated
|
|
|
|
@samp{R_ARM_PLT32} relocation.
|
|
|
|
|
|
|
|
@cindex MOVW and MOVT relocations, ARM
|
|
|
|
Relocations for @samp{MOVW} and @samp{MOVT} instructions can be generated
|
|
|
|
by prefixing the value with @samp{#:lower16:} and @samp{#:upper16}
|
2006-07-24 13:49:50 +00:00
|
|
|
respectively. For example to load the 32-bit address of foo into r0:
|
1999-05-03 07:29:11 +00:00
|
|
|
|
2006-05-11 15:17:34 +00:00
|
|
|
@smallexample
|
|
|
|
MOVW r0, #:lower16:foo
|
|
|
|
MOVT r0, #:upper16:foo
|
|
|
|
@end smallexample
|
1999-05-03 07:29:11 +00:00
|
|
|
|
|
|
|
@node ARM Directives
|
|
|
|
@section ARM Machine Directives
|
|
|
|
|
|
|
|
@cindex machine directives, ARM
|
|
|
|
@cindex ARM machine directives
|
|
|
|
@table @code
|
|
|
|
|
2000-04-24 23:57:30 +00:00
|
|
|
@cindex @code{align} directive, ARM
|
|
|
|
@item .align @var{expression} [, @var{expression}]
|
|
|
|
This is the generic @var{.align} directive. For the ARM however if the
|
|
|
|
first argument is zero (ie no alignment is needed) the assembler will
|
|
|
|
behave as if the argument had been 2 (ie pad to the next four byte
|
2002-12-19 01:11:31 +00:00
|
|
|
boundary). This is for compatibility with ARM's own assembler.
|
2000-04-24 23:57:30 +00:00
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{req} directive, ARM
|
|
|
|
@item @var{name} .req @var{register name}
|
|
|
|
This creates an alias for @var{register name} called @var{name}. For
|
|
|
|
example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
foo .req r0
|
|
|
|
@end smallexample
|
|
|
|
|
* config/tc-arm.texi (struct reg_entry): Add new field 'builtin'.
(rn_table, iwmmxt_table, cp_table, cn_table, fn_table, sn_table,
dn_table, mav_mvf_table, mac_mvd_table, mav_mvfx_table,
mav_mvax_table, mav_dspc_table): Initialise new field.
(insert_reg_alias): Initialise new field.
(md_pseudo_table): Add "unreq" entry.
(s_unreq): New function: Undo the effects of a previous .req.
* doc/c-arm.texi: Document new pseudo op.
* NEWS: Mention new feature.
* testsuite/gas/arm/req.s: New test file. Check .req and .unreq psuedo ops.
* testsuite/gas/arm/req.l: Expected error output from req.s test.
* testsuite/gas/arm/copro.d: Set target architecture for objdump so that the
test will work on architectures which cannot encode higher arm architecture
types in their file headers.
* testsuite/gas/arm/arm.exp: Run new req.s test.
Skip thumb instruction test for PE targets which do not support
thumb relocations.
* testsuite/gas/elf/elf.exp: Skip special handling of section2 test for XScale
targets - it is no longer needed.
2003-11-06 15:30:05 +00:00
|
|
|
@cindex @code{unreq} directive, ARM
|
|
|
|
@item .unreq @var{alias-name}
|
|
|
|
This undefines a register alias which was previously defined using the
|
2007-03-26 14:39:35 +00:00
|
|
|
@code{req}, @code{dn} or @code{qn} directives. For example:
|
* config/tc-arm.texi (struct reg_entry): Add new field 'builtin'.
(rn_table, iwmmxt_table, cp_table, cn_table, fn_table, sn_table,
dn_table, mav_mvf_table, mac_mvd_table, mav_mvfx_table,
mav_mvax_table, mav_dspc_table): Initialise new field.
(insert_reg_alias): Initialise new field.
(md_pseudo_table): Add "unreq" entry.
(s_unreq): New function: Undo the effects of a previous .req.
* doc/c-arm.texi: Document new pseudo op.
* NEWS: Mention new feature.
* testsuite/gas/arm/req.s: New test file. Check .req and .unreq psuedo ops.
* testsuite/gas/arm/req.l: Expected error output from req.s test.
* testsuite/gas/arm/copro.d: Set target architecture for objdump so that the
test will work on architectures which cannot encode higher arm architecture
types in their file headers.
* testsuite/gas/arm/arm.exp: Run new req.s test.
Skip thumb instruction test for PE targets which do not support
thumb relocations.
* testsuite/gas/elf/elf.exp: Skip special handling of section2 test for XScale
targets - it is no longer needed.
2003-11-06 15:30:05 +00:00
|
|
|
|
|
|
|
@smallexample
|
|
|
|
foo .req r0
|
|
|
|
.unreq foo
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
An error occurs if the name is undefined. Note - this pseudo op can
|
|
|
|
be used to delete builtin in register name aliases (eg 'r0'). This
|
|
|
|
should only be done if it is really necessary.
|
|
|
|
|
2007-03-26 14:39:35 +00:00
|
|
|
@cindex @code{dn} and @code{qn} directives, ARM
|
2007-08-23 02:05:58 +00:00
|
|
|
@item @var{name} .dn @var{register name} [@var{.type}] [[@var{index}]]
|
|
|
|
@item @var{name} .qn @var{register name} [@var{.type}] [[@var{index}]]
|
2007-03-26 14:39:35 +00:00
|
|
|
|
|
|
|
The @code{dn} and @code{qn} directives are used to create typed
|
|
|
|
and/or indexed register aliases for use in Advanced SIMD Extension
|
|
|
|
(Neon) instructions. The former should be used to create aliases
|
|
|
|
of double-precision registers, and the latter to create aliases of
|
|
|
|
quad-precision registers.
|
|
|
|
|
|
|
|
If these directives are used to create typed aliases, those aliases can
|
|
|
|
be used in Neon instructions instead of writing types after the mnemonic
|
|
|
|
or after each operand. For example:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
x .dn d2.f32
|
|
|
|
y .dn d3.f32
|
|
|
|
z .dn d4.f32[1]
|
|
|
|
vmul x,y,z
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
This is equivalent to writing the following:
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
vmul.f32 d2,d3,d4[1]
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
Aliases created using @code{dn} or @code{qn} can be destroyed using
|
|
|
|
@code{unreq}.
|
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{code} directive, ARM
|
2000-08-14 09:02:45 +00:00
|
|
|
@item .code @code{[16|32]}
|
1999-05-03 07:29:11 +00:00
|
|
|
This directive selects the instruction set being generated. The value 16
|
|
|
|
selects Thumb, with the value 32 selecting ARM.
|
|
|
|
|
|
|
|
@cindex @code{thumb} directive, ARM
|
|
|
|
@item .thumb
|
|
|
|
This performs the same action as @var{.code 16}.
|
|
|
|
|
|
|
|
@cindex @code{arm} directive, ARM
|
|
|
|
@item .arm
|
|
|
|
This performs the same action as @var{.code 32}.
|
|
|
|
|
|
|
|
@cindex @code{force_thumb} directive, ARM
|
|
|
|
@item .force_thumb
|
|
|
|
This directive forces the selection of Thumb instructions, even if the
|
|
|
|
target processor does not support those instructions
|
|
|
|
|
|
|
|
@cindex @code{thumb_func} directive, ARM
|
|
|
|
@item .thumb_func
|
|
|
|
This directive specifies that the following symbol is the name of a
|
|
|
|
Thumb encoded function. This information is necessary in order to allow
|
|
|
|
the assembler and linker to generate correct code for interworking
|
|
|
|
between Arm and Thumb instructions and should be used even if
|
2000-06-25 17:59:22 +00:00
|
|
|
interworking is not going to be performed. The presence of this
|
|
|
|
directive also implies @code{.thumb}
|
1999-05-03 07:29:11 +00:00
|
|
|
|
2006-11-29 17:53:39 +00:00
|
|
|
This directive is not neccessary when generating EABI objects. On these
|
|
|
|
targets the encoding is implicit when generating Thumb code.
|
|
|
|
|
1999-07-08 01:49:09 +00:00
|
|
|
@cindex @code{thumb_set} directive, ARM
|
|
|
|
@item .thumb_set
|
|
|
|
This performs the equivalent of a @code{.set} directive in that it
|
|
|
|
creates a symbol which is an alias for another symbol (possibly not yet
|
|
|
|
defined). This directive also has the added property in that it marks
|
|
|
|
the aliased symbol as being a thumb function entry point, in the same
|
|
|
|
way that the @code{.thumb_func} directive does.
|
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@cindex @code{.ltorg} directive, ARM
|
|
|
|
@item .ltorg
|
|
|
|
This directive causes the current contents of the literal pool to be
|
|
|
|
dumped into the current section (which is assumed to be the .text
|
|
|
|
section) at the current location (aligned to a word boundary).
|
2002-07-30 10:56:04 +00:00
|
|
|
@code{GAS} maintains a separate literal pool for each section and each
|
|
|
|
sub-section. The @code{.ltorg} directive will only affect the literal
|
|
|
|
pool of the current section and sub-section. At the end of assembly
|
|
|
|
all remaining, un-empty literal pools will automatically be dumped.
|
|
|
|
|
|
|
|
Note - older versions of @code{GAS} would dump the current literal
|
|
|
|
pool any time a section change occurred. This is no longer done, since
|
|
|
|
it prevents accurate control of the placement of literal pools.
|
1999-05-03 07:29:11 +00:00
|
|
|
|
|
|
|
@cindex @code{.pool} directive, ARM
|
|
|
|
@item .pool
|
|
|
|
This is a synonym for .ltorg.
|
|
|
|
|
2004-10-05 13:51:40 +00:00
|
|
|
@cindex @code{.fnstart} directive, ARM
|
|
|
|
@item .unwind_fnstart
|
|
|
|
Marks the start of a function with an unwind table entry.
|
|
|
|
|
|
|
|
@cindex @code{.fnend} directive, ARM
|
|
|
|
@item .unwind_fnend
|
|
|
|
Marks the end of a function with an unwind table entry. The unwind index
|
|
|
|
table entry is created when this directive is processed.
|
|
|
|
|
|
|
|
If no personality routine has been specified then standard personality
|
|
|
|
routine 0 or 1 will be used, depending on the number of unwind opcodes
|
|
|
|
required.
|
|
|
|
|
|
|
|
@cindex @code{.cantunwind} directive, ARM
|
|
|
|
@item .cantunwind
|
|
|
|
Prevents unwinding through the current function. No personality routine
|
|
|
|
or exception table data is required or permitted.
|
|
|
|
|
|
|
|
@cindex @code{.personality} directive, ARM
|
|
|
|
@item .personality @var{name}
|
|
|
|
Sets the personality routine for the current function to @var{name}.
|
|
|
|
|
|
|
|
@cindex @code{.personalityindex} directive, ARM
|
|
|
|
@item .personalityindex @var{index}
|
|
|
|
Sets the personality routine for the current function to the EABI standard
|
|
|
|
routine number @var{index}
|
|
|
|
|
|
|
|
@cindex @code{.handlerdata} directive, ARM
|
|
|
|
@item .handlerdata
|
|
|
|
Marks the end of the current function, and the start of the exception table
|
|
|
|
entry for that function. Anything between this directive and the
|
|
|
|
@code{.fnend} directive will be added to the exception table entry.
|
|
|
|
|
|
|
|
Must be preceded by a @code{.personality} or @code{.personalityindex}
|
|
|
|
directive.
|
|
|
|
|
|
|
|
@cindex @code{.save} directive, ARM
|
|
|
|
@item .save @var{reglist}
|
|
|
|
Generate unwinder annotations to restore the registers in @var{reglist}.
|
|
|
|
The format of @var{reglist} is the same as the corresponding store-multiple
|
|
|
|
instruction.
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
@exdent @emph{core registers}
|
|
|
|
.save @{r4, r5, r6, lr@}
|
|
|
|
stmfd sp!, @{r4, r5, r6, lr@}
|
|
|
|
@exdent @emph{FPA registers}
|
|
|
|
.save f4, 2
|
|
|
|
sfmfd f4, 2, [sp]!
|
|
|
|
@exdent @emph{VFP registers}
|
|
|
|
.save @{d8, d9, d10@}
|
2006-06-21 14:20:25 +00:00
|
|
|
fstmdx sp!, @{d8, d9, d10@}
|
2004-10-05 13:51:40 +00:00
|
|
|
@exdent @emph{iWMMXt registers}
|
|
|
|
.save @{wr10, wr11@}
|
|
|
|
wstrd wr11, [sp, #-8]!
|
|
|
|
wstrd wr10, [sp, #-8]!
|
|
|
|
or
|
|
|
|
.save wr11
|
|
|
|
wstrd wr11, [sp, #-8]!
|
|
|
|
.save wr10
|
|
|
|
wstrd wr10, [sp, #-8]!
|
|
|
|
@end smallexample
|
|
|
|
|
2006-06-21 14:20:25 +00:00
|
|
|
@cindex @code{.vsave} directive, ARM
|
|
|
|
@item .vsave @var{vfp-reglist}
|
|
|
|
Generate unwinder annotations to restore the VFP registers in @var{vfp-reglist}
|
|
|
|
using FLDMD. Also works for VFPv3 registers
|
|
|
|
that are to be restored using VLDM.
|
|
|
|
The format of @var{vfp-reglist} is the same as the corresponding store-multiple
|
|
|
|
instruction.
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
@exdent @emph{VFP registers}
|
|
|
|
.vsave @{d8, d9, d10@}
|
|
|
|
fstmdd sp!, @{d8, d9, d10@}
|
|
|
|
@exdent @emph{VFPv3 registers}
|
|
|
|
.vsave @{d15, d16, d17@}
|
|
|
|
vstm sp!, @{d15, d16, d17@}
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
Since FLDMX and FSTMX are now deprecated, this directive should be
|
|
|
|
used in favour of @code{.save} for saving VFP registers for ARMv6 and above.
|
|
|
|
|
2004-10-05 13:51:40 +00:00
|
|
|
@cindex @code{.pad} directive, ARM
|
|
|
|
@item .pad #@var{count}
|
|
|
|
Generate unwinder annotations for a stack adjustment of @var{count} bytes.
|
|
|
|
A positive value indicates the function prologue allocated stack space by
|
|
|
|
decrementing the stack pointer.
|
|
|
|
|
|
|
|
@cindex @code{.movsp} directive, ARM
|
2006-09-16 16:24:28 +00:00
|
|
|
@item .movsp @var{reg} [, #@var{offset}]
|
|
|
|
Tell the unwinder that @var{reg} contains an offset from the current
|
|
|
|
stack pointer. If @var{offset} is not specified then it is assumed to be
|
|
|
|
zero.
|
2004-10-05 13:51:40 +00:00
|
|
|
|
|
|
|
@cindex @code{.setfp} directive, ARM
|
|
|
|
@item .setfp @var{fpreg}, @var{spreg} [, #@var{offset}]
|
|
|
|
Make all unwinder annotations relaive to a frame pointer. Without this
|
|
|
|
the unwinder will use offsets from the stack pointer.
|
|
|
|
|
|
|
|
The syntax of this directive is the same as the @code{sub} or @code{mov}
|
|
|
|
instruction used to set the frame pointer. @var{spreg} must be either
|
|
|
|
@code{sp} or mentioned in a previous @code{.movsp} directive.
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
.movsp ip
|
|
|
|
mov ip, sp
|
|
|
|
@dots{}
|
|
|
|
.setfp fp, ip, #4
|
|
|
|
sub fp, ip, #4
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
@cindex @code{.unwind_raw} directive, ARM
|
|
|
|
@item .raw @var{offset}, @var{byte1}, @dots{}
|
|
|
|
Insert one of more arbitary unwind opcode bytes, which are known to adjust
|
|
|
|
the stack pointer by @var{offset} bytes.
|
|
|
|
|
|
|
|
For example @code{.unwind_raw 4, 0xb1, 0x01} is equivalent to
|
|
|
|
@code{.save @{r0@}}
|
|
|
|
|
2005-10-08 Paul Brook <paul@codesourcery.com>
bfd/
* elf32-arm.c: Move #include "elf/arm.h" after libbfd.h.
(NUM_KNOWN_ATTRIBUTES): Define.
(aeabi_attribute, aeabi_attribute_list): Define.
(elf32_arm_obj_tdata): Add known_eabi_attributes and
other_eabi_attributes.
(uleb128_size, is_default_attr, eabi_attr_size,
elf32_arm_eabi_attr_size, write_uleb128, write_eabi_attribute,
elf32_arm_set_eabi_attr_contents, elf32_arm_bfd_final_link,
elf32_arm_new_eabi_attr, attr_strdup, elf32_arm_add_eabi_attr_int,
elf32_arm_add_eabi_attr_compat, copy_eabi_attributes,
elf32_arm_merge_eabi_attributes): New functions.
(elf32_arm_copy_private_bfd_data): Copy EABI object attributes.
(elf32_arm_fake_sections): Handle .ARM.attributes.
(elf32_arm_parse_attributes): New function.
(elf32_arm_section_from_shdr): Use it.
(bfd_elf32_bfd_final_link): Define.
gas/
* config/tc-arm.c: Don't provide fallback default for CPU_DEFAULT.
(arm_arch_used, thumb_arch_used, selected_cpu, selected_cpu_name):
New variables.
(arm_cpu_option_table): Add canonical_name.
(arm_cpus): Populate canonical_name field.
(s_arm_eabi_attribute, s_arm_arch, s_arm_cpu, s_arm_fpu,
aeabi_set_public_attributes, arm_md_end): New functions.
(md_pseudo_table): Add "cpu", "arch", "fpu" and "eabi_attribute".
(md_assemble): Set thumb_arch_used and arm_arch_used.
(md_begin): Set defaut cpu if CPU_DEFAULT not defined.
* config/tc-arm.h (md_end): Define.
* doc/c-arm.texi: Document .cpu, .arch, .fpu and .eabi_attribute.
gas/testsuite/
* gas/arm/eabi_attr_1.s: New test.
* gas/arm/eabi_attr_1.d: New test.
* gas/arm/arm7t.d: Only disassemble code sections.
* gas/arm/bignum1.d: Ignore Arm object attribute sections.
* gas/arm/mapping.d: Ditto.
* gas/arm/unwind.d: Ditto.
* gas/elf/section0.d: Ditto.
* gas/elf/section1.d: Ditto.
* gas/elf/elf.exp: Set target_machine for Arm EABI based targets.
* gas/elf/section2.e-armeabi: New file.
include/elf/
* arm.h: Add prototypes for BFD object attribute routines.
ld/testsuite/
* ld-arm/arm-rel31.d: Ignore Arm object attribute sections.
* ld-arm/arm-target1-abs.d: Ditto.
* ld-arm/arm-target1-rel.d: Ditto.
* ld-arm/arm-target2-abs.d: Ditto.
* ld-arm/arm-target2-got-rel.d: Ditto.
* ld-arm/arm-target2-rel.d: Ditto.
2005-10-08 17:07:19 +00:00
|
|
|
@cindex @code{.cpu} directive, ARM
|
|
|
|
@item .cpu @var{name}
|
|
|
|
Select the target processor. Valid values for @var{name} are the same as
|
|
|
|
for the @option{-mcpu} commandline option.
|
|
|
|
|
|
|
|
@cindex @code{.arch} directive, ARM
|
|
|
|
@item .arch @var{name}
|
|
|
|
Select the target architecture. Valid values for @var{name} are the same as
|
|
|
|
for the @option{-march} commandline option.
|
|
|
|
|
2006-10-31 20:16:33 +00:00
|
|
|
@cindex @code{.object_arch} directive, ARM
|
|
|
|
@item .object_arch @var{name}
|
|
|
|
Override the architecture recorded in the EABI object attribute section.
|
|
|
|
Valid values for @var{name} are the same as for the @code{.arch} directive.
|
|
|
|
Typically this is useful when code uses runtime detection of CPU features.
|
|
|
|
|
2005-10-08 Paul Brook <paul@codesourcery.com>
bfd/
* elf32-arm.c: Move #include "elf/arm.h" after libbfd.h.
(NUM_KNOWN_ATTRIBUTES): Define.
(aeabi_attribute, aeabi_attribute_list): Define.
(elf32_arm_obj_tdata): Add known_eabi_attributes and
other_eabi_attributes.
(uleb128_size, is_default_attr, eabi_attr_size,
elf32_arm_eabi_attr_size, write_uleb128, write_eabi_attribute,
elf32_arm_set_eabi_attr_contents, elf32_arm_bfd_final_link,
elf32_arm_new_eabi_attr, attr_strdup, elf32_arm_add_eabi_attr_int,
elf32_arm_add_eabi_attr_compat, copy_eabi_attributes,
elf32_arm_merge_eabi_attributes): New functions.
(elf32_arm_copy_private_bfd_data): Copy EABI object attributes.
(elf32_arm_fake_sections): Handle .ARM.attributes.
(elf32_arm_parse_attributes): New function.
(elf32_arm_section_from_shdr): Use it.
(bfd_elf32_bfd_final_link): Define.
gas/
* config/tc-arm.c: Don't provide fallback default for CPU_DEFAULT.
(arm_arch_used, thumb_arch_used, selected_cpu, selected_cpu_name):
New variables.
(arm_cpu_option_table): Add canonical_name.
(arm_cpus): Populate canonical_name field.
(s_arm_eabi_attribute, s_arm_arch, s_arm_cpu, s_arm_fpu,
aeabi_set_public_attributes, arm_md_end): New functions.
(md_pseudo_table): Add "cpu", "arch", "fpu" and "eabi_attribute".
(md_assemble): Set thumb_arch_used and arm_arch_used.
(md_begin): Set defaut cpu if CPU_DEFAULT not defined.
* config/tc-arm.h (md_end): Define.
* doc/c-arm.texi: Document .cpu, .arch, .fpu and .eabi_attribute.
gas/testsuite/
* gas/arm/eabi_attr_1.s: New test.
* gas/arm/eabi_attr_1.d: New test.
* gas/arm/arm7t.d: Only disassemble code sections.
* gas/arm/bignum1.d: Ignore Arm object attribute sections.
* gas/arm/mapping.d: Ditto.
* gas/arm/unwind.d: Ditto.
* gas/elf/section0.d: Ditto.
* gas/elf/section1.d: Ditto.
* gas/elf/elf.exp: Set target_machine for Arm EABI based targets.
* gas/elf/section2.e-armeabi: New file.
include/elf/
* arm.h: Add prototypes for BFD object attribute routines.
ld/testsuite/
* ld-arm/arm-rel31.d: Ignore Arm object attribute sections.
* ld-arm/arm-target1-abs.d: Ditto.
* ld-arm/arm-target1-rel.d: Ditto.
* ld-arm/arm-target2-abs.d: Ditto.
* ld-arm/arm-target2-got-rel.d: Ditto.
* ld-arm/arm-target2-rel.d: Ditto.
2005-10-08 17:07:19 +00:00
|
|
|
@cindex @code{.fpu} directive, ARM
|
|
|
|
@item .fpu @var{name}
|
|
|
|
Select the floating point unit to assemble for. Valid values for @var{name}
|
|
|
|
are the same as for the @option{-mfpu} commandline option.
|
|
|
|
|
|
|
|
@cindex @code{.eabi_attribute} directive, ARM
|
|
|
|
@item .eabi_attribute @var{tag}, @var{value}
|
|
|
|
Set the EABI object attribute number @var{tag} to @var{value}. The value
|
|
|
|
is either a @code{number}, @code{"string"}, or @code{number, "string"}
|
|
|
|
depending on the tag.
|
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
@end table
|
|
|
|
|
|
|
|
@node ARM Opcodes
|
|
|
|
@section Opcodes
|
|
|
|
|
|
|
|
@cindex ARM opcodes
|
|
|
|
@cindex opcodes for ARM
|
1999-07-05 07:39:01 +00:00
|
|
|
@code{@value{AS}} implements all the standard ARM opcodes. It also
|
|
|
|
implements several pseudo opcodes, including several synthetic load
|
|
|
|
instructions.
|
1999-05-03 07:29:11 +00:00
|
|
|
|
1999-07-05 07:39:01 +00:00
|
|
|
@table @code
|
|
|
|
|
|
|
|
@cindex @code{NOP} pseudo op, ARM
|
|
|
|
@item NOP
|
|
|
|
@smallexample
|
|
|
|
nop
|
|
|
|
@end smallexample
|
1999-05-03 07:29:11 +00:00
|
|
|
|
1999-07-05 07:39:01 +00:00
|
|
|
This pseudo op will always evaluate to a legal ARM instruction that does
|
|
|
|
nothing. Currently it will evaluate to MOV r0, r0.
|
1999-05-03 07:29:11 +00:00
|
|
|
|
1999-07-05 07:39:01 +00:00
|
|
|
@cindex @code{LDR reg,=<label>} pseudo op, ARM
|
|
|
|
@item LDR
|
1999-05-03 07:29:11 +00:00
|
|
|
@smallexample
|
|
|
|
ldr <register> , = <expression>
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
If expression evaluates to a numeric constant then a MOV or MVN
|
|
|
|
instruction will be used in place of the LDR instruction, if the
|
|
|
|
constant can be generated by either of these instructions. Otherwise
|
|
|
|
the constant will be placed into the nearest literal pool (if it not
|
|
|
|
already there) and a PC relative LDR instruction will be generated.
|
|
|
|
|
1999-07-05 07:39:01 +00:00
|
|
|
@cindex @code{ADR reg,<label>} pseudo op, ARM
|
|
|
|
@item ADR
|
|
|
|
@smallexample
|
|
|
|
adr <register> <label>
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
This instruction will load the address of @var{label} into the indicated
|
|
|
|
register. The instruction will evaluate to a PC relative ADD or SUB
|
|
|
|
instruction depending upon where the label is located. If the label is
|
|
|
|
out of range, or if it is not defined in the same file (and section) as
|
|
|
|
the ADR instruction, then an error will be generated. This instruction
|
|
|
|
will not make use of the literal pool.
|
|
|
|
|
|
|
|
@cindex @code{ADRL reg,<label>} pseudo op, ARM
|
|
|
|
@item ADRL
|
|
|
|
@smallexample
|
|
|
|
adrl <register> <label>
|
|
|
|
@end smallexample
|
|
|
|
|
|
|
|
This instruction will load the address of @var{label} into the indicated
|
2001-01-13 22:39:55 +00:00
|
|
|
register. The instruction will evaluate to one or two PC relative ADD
|
1999-07-05 07:39:01 +00:00
|
|
|
or SUB instructions depending upon where the label is located. If a
|
|
|
|
second instruction is not needed a NOP instruction will be generated in
|
|
|
|
its place, so that this instruction is always 8 bytes long.
|
|
|
|
|
|
|
|
If the label is out of range, or if it is not defined in the same file
|
|
|
|
(and section) as the ADRL instruction, then an error will be generated.
|
|
|
|
This instruction will not make use of the literal pool.
|
|
|
|
|
|
|
|
@end table
|
|
|
|
|
1999-05-03 07:29:11 +00:00
|
|
|
For information on the ARM or Thumb instruction sets, see @cite{ARM
|
|
|
|
Software Development Toolkit Reference Manual}, Advanced RISC Machines
|
|
|
|
Ltd.
|
|
|
|
|
2003-11-13 14:19:01 +00:00
|
|
|
@node ARM Mapping Symbols
|
|
|
|
@section Mapping Symbols
|
|
|
|
|
|
|
|
The ARM ELF specification requires that special symbols be inserted
|
|
|
|
into object files to mark certain features:
|
|
|
|
|
|
|
|
@table @code
|
|
|
|
|
|
|
|
@cindex @code{$a}
|
|
|
|
@item $a
|
|
|
|
At the start of a region of code containing ARM instructions.
|
|
|
|
|
|
|
|
@cindex @code{$t}
|
|
|
|
@item $t
|
|
|
|
At the start of a region of code containing THUMB instructions.
|
|
|
|
|
|
|
|
@cindex @code{$d}
|
|
|
|
@item $d
|
|
|
|
At the start of a region of data.
|
|
|
|
|
|
|
|
@end table
|
|
|
|
|
|
|
|
The assembler will automatically insert these symbols for you - there
|
|
|
|
is no need to code them yourself. Support for tagging symbols ($b,
|
|
|
|
$f, $p and $m) which is also mentioned in the current ARM ELF
|
|
|
|
specification is not implemented. This is because they have been
|
|
|
|
dropped from the new EABI and so tools cannot rely upon their
|
|
|
|
presence.
|
|
|
|
|