add C Library ABI for the Arm Architecture specification

clibabi32/CONTRIBUTIONS

@@ -0,0 +1,3 @@
+Contributions to this project are licensed under an inbound=outbound
+model such that any such contributions are licensed by the contributor
+under the same terms as those in the LICENSE file.

clibabi32/LICENSE

@@ -0,0 +1,22 @@
+This work is licensed under the Creative Commons
+Attribution-ShareAlike 4.0 International License. To view a copy of
+this license, visit http://creativecommons.org/licenses/by-sa/4.0/ or
+send a letter to Creative Commons, PO Box 1866, Mountain View, CA
+94042, USA.
+
+Grant of Patent License. Subject to the terms and conditions of this
+license (both the Public License and this Patent License), each
+Licensor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable (except as stated in this
+section) patent license to make, have made, use, offer to sell, sell,
+import, and otherwise transfer the Licensed Material, where such
+license applies only to those patent claims licensable by such
+Licensor that are necessarily infringed by their contribution(s) alone
+or by combination of their contribution(s) with the Licensed Material
+to which such contribution(s) was submitted. If You institute patent
+litigation against any entity (including a cross-claim or counterclaim
+in a lawsuit) alleging that the Licensed Material or a contribution
+incorporated within the Licensed Material constitutes direct or
+contributory patent infringement, then any licenses granted to You
+under this license for that Licensed Material shall terminate as of
+the date such litigation is filed.

clibabi32/README.md

@@ -0,0 +1,38 @@
+<div align="center">
+   <img src="Arm_logo_blue_150MN.png" />
+</div>
+
+# C Library ABI for the Arm Architecture
+
+
+## About this document
+
+This document defines an ANSI C (C89) run-time library ABI for programs written
+in Arm and Thumb assembly language, C, and stand alone C++.
+
+## About the license
+
+As identified more fully in the [LICENSE](LICENSE) file, this project
+is licensed under CC-BY-SA-4.0 along with an additional patent
+license.  The language in the additional patent license is largely
+identical to that in Apache-2.0 (specifically, Section 3 of Apache-2.0
+as reflected at https://www.apache.org/licenses/LICENSE-2.0) with two
+exceptions.
+
+First, several changes were made related to the defined terms so as to
+reflect the fact that such defined terms need to align with the
+terminology in CC-BY-SA-4.0 rather than Apache-2.0 (e.g., changing
+“Work” to “Licensed Material”).
+
+Second, the defensive termination clause was changed such that the
+scope of defensive termination applies to “any licenses granted to
+You” (rather than “any patent licenses granted to You”).  This change
+is intended to help maintain a healthy ecosystem by providing
+additional protection to the community against patent litigation
+claims.
+
+## Defects report
+
+Please report defects in the [C Library ABI for the Arm
+Architecture](clibabi32.rst) to the [issue tracker page on
+GitHub](https://github.com/ARM-software/abi-aa/issues).

clibabi32/TRADEMARK_NOTICE

@@ -0,0 +1,8 @@
+The text of and illustrations in this document are licensed by Arm
+under a Creative Commons Attribution–Share Alike 4.0 International
+license ("CC-BY-SA-4.0”), with an additional clause on patents.
+The Arm trademarks featured here are registered trademarks or
+trademarks of Arm Limited (or its subsidiaries) in the US and/or
+elsewhere. All rights reserved. Please visit
+https://www.arm.com/company/policies/trademarks for more information
+about Arm’s trademarks.

clibabi32/vendor-table.txt

@@ -0,0 +1,50 @@
+.. table:: Registered Vendors
+
+  +-----------------+---------------------------------------------------------------------+
+  | Name            | Vendor                                                              |
+  +=================+=====================================================================+
+  | ``ADI``         | Analog Devices                                                      |
+  +-----------------+---------------------------------------------------------------------+
+  | ``acle``        | Reserved for use by Arm C Language Extensions.                      |
+  +-----------------+---------------------------------------------------------------------+
+  | ``aeabi``       | Reserved to the ABI for the Arm Architecture (EABI pseudo-vendor)   |
+  +-----------------+---------------------------------------------------------------------+
+  | ``Anon``\ *Xyz* | Reserved to private experiments by the Xyz vendor.                  |
+  | ``anon``\ *Xyz* | Guaranteed not to clash with any registered vendor name.            |
+  +-----------------+---------------------------------------------------------------------+
+  | ``ARM``         | Arm Ltd (Note: the company, not the processor).                     |
+  +-----------------+---------------------------------------------------------------------+
+  | ``cxa``         | C++ ABI pseudo-vendor                                               |
+  +-----------------+---------------------------------------------------------------------+
+  | ``FSL``         | Freescale Semiconductor Inc.                                        |
+  +-----------------+---------------------------------------------------------------------+
+  | ``GHS``         | Green Hills Systems                                                 |
+  +-----------------+---------------------------------------------------------------------+
+  | ``gnu``         | GNU compilers and tools (Free Software Foundation)                  |
+  +-----------------+---------------------------------------------------------------------+
+  | ``iar``         | IAR Systems                                                         |
+  +-----------------+---------------------------------------------------------------------+
+  | ``icc``         | ImageCraft Creations Inc (*ImageCraft C Compiler*)                  |
+  +-----------------+---------------------------------------------------------------------+
+  | ``intel``       | Intel Corporation                                                   |
+  +-----------------+---------------------------------------------------------------------+
+  | ``ixs``         | Intel Xscale                                                        |
+  +-----------------+---------------------------------------------------------------------+
+  | ``llvm``        | The LLVM/Clang projects                                             |
+  +-----------------+---------------------------------------------------------------------+
+  | ``PSI``         | PalmSource Inc.                                                     |
+  +-----------------+---------------------------------------------------------------------+
+  | ``RAL``         | Rowley Associates Ltd                                               |
+  +-----------------+---------------------------------------------------------------------+
+  | ``SEGGER``      | SEGGER Microcontroller GmbH                                         |
+  +-----------------+---------------------------------------------------------------------+
+  | ``somn``        | SOMNIUM Technologies Limited.                                       |
+  +-----------------+---------------------------------------------------------------------+
+  | ``TASKING``     | Altium Ltd.                                                         |
+  +-----------------+---------------------------------------------------------------------+
+  | ``TI``          | TI Inc.                                                             |
+  +-----------------+---------------------------------------------------------------------+
+  | ``tls``         | Reserved for use in thread-local storage routines.                  |
+  +-----------------+---------------------------------------------------------------------+
+  | ``WRS``         | Wind River Systems.                                                 |
+  +-----------------+---------------------------------------------------------------------+

tools/common/check-rst-syntax.sh

@@ -5,6 +5,7 @@ ABI_ROOT=${CURR_DIR}/../..
 
 # 32-bit
 rstcheck --ignore-language=c,cpp ${ABI_ROOT}/addenda32/addenda32.rst
+rstcheck --ignore-language=c,cpp ${ABI_ROOT}/clibabi32/clibabi32.rst
 rstcheck --ignore-language=c,cpp ${ABI_ROOT}/ehabi32/ehabi32.rst
 
 # 64-bit

tools/rst2pdf/generate-pdfs.sh

@@ -16,6 +16,9 @@ mkdir -p ${OUTPUT_DIR}
 rst2pdf ${ABI_ROOT}/addenda32/addenda32.rst -s ${CURR_DIR}/rst2pdf-abi.style \
         --repeat-table-rows --footer="###Page###" -o ${OUTPUT_DIR}/addenda32.pdf
 
+rst2pdf ${ABI_ROOT}/clibabi32/clibabi32.rst -s ${CURR_DIR}/rst2pdf-abi.style \
+        --repeat-table-rows --footer="###Page###" -o ${OUTPUT_DIR}/clibabi32.pdf
+
 rst2pdf ${ABI_ROOT}/ehabi32/ehabi32.rst -s ${CURR_DIR}/rst2pdf-abi.style \
         --repeat-table-rows --footer="###Page###" -o ${OUTPUT_DIR}/ehabi32.pdf
 

tools/rst2pdf/rst2pdf-abi.style

@@ -176,4 +176,49 @@ styles:
 
     addenda32-table-2:
         parent : table
-        colWidths: [ 16%, 10%, 20%, 54% ]
+        colWidths: [ 16%, 10%, 20%, 54% ]
+
+    # clibabi32 styles
+    clibabi32-change-history:
+        parent : table
+        colWidths: [ 10%, 23%, 67% ]
+
+    clibabi32-c-library-headers:
+        parent : table
+        colWidths: [ 12%, 10%, 78% ]
+
+    clibabi32-errno-defs:
+        parent : table
+        colWidths: [ 25%, 25%, 50% ]
+
+    clibabi32-lc-macros:
+        parent : table
+        colWidths: [ 20%, 80% ]
+
+    clibabi32-math-defs:
+        parent : table
+        colWidths: [ 14%, 23%, 44%, 19% ]
+
+    clibabi32-easy-stdio-defs:
+        parent : table
+        colWidths: [ 20%, 29%, 41% ]
+
+    clibabi32-difficult-stdio-defs:
+        parent : table
+        colWidths: [ 19%, 24%, 57% ]
+
+    clibabi32-stdlib-defs:
+        parent : table
+        colWidths: [ 18%, 45%, 37% ]
+
+    clibabi32-time-defs:
+        parent : table
+        colWidths: [ 22%, 78% ]
+
+    clibabi32-wchar-defs:
+        parent : table
+        colWidths: [ 12%, 48%, 40% ]
+
+    clibabi32-summary:
+        parent : table
+        colWidths: [ 12%, 13%, 75% ]