1 //===-- llvm/CallingConv.h - LLVM Calling Conventions -----------*- C++ -*-===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // This file defines LLVM's set of calling conventions. 11 // 12 //===----------------------------------------------------------------------===// 13 14 #ifndef LLVM_IR_CALLINGCONV_H 15 #define LLVM_IR_CALLINGCONV_H 16 17 namespace llvm { 18 19 /// CallingConv Namespace - This namespace contains an enum with a value for 20 /// the well-known calling conventions. 21 /// 22 namespace CallingConv { 23 /// LLVM IR allows to use arbitrary numbers as calling convention identifiers. 24 typedef unsigned ID; 25 26 /// A set of enums which specify the assigned numeric values for known llvm 27 /// calling conventions. 28 /// @brief LLVM Calling Convention Representation 29 enum { 30 /// C - The default llvm calling convention, compatible with C. This 31 /// convention is the only calling convention that supports varargs calls. 32 /// As with typical C calling conventions, the callee/caller have to 33 /// tolerate certain amounts of prototype mismatch. 34 C = 0, 35 36 // Generic LLVM calling conventions. None of these calling conventions 37 // support varargs calls, and all assume that the caller and callee 38 // prototype exactly match. 39 40 /// Fast - This calling convention attempts to make calls as fast as 41 /// possible (e.g. by passing things in registers). 42 Fast = 8, 43 44 // Cold - This calling convention attempts to make code in the caller as 45 // efficient as possible under the assumption that the call is not commonly 46 // executed. As such, these calls often preserve all registers so that the 47 // call does not break any live ranges in the caller side. 48 Cold = 9, 49 50 // GHC - Calling convention used by the Glasgow Haskell Compiler (GHC). 51 GHC = 10, 52 53 // HiPE - Calling convention used by the High-Performance Erlang Compiler 54 // (HiPE). 55 HiPE = 11, 56 57 // WebKit JS - Calling convention for stack based JavaScript calls 58 WebKit_JS = 12, 59 60 // AnyReg - Calling convention for dynamic register based calls (e.g. 61 // stackmap and patchpoint intrinsics). 62 AnyReg = 13, 63 64 // PreserveMost - Calling convention for runtime calls that preserves most 65 // registers. 66 PreserveMost = 14, 67 68 // PreserveAll - Calling convention for runtime calls that preserves 69 // (almost) all registers. 70 PreserveAll = 15, 71 72 // Target - This is the start of the target-specific calling conventions, 73 // e.g. fastcall and thiscall on X86. 74 FirstTargetCC = 64, 75 76 /// X86_StdCall - stdcall is the calling conventions mostly used by the 77 /// Win32 API. It is basically the same as the C convention with the 78 /// difference in that the callee is responsible for popping the arguments 79 /// from the stack. 80 X86_StdCall = 64, 81 82 /// X86_FastCall - 'fast' analog of X86_StdCall. Passes first two arguments 83 /// in ECX:EDX registers, others - via stack. Callee is responsible for 84 /// stack cleaning. 85 X86_FastCall = 65, 86 87 /// ARM_APCS - ARM Procedure Calling Standard calling convention (obsolete, 88 /// but still used on some targets). 89 ARM_APCS = 66, 90 91 /// ARM_AAPCS - ARM Architecture Procedure Calling Standard calling 92 /// convention (aka EABI). Soft float variant. 93 ARM_AAPCS = 67, 94 95 /// ARM_AAPCS_VFP - Same as ARM_AAPCS, but uses hard floating point ABI. 96 ARM_AAPCS_VFP = 68, 97 98 /// MSP430_INTR - Calling convention used for MSP430 interrupt routines. 99 MSP430_INTR = 69, 100 101 /// X86_ThisCall - Similar to X86_StdCall. Passes first argument in ECX, 102 /// others via stack. Callee is responsible for stack cleaning. MSVC uses 103 /// this by default for methods in its ABI. 104 X86_ThisCall = 70, 105 106 /// PTX_Kernel - Call to a PTX kernel. 107 /// Passes all arguments in parameter space. 108 PTX_Kernel = 71, 109 110 /// PTX_Device - Call to a PTX device function. 111 /// Passes all arguments in register or parameter space. 112 PTX_Device = 72, 113 114 /// SPIR_FUNC - Calling convention for SPIR non-kernel device functions. 115 /// No lowering or expansion of arguments. 116 /// Structures are passed as a pointer to a struct with the byval attribute. 117 /// Functions can only call SPIR_FUNC and SPIR_KERNEL functions. 118 /// Functions can only have zero or one return values. 119 /// Variable arguments are not allowed, except for printf. 120 /// How arguments/return values are lowered are not specified. 121 /// Functions are only visible to the devices. 122 SPIR_FUNC = 75, 123 124 /// SPIR_KERNEL - Calling convention for SPIR kernel functions. 125 /// Inherits the restrictions of SPIR_FUNC, except 126 /// Cannot have non-void return values. 127 /// Cannot have variable arguments. 128 /// Can also be called by the host. 129 /// Is externally visible. 130 SPIR_KERNEL = 76, 131 132 /// Intel_OCL_BI - Calling conventions for Intel OpenCL built-ins 133 Intel_OCL_BI = 77, 134 135 /// \brief The C convention as specified in the x86-64 supplement to the 136 /// System V ABI, used on most non-Windows systems. 137 X86_64_SysV = 78, 138 139 /// \brief The C convention as implemented on Windows/x86-64. This 140 /// convention differs from the more common \c X86_64_SysV convention 141 /// in a number of ways, most notably in that XMM registers used to pass 142 /// arguments are shadowed by GPRs, and vice versa. 143 X86_64_Win64 = 79, 144 145 /// \brief MSVC calling convention that passes vectors and vector aggregates 146 /// in SSE registers. 147 X86_VectorCall = 80 148 }; 149 } // End CallingConv namespace 150 151 } // End llvm namespace 152 153 #endif 154