AArch64CallingConvention.td 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500
  1. //=- AArch64CallingConv.td - Calling Conventions for AArch64 -*- tablegen -*-=//
  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 describes the calling conventions for AArch64 architecture.
  10. //
  11. //===----------------------------------------------------------------------===//
  12. /// CCIfBigEndian - Match only if we're in big endian mode.
  13. class CCIfBigEndian<CCAction A> :
  14. CCIf<"State.getMachineFunction().getDataLayout().isBigEndian()", A>;
  15. class CCIfILP32<CCAction A> :
  16. CCIf<"State.getMachineFunction().getDataLayout().getPointerSize() == 4", A>;
  17. //===----------------------------------------------------------------------===//
  18. // ARM AAPCS64 Calling Convention
  19. //===----------------------------------------------------------------------===//
  20. let Entry = 1 in
  21. def CC_AArch64_AAPCS : CallingConv<[
  22. CCIfType<[iPTR], CCBitConvertToType<i64>>,
  23. CCIfType<[v2f32], CCBitConvertToType<v2i32>>,
  24. CCIfType<[v2f64, v4f32], CCBitConvertToType<v2i64>>,
  25. // Big endian vectors must be passed as if they were 1-element vectors so that
  26. // their lanes are in a consistent order.
  27. CCIfBigEndian<CCIfType<[v2i32, v2f32, v4i16, v4f16, v4bf16, v8i8],
  28. CCBitConvertToType<f64>>>,
  29. CCIfBigEndian<CCIfType<[v2i64, v2f64, v4i32, v4f32, v8i16, v8f16, v8bf16, v16i8],
  30. CCBitConvertToType<f128>>>,
  31. // In AAPCS, an SRet is passed in X8, not X0 like a normal pointer parameter.
  32. // However, on windows, in some circumstances, the SRet is passed in X0 or X1
  33. // instead. The presence of the inreg attribute indicates that SRet is
  34. // passed in the alternative register (X0 or X1), not X8:
  35. // - X0 for non-instance methods.
  36. // - X1 for instance methods.
  37. // The "sret" attribute identifies indirect returns.
  38. // The "inreg" attribute identifies non-aggregate types.
  39. // The position of the "sret" attribute identifies instance/non-instance
  40. // methods.
  41. // "sret" on argument 0 means non-instance methods.
  42. // "sret" on argument 1 means instance methods.
  43. CCIfInReg<CCIfType<[i64],
  44. CCIfSRet<CCIfType<[i64], CCAssignToReg<[X0, X1]>>>>>,
  45. CCIfSRet<CCIfType<[i64], CCAssignToReg<[X8]>>>,
  46. // Put ByVal arguments directly on the stack. Minimum size and alignment of a
  47. // slot is 64-bit.
  48. CCIfByVal<CCPassByVal<8, 8>>,
  49. // The 'nest' parameter, if any, is passed in X18.
  50. // Darwin uses X18 as the platform register and hence 'nest' isn't currently
  51. // supported there.
  52. CCIfNest<CCAssignToReg<[X18]>>,
  53. // Pass SwiftSelf in a callee saved register.
  54. CCIfSwiftSelf<CCIfType<[i64], CCAssignToReg<[X20]>>>,
  55. // A SwiftError is passed in X21.
  56. CCIfSwiftError<CCIfType<[i64], CCAssignToReg<[X21]>>>,
  57. // Pass SwiftAsync in an otherwise callee saved register so that it will be
  58. // preserved for normal function calls.
  59. CCIfSwiftAsync<CCIfType<[i64], CCAssignToReg<[X22]>>>,
  60. CCIfConsecutiveRegs<CCCustom<"CC_AArch64_Custom_Block">>,
  61. CCIfType<[nxv16i8, nxv8i16, nxv4i32, nxv2i64, nxv2f16, nxv4f16, nxv8f16,
  62. nxv2bf16, nxv4bf16, nxv8bf16, nxv2f32, nxv4f32, nxv2f64],
  63. CCAssignToReg<[Z0, Z1, Z2, Z3, Z4, Z5, Z6, Z7]>>,
  64. CCIfType<[nxv16i8, nxv8i16, nxv4i32, nxv2i64, nxv2f16, nxv4f16, nxv8f16,
  65. nxv2bf16, nxv4bf16, nxv8bf16, nxv2f32, nxv4f32, nxv2f64],
  66. CCPassIndirect<i64>>,
  67. CCIfType<[nxv2i1, nxv4i1, nxv8i1, nxv16i1],
  68. CCAssignToReg<[P0, P1, P2, P3]>>,
  69. CCIfType<[nxv2i1, nxv4i1, nxv8i1, nxv16i1],
  70. CCPassIndirect<i64>>,
  71. // Handle i1, i8, i16, i32, i64, f32, f64 and v2f64 by passing in registers,
  72. // up to eight each of GPR and FPR.
  73. CCIfType<[i1, i8, i16], CCPromoteToType<i32>>,
  74. CCIfType<[i32], CCAssignToReg<[W0, W1, W2, W3, W4, W5, W6, W7]>>,
  75. // i128 is split to two i64s, we can't fit half to register X7.
  76. CCIfType<[i64], CCIfSplit<CCAssignToRegWithShadow<[X0, X2, X4, X6],
  77. [X0, X1, X3, X5]>>>,
  78. // i128 is split to two i64s, and its stack alignment is 16 bytes.
  79. CCIfType<[i64], CCIfSplit<CCAssignToStackWithShadow<8, 16, [X7]>>>,
  80. CCIfType<[i64], CCAssignToReg<[X0, X1, X2, X3, X4, X5, X6, X7]>>,
  81. CCIfType<[f16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  82. CCIfType<[bf16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  83. CCIfType<[f32], CCAssignToReg<[S0, S1, S2, S3, S4, S5, S6, S7]>>,
  84. CCIfType<[f64], CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  85. CCIfType<[v1i64, v2i32, v4i16, v8i8, v1f64, v2f32, v4f16, v4bf16],
  86. CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  87. CCIfType<[f128, v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  88. CCAssignToReg<[Q0, Q1, Q2, Q3, Q4, Q5, Q6, Q7]>>,
  89. // If more than will fit in registers, pass them on the stack instead.
  90. CCIfType<[i1, i8, i16, f16, bf16], CCAssignToStack<8, 8>>,
  91. CCIfType<[i32, f32], CCAssignToStack<8, 8>>,
  92. CCIfType<[i64, f64, v1f64, v2f32, v1i64, v2i32, v4i16, v8i8, v4f16, v4bf16],
  93. CCAssignToStack<8, 8>>,
  94. CCIfType<[f128, v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  95. CCAssignToStack<16, 16>>
  96. ]>;
  97. let Entry = 1 in
  98. def RetCC_AArch64_AAPCS : CallingConv<[
  99. CCIfType<[iPTR], CCBitConvertToType<i64>>,
  100. CCIfType<[v2f32], CCBitConvertToType<v2i32>>,
  101. CCIfType<[v2f64, v4f32], CCBitConvertToType<v2i64>>,
  102. CCIfConsecutiveRegs<CCCustom<"CC_AArch64_Custom_Block">>,
  103. CCIfSwiftError<CCIfType<[i64], CCAssignToReg<[X21]>>>,
  104. // Big endian vectors must be passed as if they were 1-element vectors so that
  105. // their lanes are in a consistent order.
  106. CCIfBigEndian<CCIfType<[v2i32, v2f32, v4i16, v4f16, v4bf16, v8i8],
  107. CCBitConvertToType<f64>>>,
  108. CCIfBigEndian<CCIfType<[v2i64, v2f64, v4i32, v4f32, v8i16, v8f16, v8bf16, v16i8],
  109. CCBitConvertToType<f128>>>,
  110. CCIfType<[i1, i8, i16], CCPromoteToType<i32>>,
  111. CCIfType<[i32], CCAssignToReg<[W0, W1, W2, W3, W4, W5, W6, W7]>>,
  112. CCIfType<[i64], CCAssignToReg<[X0, X1, X2, X3, X4, X5, X6, X7]>>,
  113. CCIfType<[f16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  114. CCIfType<[bf16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  115. CCIfType<[f32], CCAssignToReg<[S0, S1, S2, S3, S4, S5, S6, S7]>>,
  116. CCIfType<[f64], CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  117. CCIfType<[v1i64, v2i32, v4i16, v8i8, v1f64, v2f32, v4f16, v4bf16],
  118. CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  119. CCIfType<[f128, v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  120. CCAssignToReg<[Q0, Q1, Q2, Q3, Q4, Q5, Q6, Q7]>>,
  121. CCIfType<[nxv16i8, nxv8i16, nxv4i32, nxv2i64, nxv2f16, nxv4f16, nxv8f16,
  122. nxv2bf16, nxv4bf16, nxv8bf16, nxv2f32, nxv4f32, nxv2f64],
  123. CCAssignToReg<[Z0, Z1, Z2, Z3, Z4, Z5, Z6, Z7]>>,
  124. CCIfType<[nxv2i1, nxv4i1, nxv8i1, nxv16i1],
  125. CCAssignToReg<[P0, P1, P2, P3]>>
  126. ]>;
  127. // Vararg functions on windows pass floats in integer registers
  128. let Entry = 1 in
  129. def CC_AArch64_Win64_VarArg : CallingConv<[
  130. CCIfType<[f16, bf16], CCBitConvertToType<i16>>,
  131. CCIfType<[f32], CCBitConvertToType<i32>>,
  132. CCIfType<[f64], CCBitConvertToType<i64>>,
  133. CCDelegateTo<CC_AArch64_AAPCS>
  134. ]>;
  135. // Windows Control Flow Guard checks take a single argument (the target function
  136. // address) and have no return value.
  137. let Entry = 1 in
  138. def CC_AArch64_Win64_CFGuard_Check : CallingConv<[
  139. CCIfType<[i64], CCAssignToReg<[X15]>>
  140. ]>;
  141. // Darwin uses a calling convention which differs in only two ways
  142. // from the standard one at this level:
  143. // + i128s (i.e. split i64s) don't need even registers.
  144. // + Stack slots are sized as needed rather than being at least 64-bit.
  145. let Entry = 1 in
  146. def CC_AArch64_DarwinPCS : CallingConv<[
  147. CCIfType<[iPTR], CCBitConvertToType<i64>>,
  148. CCIfType<[v2f32], CCBitConvertToType<v2i32>>,
  149. CCIfType<[v2f64, v4f32, f128], CCBitConvertToType<v2i64>>,
  150. // An SRet is passed in X8, not X0 like a normal pointer parameter.
  151. CCIfSRet<CCIfType<[i64], CCAssignToReg<[X8]>>>,
  152. // Put ByVal arguments directly on the stack. Minimum size and alignment of a
  153. // slot is 64-bit.
  154. CCIfByVal<CCPassByVal<8, 8>>,
  155. // Pass SwiftSelf in a callee saved register.
  156. CCIfSwiftSelf<CCIfType<[i64], CCAssignToReg<[X20]>>>,
  157. // A SwiftError is passed in X21.
  158. CCIfSwiftError<CCIfType<[i64], CCAssignToReg<[X21]>>>,
  159. // Pass SwiftAsync in an otherwise callee saved register so that it will be
  160. // preserved for normal function calls.
  161. CCIfSwiftAsync<CCIfType<[i64], CCAssignToReg<[X22]>>>,
  162. CCIfConsecutiveRegs<CCCustom<"CC_AArch64_Custom_Block">>,
  163. // Handle i1, i8, i16, i32, i64, f32, f64 and v2f64 by passing in registers,
  164. // up to eight each of GPR and FPR.
  165. CCIfType<[i1, i8, i16], CCPromoteToType<i32>>,
  166. CCIfType<[i32], CCAssignToReg<[W0, W1, W2, W3, W4, W5, W6, W7]>>,
  167. // i128 is split to two i64s, we can't fit half to register X7.
  168. CCIfType<[i64],
  169. CCIfSplit<CCAssignToReg<[X0, X1, X2, X3, X4, X5, X6]>>>,
  170. // i128 is split to two i64s, and its stack alignment is 16 bytes.
  171. CCIfType<[i64], CCIfSplit<CCAssignToStackWithShadow<8, 16, [X7]>>>,
  172. CCIfType<[i64], CCAssignToReg<[X0, X1, X2, X3, X4, X5, X6, X7]>>,
  173. CCIfType<[f16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  174. CCIfType<[bf16], CCAssignToReg<[H0, H1, H2, H3, H4, H5, H6, H7]>>,
  175. CCIfType<[f32], CCAssignToReg<[S0, S1, S2, S3, S4, S5, S6, S7]>>,
  176. CCIfType<[f64], CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  177. CCIfType<[v1i64, v2i32, v4i16, v8i8, v1f64, v2f32, v4f16, v4bf16],
  178. CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>,
  179. CCIfType<[v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  180. CCAssignToReg<[Q0, Q1, Q2, Q3, Q4, Q5, Q6, Q7]>>,
  181. // If more than will fit in registers, pass them on the stack instead.
  182. CCIf<"ValVT == MVT::i1 || ValVT == MVT::i8", CCAssignToStack<1, 1>>,
  183. CCIf<"ValVT == MVT::i16 || ValVT == MVT::f16 || ValVT == MVT::bf16",
  184. CCAssignToStack<2, 2>>,
  185. CCIfType<[i32, f32], CCAssignToStack<4, 4>>,
  186. // Re-demote pointers to 32-bits so we don't end up storing 64-bit
  187. // values and clobbering neighbouring stack locations. Not very pretty.
  188. CCIfPtr<CCIfILP32<CCTruncToType<i32>>>,
  189. CCIfPtr<CCIfILP32<CCAssignToStack<4, 4>>>,
  190. CCIfType<[i64, f64, v1f64, v2f32, v1i64, v2i32, v4i16, v8i8, v4f16, v4bf16],
  191. CCAssignToStack<8, 8>>,
  192. CCIfType<[v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  193. CCAssignToStack<16, 16>>
  194. ]>;
  195. let Entry = 1 in
  196. def CC_AArch64_DarwinPCS_VarArg : CallingConv<[
  197. CCIfType<[iPTR], CCBitConvertToType<i64>>,
  198. CCIfType<[v2f32], CCBitConvertToType<v2i32>>,
  199. CCIfType<[v2f64, v4f32, f128], CCBitConvertToType<v2i64>>,
  200. CCIfConsecutiveRegs<CCCustom<"CC_AArch64_Custom_Stack_Block">>,
  201. // Handle all scalar types as either i64 or f64.
  202. CCIfType<[i8, i16, i32], CCPromoteToType<i64>>,
  203. CCIfType<[f16, bf16, f32], CCPromoteToType<f64>>,
  204. // Everything is on the stack.
  205. // i128 is split to two i64s, and its stack alignment is 16 bytes.
  206. CCIfType<[i64], CCIfSplit<CCAssignToStack<8, 16>>>,
  207. CCIfType<[i64, f64, v1i64, v2i32, v4i16, v8i8, v1f64, v2f32, v4f16, v4bf16],
  208. CCAssignToStack<8, 8>>,
  209. CCIfType<[v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  210. CCAssignToStack<16, 16>>
  211. ]>;
  212. // In the ILP32 world, the minimum stack slot size is 4 bytes. Otherwise the
  213. // same as the normal Darwin VarArgs handling.
  214. let Entry = 1 in
  215. def CC_AArch64_DarwinPCS_ILP32_VarArg : CallingConv<[
  216. CCIfType<[v2f32], CCBitConvertToType<v2i32>>,
  217. CCIfType<[v2f64, v4f32, f128], CCBitConvertToType<v2i64>>,
  218. // Handle all scalar types as either i32 or f32.
  219. CCIfType<[i8, i16], CCPromoteToType<i32>>,
  220. CCIfType<[f16, bf16], CCPromoteToType<f32>>,
  221. // Everything is on the stack.
  222. // i128 is split to two i64s, and its stack alignment is 16 bytes.
  223. CCIfPtr<CCIfILP32<CCTruncToType<i32>>>,
  224. CCIfType<[i32, f32], CCAssignToStack<4, 4>>,
  225. CCIfType<[i64], CCIfSplit<CCAssignToStack<8, 16>>>,
  226. CCIfType<[i64, f64, v1i64, v2i32, v4i16, v8i8, v1f64, v2f32, v4f16, v4bf16],
  227. CCAssignToStack<8, 8>>,
  228. CCIfType<[v2i64, v4i32, v8i16, v16i8, v4f32, v2f64, v8f16, v8bf16],
  229. CCAssignToStack<16, 16>>
  230. ]>;
  231. // The WebKit_JS calling convention only passes the first argument (the callee)
  232. // in register and the remaining arguments on stack. We allow 32bit stack slots,
  233. // so that WebKit can write partial values in the stack and define the other
  234. // 32bit quantity as undef.
  235. let Entry = 1 in
  236. def CC_AArch64_WebKit_JS : CallingConv<[
  237. // Handle i1, i8, i16, i32, and i64 passing in register X0 (W0).
  238. CCIfType<[i1, i8, i16], CCPromoteToType<i32>>,
  239. CCIfType<[i32], CCAssignToReg<[W0]>>,
  240. CCIfType<[i64], CCAssignToReg<[X0]>>,
  241. // Pass the remaining arguments on the stack instead.
  242. CCIfType<[i32, f32], CCAssignToStack<4, 4>>,
  243. CCIfType<[i64, f64], CCAssignToStack<8, 8>>
  244. ]>;
  245. let Entry = 1 in
  246. def RetCC_AArch64_WebKit_JS : CallingConv<[
  247. CCIfType<[i32], CCAssignToReg<[W0, W1, W2, W3, W4, W5, W6, W7]>>,
  248. CCIfType<[i64], CCAssignToReg<[X0, X1, X2, X3, X4, X5, X6, X7]>>,
  249. CCIfType<[f32], CCAssignToReg<[S0, S1, S2, S3, S4, S5, S6, S7]>>,
  250. CCIfType<[f64], CCAssignToReg<[D0, D1, D2, D3, D4, D5, D6, D7]>>
  251. ]>;
  252. //===----------------------------------------------------------------------===//
  253. // ARM64 Calling Convention for GHC
  254. //===----------------------------------------------------------------------===//
  255. // This calling convention is specific to the Glasgow Haskell Compiler.
  256. // The only documentation is the GHC source code, specifically the C header
  257. // file:
  258. //
  259. // https://github.com/ghc/ghc/blob/master/includes/stg/MachRegs.h
  260. //
  261. // which defines the registers for the Spineless Tagless G-Machine (STG) that
  262. // GHC uses to implement lazy evaluation. The generic STG machine has a set of
  263. // registers which are mapped to appropriate set of architecture specific
  264. // registers for each CPU architecture.
  265. //
  266. // The STG Machine is documented here:
  267. //
  268. // https://ghc.haskell.org/trac/ghc/wiki/Commentary/Compiler/GeneratedCode
  269. //
  270. // The AArch64 register mapping is under the heading "The ARMv8/AArch64 ABI
  271. // register mapping".
  272. let Entry = 1 in
  273. def CC_AArch64_GHC : CallingConv<[
  274. CCIfType<[iPTR], CCBitConvertToType<i64>>,
  275. // Handle all vector types as either f64 or v2f64.
  276. CCIfType<[v1i64, v2i32, v4i16, v8i8, v2f32], CCBitConvertToType<f64>>,
  277. CCIfType<[v2i64, v4i32, v8i16, v16i8, v4f32, f128], CCBitConvertToType<v2f64>>,
  278. CCIfType<[v2f64], CCAssignToReg<[Q4, Q5]>>,
  279. CCIfType<[f32], CCAssignToReg<[S8, S9, S10, S11]>>,
  280. CCIfType<[f64], CCAssignToReg<[D12, D13, D14, D15]>>,
  281. // Promote i8/i16/i32 arguments to i64.
  282. CCIfType<[i8, i16, i32], CCPromoteToType<i64>>,
  283. // Pass in STG registers: Base, Sp, Hp, R1, R2, R3, R4, R5, R6, SpLim
  284. CCIfType<[i64], CCAssignToReg<[X19, X20, X21, X22, X23, X24, X25, X26, X27, X28]>>
  285. ]>;
  286. // The order of the callee-saves in this file is important, because the
  287. // FrameLowering code will use this order to determine the layout the
  288. // callee-save area in the stack frame. As can be observed below, Darwin
  289. // requires the frame-record (LR, FP) to be at the top the callee-save area,
  290. // whereas for other platforms they are at the bottom.
  291. // FIXME: LR is only callee-saved in the sense that *we* preserve it and are
  292. // presumably a callee to someone. External functions may not do so, but this
  293. // is currently safe since BL has LR as an implicit-def and what happens after a
  294. // tail call doesn't matter.
  295. //
  296. // It would be better to model its preservation semantics properly (create a
  297. // vreg on entry, use it in RET & tail call generation; make that vreg def if we
  298. // end up saving LR as part of a call frame). Watch this space...
  299. def CSR_AArch64_AAPCS : CalleeSavedRegs<(add X19, X20, X21, X22, X23, X24,
  300. X25, X26, X27, X28, LR, FP,
  301. D8, D9, D10, D11,
  302. D12, D13, D14, D15)>;
  303. // A variant for treating X18 as callee saved, when interfacing with
  304. // code that needs X18 to be preserved.
  305. def CSR_AArch64_AAPCS_X18 : CalleeSavedRegs<(add X18, CSR_AArch64_AAPCS)>;
  306. // Win64 has unwinding codes for an (FP,LR) pair, save_fplr and save_fplr_x.
  307. // We put FP before LR, so that frame lowering logic generates (FP,LR) pairs,
  308. // and not (LR,FP) pairs.
  309. def CSR_Win_AArch64_AAPCS : CalleeSavedRegs<(add X19, X20, X21, X22, X23, X24,
  310. X25, X26, X27, X28, FP, LR,
  311. D8, D9, D10, D11,
  312. D12, D13, D14, D15)>;
  313. // The Control Flow Guard check call uses a custom calling convention that also
  314. // preserves X0-X8 and Q0-Q7.
  315. def CSR_Win_AArch64_CFGuard_Check : CalleeSavedRegs<(add CSR_Win_AArch64_AAPCS,
  316. (sequence "X%u", 0, 8),
  317. (sequence "Q%u", 0, 7))>;
  318. // AArch64 PCS for vector functions (VPCS)
  319. // must (additionally) preserve full Q8-Q23 registers
  320. def CSR_AArch64_AAVPCS : CalleeSavedRegs<(add X19, X20, X21, X22, X23, X24,
  321. X25, X26, X27, X28, LR, FP,
  322. (sequence "Q%u", 8, 23))>;
  323. // Functions taking SVE arguments or returning an SVE type
  324. // must (additionally) preserve full Z8-Z23 and predicate registers P4-P15
  325. def CSR_AArch64_SVE_AAPCS : CalleeSavedRegs<(add (sequence "Z%u", 8, 23),
  326. (sequence "P%u", 4, 15),
  327. X19, X20, X21, X22, X23, X24,
  328. X25, X26, X27, X28, LR, FP)>;
  329. def CSR_AArch64_AAPCS_SwiftTail
  330. : CalleeSavedRegs<(sub CSR_AArch64_AAPCS, X20, X22)>;
  331. // Constructors and destructors return 'this' in the iOS 64-bit C++ ABI; since
  332. // 'this' and the pointer return value are both passed in X0 in these cases,
  333. // this can be partially modelled by treating X0 as a callee-saved register;
  334. // only the resulting RegMask is used; the SaveList is ignored
  335. //
  336. // (For generic ARM 64-bit ABI code, clang will not generate constructors or
  337. // destructors with 'this' returns, so this RegMask will not be used in that
  338. // case)
  339. def CSR_AArch64_AAPCS_ThisReturn : CalleeSavedRegs<(add CSR_AArch64_AAPCS, X0)>;
  340. def CSR_AArch64_AAPCS_SwiftError
  341. : CalleeSavedRegs<(sub CSR_AArch64_AAPCS, X21)>;
  342. // The ELF stub used for TLS-descriptor access saves every feasible
  343. // register. Only X0 and LR are clobbered.
  344. def CSR_AArch64_TLS_ELF
  345. : CalleeSavedRegs<(add (sequence "X%u", 1, 28), FP,
  346. (sequence "Q%u", 0, 31))>;
  347. def CSR_AArch64_AllRegs
  348. : CalleeSavedRegs<(add (sequence "W%u", 0, 30), WSP,
  349. (sequence "X%u", 0, 28), FP, LR, SP,
  350. (sequence "B%u", 0, 31), (sequence "H%u", 0, 31),
  351. (sequence "S%u", 0, 31), (sequence "D%u", 0, 31),
  352. (sequence "Q%u", 0, 31))>;
  353. def CSR_AArch64_NoRegs : CalleeSavedRegs<(add)>;
  354. def CSR_AArch64_RT_MostRegs : CalleeSavedRegs<(add CSR_AArch64_AAPCS,
  355. (sequence "X%u", 9, 15))>;
  356. def CSR_AArch64_StackProbe_Windows
  357. : CalleeSavedRegs<(add (sequence "X%u", 0, 15),
  358. (sequence "X%u", 18, 28), FP, SP,
  359. (sequence "Q%u", 0, 31))>;
  360. // Darwin variants of AAPCS.
  361. // Darwin puts the frame-record at the top of the callee-save area.
  362. def CSR_Darwin_AArch64_AAPCS : CalleeSavedRegs<(add LR, FP, X19, X20, X21, X22,
  363. X23, X24, X25, X26, X27, X28,
  364. D8, D9, D10, D11,
  365. D12, D13, D14, D15)>;
  366. def CSR_Darwin_AArch64_AAVPCS : CalleeSavedRegs<(add LR, FP, X19, X20, X21,
  367. X22, X23, X24, X25, X26, X27,
  368. X28, (sequence "Q%u", 8, 23))>;
  369. def CSR_Darwin_AArch64_AAPCS_ThisReturn
  370. : CalleeSavedRegs<(add CSR_Darwin_AArch64_AAPCS, X0)>;
  371. def CSR_Darwin_AArch64_AAPCS_SwiftError
  372. : CalleeSavedRegs<(sub CSR_Darwin_AArch64_AAPCS, X21)>;
  373. def CSR_Darwin_AArch64_AAPCS_SwiftTail
  374. : CalleeSavedRegs<(sub CSR_Darwin_AArch64_AAPCS, X20, X22)>;
  375. // The function used by Darwin to obtain the address of a thread-local variable
  376. // guarantees more than a normal AAPCS function. x16 and x17 are used on the
  377. // fast path for calculation, but other registers except X0 (argument/return)
  378. // and LR (it is a call, after all) are preserved.
  379. def CSR_Darwin_AArch64_TLS
  380. : CalleeSavedRegs<(add (sub (sequence "X%u", 1, 28), X16, X17),
  381. FP,
  382. (sequence "Q%u", 0, 31))>;
  383. // We can only handle a register pair with adjacent registers, the register pair
  384. // should belong to the same class as well. Since the access function on the
  385. // fast path calls a function that follows CSR_Darwin_AArch64_TLS,
  386. // CSR_Darwin_AArch64_CXX_TLS should be a subset of CSR_Darwin_AArch64_TLS.
  387. def CSR_Darwin_AArch64_CXX_TLS
  388. : CalleeSavedRegs<(add CSR_Darwin_AArch64_AAPCS,
  389. (sub (sequence "X%u", 1, 28), X9, X15, X16, X17, X18, X19),
  390. (sequence "D%u", 0, 31))>;
  391. // CSRs that are handled by prologue, epilogue.
  392. def CSR_Darwin_AArch64_CXX_TLS_PE
  393. : CalleeSavedRegs<(add LR, FP)>;
  394. // CSRs that are handled explicitly via copies.
  395. def CSR_Darwin_AArch64_CXX_TLS_ViaCopy
  396. : CalleeSavedRegs<(sub CSR_Darwin_AArch64_CXX_TLS, LR, FP)>;
  397. def CSR_Darwin_AArch64_RT_MostRegs
  398. : CalleeSavedRegs<(add CSR_Darwin_AArch64_AAPCS, (sequence "X%u", 9, 15))>;
  399. // Variants of the standard calling conventions for shadow call stack.
  400. // These all preserve x18 in addition to any other registers.
  401. def CSR_AArch64_NoRegs_SCS
  402. : CalleeSavedRegs<(add CSR_AArch64_NoRegs, X18)>;
  403. def CSR_AArch64_AllRegs_SCS
  404. : CalleeSavedRegs<(add CSR_AArch64_AllRegs, X18)>;
  405. def CSR_AArch64_AAPCS_SwiftError_SCS
  406. : CalleeSavedRegs<(add CSR_AArch64_AAPCS_SwiftError, X18)>;
  407. def CSR_AArch64_RT_MostRegs_SCS
  408. : CalleeSavedRegs<(add CSR_AArch64_RT_MostRegs, X18)>;
  409. def CSR_AArch64_AAVPCS_SCS
  410. : CalleeSavedRegs<(add CSR_AArch64_AAVPCS, X18)>;
  411. def CSR_AArch64_SVE_AAPCS_SCS
  412. : CalleeSavedRegs<(add CSR_AArch64_SVE_AAPCS, X18)>;
  413. def CSR_AArch64_AAPCS_SCS
  414. : CalleeSavedRegs<(add CSR_AArch64_AAPCS, X18)>;