Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
14 | pmbaty | 1 | //===--- TargetCXXABI.def - Target C++ ABI database --------------- C++ -*-===// |
2 | // |
||
3 | // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
||
4 | // See https://llvm.org/LICENSE.txt for license information. |
||
5 | // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
||
6 | // |
||
7 | //===----------------------------------------------------------------------===// |
||
8 | // |
||
9 | // This file defines the various C++ ABI kinds used on different platforms. |
||
10 | // Users of this file must define the CXXABI macro to make use of this |
||
11 | // information. |
||
12 | // |
||
13 | //===----------------------------------------------------------------------===// |
||
14 | |||
15 | #ifndef CXXABI |
||
16 | #error Define the CXXABI macro to handle C++ ABI kinds. |
||
17 | #endif |
||
18 | |||
19 | #ifndef ITANIUM_CXXABI |
||
20 | #define ITANIUM_CXXABI(Name, Str) CXXABI(Name, Str) |
||
21 | #endif |
||
22 | |||
23 | #ifndef MICROSOFT_CXXABI |
||
24 | #define MICROSOFT_CXXABI(Name, Str) CXXABI(Name, Str) |
||
25 | #endif |
||
26 | |||
27 | /// The generic Itanium ABI is the standard ABI of most open-source |
||
28 | /// and Unix-like platforms. It is the primary ABI targeted by |
||
29 | /// many compilers, including Clang and GCC. |
||
30 | /// |
||
31 | /// It is documented here: |
||
32 | /// http://www.codesourcery.com/public/cxx-abi/ |
||
33 | ITANIUM_CXXABI(GenericItanium, "itanium") |
||
34 | |||
35 | /// The generic ARM ABI is a modified version of the Itanium ABI |
||
36 | /// proposed by ARM for use on ARM-based platforms. |
||
37 | /// |
||
38 | /// These changes include: |
||
39 | /// - the representation of member function pointers is adjusted |
||
40 | /// to not conflict with the 'thumb' bit of ARM function pointers; |
||
41 | /// - constructors and destructors return 'this'; |
||
42 | /// - guard variables are smaller; |
||
43 | /// - inline functions are never key functions; |
||
44 | /// - array cookies have a slightly different layout; |
||
45 | /// - additional convenience functions are specified; |
||
46 | /// - and more! |
||
47 | /// |
||
48 | /// It is documented here: |
||
49 | /// http://infocenter.arm.com |
||
50 | /// /help/topic/com.arm.doc.ihi0041c/IHI0041C_cppabi.pdf |
||
51 | ITANIUM_CXXABI(GenericARM, "arm") |
||
52 | |||
53 | /// The iOS ABI is a partial implementation of the ARM ABI. |
||
54 | /// Several of the features of the ARM ABI were not fully implemented |
||
55 | /// in the compilers that iOS was launched with. |
||
56 | /// |
||
57 | /// Essentially, the iOS ABI includes the ARM changes to: |
||
58 | /// - member function pointers, |
||
59 | /// - guard variables, |
||
60 | /// - array cookies, and |
||
61 | /// - constructor/destructor signatures. |
||
62 | ITANIUM_CXXABI(iOS, "ios") |
||
63 | |||
64 | /// The iOS 64-bit and macOS 64-bit ARM ABI follows ARM's published 64-bit |
||
65 | /// ABI more closely, but we don't guarantee to follow it perfectly. |
||
66 | /// |
||
67 | /// It is documented here: |
||
68 | /// http://infocenter.arm.com |
||
69 | /// /help/topic/com.arm.doc.ihi0059a/IHI0059A_cppabi64.pdf |
||
70 | ITANIUM_CXXABI(AppleARM64, "applearm64") |
||
71 | |||
72 | /// WatchOS is a modernisation of the iOS ABI, which roughly means it's |
||
73 | /// the iOS64 ABI ported to 32-bits. The primary difference from iOS64 is |
||
74 | /// that RTTI objects must still be unique at the moment. |
||
75 | ITANIUM_CXXABI(WatchOS, "watchos") |
||
76 | |||
77 | /// The generic AArch64 ABI is also a modified version of the Itanium ABI, |
||
78 | /// but it has fewer divergences than the 32-bit ARM ABI. |
||
79 | /// |
||
80 | /// The relevant changes from the generic ABI in this case are: |
||
81 | /// - representation of member function pointers adjusted as in ARM. |
||
82 | /// - guard variables are smaller. |
||
83 | ITANIUM_CXXABI(GenericAArch64, "aarch64") |
||
84 | |||
85 | /// The generic Mips ABI is a modified version of the Itanium ABI. |
||
86 | /// |
||
87 | /// At the moment, only change from the generic ABI in this case is: |
||
88 | /// - representation of member function pointers adjusted as in ARM. |
||
89 | ITANIUM_CXXABI(GenericMIPS, "mips") |
||
90 | |||
91 | /// The WebAssembly ABI is a modified version of the Itanium ABI. |
||
92 | /// |
||
93 | /// The changes from the Itanium ABI are: |
||
94 | /// - representation of member function pointers is adjusted, as in ARM; |
||
95 | /// - member functions are not specially aligned; |
||
96 | /// - constructors and destructors return 'this', as in ARM; |
||
97 | /// - guard variables are 32-bit on wasm32, as in ARM; |
||
98 | /// - unused bits of guard variables are reserved, as in ARM; |
||
99 | /// - inline functions are never key functions, as in ARM; |
||
100 | /// - C++11 POD rules are used for tail padding, as in iOS64. |
||
101 | /// |
||
102 | /// TODO: At present the WebAssembly ABI is not considered stable, so none |
||
103 | /// of these details is necessarily final yet. |
||
104 | ITANIUM_CXXABI(WebAssembly, "webassembly") |
||
105 | |||
106 | /// The Fuchsia ABI is a modified version of the Itanium ABI. |
||
107 | /// |
||
108 | /// The relevant changes from the Itanium ABI are: |
||
109 | /// - constructors and destructors return 'this', as in ARM. |
||
110 | ITANIUM_CXXABI(Fuchsia, "fuchsia") |
||
111 | |||
112 | /// The XL ABI is the ABI used by IBM xlclang compiler and is a modified |
||
113 | /// version of the Itanium ABI. |
||
114 | /// |
||
115 | /// The relevant changes from the Itanium ABI are: |
||
116 | /// - static initialization is adjusted to use sinit and sterm functions; |
||
117 | ITANIUM_CXXABI(XL, "xl") |
||
118 | |||
119 | /// The Microsoft ABI is the ABI used by Microsoft Visual Studio (and |
||
120 | /// compatible compilers). |
||
121 | /// |
||
122 | /// FIXME: should this be split into Win32 and Win64 variants? |
||
123 | /// |
||
124 | /// Only scattered and incomplete official documentation exists. |
||
125 | MICROSOFT_CXXABI(Microsoft, "microsoft") |
||
126 | |||
127 | #undef CXXABI |
||
128 | #undef ITANIUM_CXXABI |
||
129 | #undef MICROSOFT_CXXABI |