RealView Compilation Tools Assembler Guide: 3.1.3. AAPCS

3.1.3. AAPCS

There is an option to specify whether you are using the Procedure Call Standard for the ARM Architecture (AAPCS):

--apcs qualifier

The AAPCS forms part of the Base Standard Application Binary Interface for the ARM Architecture (BSABI) specification. By writing code that adheres to the AAPCS, you can ensure that separately compiled and assembled modules can work together.

The --apcs option can also specify some attributes of code sections.

For more information, see the Procedure Call Standard for the ARM Architecture specification, aapcs.pdf, in install_directory\Documentation\Specifications\...

Note

AAPCS qualifiers do not affect the code produced by the assembler. They are an assertion by the programmer that the code in inputfile complies with a particular variant of AAPCS. They cause attributes to be set in the object file produced by the assembler. The linker uses these attributes to check compatibility of files, and to select appropriate library variants.

Values for qualifier are:

none: Specifies that inputfile does not use AAPCS. AAPCS registers are not set up. Other qualifiers are not permitted if you use none.
/interwork: Specifies that the code in inputfile is suitable for ARM and Thumb interworking. See Chapter 5 Interworking ARM and Thumb in the Developer Guide for information.
/nointerwork: Specifies that the code in inputfile is not suitable for ARM and Thumb interworking. This is the default.
/inter: Is a synonym for /interwork.
/nointer: Is a synonym for /nointerwork.
/ropi: Specifies that the content of inputfile is read-only position-independent.
/noropi: Specifies that the content of inputfile is not read-only position-independent. This is the default.
/pic: Is a synonym for /ropi.
/nopic: Is a synonym for /noropi.
/rwpi: Specifies that the content of inputfile is read-write position-independent.
/norwpi: Specifies that the content of inputfile is not read-write position-independent. This is the default.
/pid: Is a synonym for /rwpi.
/nopid: Is a synonym for /norwpi.
/fpic: Specifies that the content of inputfile is read-only position-independent code that requires FPIC addressing.

Note

If you specify more than one qualifier, ensure that there are no spaces or commas between the individual qualifiers in the list.

Copyright © 2002-2010 ARM. All rights reserved.	ARM DUI 0204J
Non-Confidential	ID101213
PDF version