3.8. Object File Portability

It is possible to create object files using Sourcery CodeBench for ARM EABI that are link-compatible with the GNU C library provided with Sourcery CodeBench for ARM GNU/Linux as well as with the CodeSourcery C Library or Newlib C Library provided with ARM bare-metal toolchains. These object files are additionally link-compatible with other ARM C Library ABI-compliant static linking environments and toolchains.

To use this feature, when compiling your files with the bare-metal ARM EABI toolchain define the preprocessor constant _AEABI_PORTABILITY_LEVEL to 1 before including any system header files. For example, pass the option -D_AEABI_PORTABILITY_LEVEL=1 on your compilation command line. No special options are required when linking the resulting object files. When building applications for ARM EABI, files compiled with this definition may be linked freely with those compiled without it.

Files compiled in this manner may not use the functions fgetpos or fsetpos, or reference the type fpos_t. This is because Newlib assumes a representation for fpos_t that is not AEABI-compliant.

Note that object files are only portable from bare-metal toolchains to GNU/Linux, and not vice versa; object files compiled for ARM GNU/Linux targets cannot be linked into ARM EABI executables.