source: clfs-embedded/BOOK/cross-tools/arm/abi.xml @ 9cbe486

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-abi">
  <?dbhtml filename="abi.html"?>

  <title>ABI Variables</title>

  <para os="a">On the ARM architecture, there are two major ABI types to choose
  from: EABI and OABI.  There is also a Thumb ABI and an Intel IWMMX specific
  ABI.</para>

  <para os="b">The EABI (Embedded ABI) is newer and supports additional
  features, faster software floating point operations, and Thumb interworking,
  but is only compatible with ARMv4t and newer cores.  The EABI has
  sub-ABIs of: aapcs-linux and aapcs.  aapcs-linux has standard Linux 4 byte
  enums while aapcs has variable length enums.</para>

  <para os="c">The OABI (old ABI) is called apcs-gnu and supports ARMv4 and 
  older cores.</para>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../x86/abi.xml"
  xpointer="xpointer(//*[@os='a'])"/>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../x86/abi.xml"
  xpointer="xpointer(//*[@os='b'])"/>

  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
  href="../x86/abi.xml"
  xpointer="xpointer(//*[@os='c'])"/>

  <table>
    <title>List of Build Variables</title>
    <?dbfo table-width="3in" ?>

    <tgroup cols="2">

      <colspec colnum="1" colwidth="1.5in" colname="ABI to Select"/>
      <colspec colnum="2" colwidth="1.5in" colname="Variable Value"/>
      <colspec colnum="3" colwidth="2in" colname="Note"/>

      <thead>
        <row>
          <entry>ABI</entry>
          <entry>BUILD=Value</entry>
          <entry>Note</entry>
        </row>
      </thead>

      <tbody>
        <row>
          <entry>apcs-gnu</entry>
          <entry>-mabi=apcs-gnu</entry>
          <entry>Legacy ABI, arm4 and older</entry>
        </row>
        <row>
          <entry>atpcs</entry>
          <entry>-mabi=atpcs</entry>
          <entry>Thumb ABI</entry>
        </row>
        <row>
          <entry>aapcs</entry>
          <entry>-mabi=aapcs</entry>
          <entry>EABI w/ variable size enums</entry>
        </row>
        <row>
          <entry>aapcs-linux</entry>
          <entry>-mabi=aapcs-linux</entry>
          <entry>EABI w/ standard Linux 32 bit (int) enums</entry>
        </row>
        <row>
          <entry>iwmmxt</entry>
          <entry>-mabi=iwmmxt</entry>
          <entry>Supports Intel XScale MMX extensions</entry>
        </row>
      </tbody>

    </tgroup>

  </table>

</sect1>