mirror of
https://github.com/ldc-developers/ldc.git
synced 2025-05-06 19:06:02 +03:00
98 lines
3 KiB
C++
98 lines
3 KiB
C++
//===-- gen/abi.h - Target ABI description for IR generation ----*- C++ -*-===//
|
||
//
|
||
// LDC – the LLVM D compiler
|
||
//
|
||
// This file is distributed under the BSD-style LDC license. See the LICENSE
|
||
// file for details.
|
||
//
|
||
//===----------------------------------------------------------------------===//
|
||
//
|
||
// This interface is used by the IR generation code to accomodate any
|
||
// additional transformations necessary for the given target ABI (the direct
|
||
// LLVM IR representation for C structs unfortunately does not always lead to
|
||
// the right ABI, for example on x86_64).
|
||
//
|
||
//===----------------------------------------------------------------------===//
|
||
|
||
#ifndef LDC_GEN_ABI_H
|
||
#define LDC_GEN_ABI_H
|
||
|
||
#include "mars.h"
|
||
#if LDC_LLVM_VER >= 303
|
||
#include "llvm/IR/CallingConv.h"
|
||
#else
|
||
#include "llvm/CallingConv.h"
|
||
#endif
|
||
#include <vector>
|
||
|
||
struct Type;
|
||
struct TypeFunction;
|
||
struct IrFuncTy;
|
||
struct IrFuncTyArg;
|
||
class DValue;
|
||
|
||
namespace llvm
|
||
{
|
||
class Type;
|
||
class Value;
|
||
}
|
||
|
||
// return rewrite rule
|
||
struct ABIRewrite
|
||
{
|
||
virtual ~ABIRewrite() {}
|
||
|
||
/// get a rewritten value back to its original form
|
||
virtual llvm::Value* get(Type* dty, DValue* v) = 0;
|
||
|
||
/// get a rewritten value back to its original form and store result in provided lvalue
|
||
/// this one is optional and defaults to calling the one above
|
||
virtual void getL(Type* dty, DValue* v, llvm::Value* lval);
|
||
|
||
/// put out rewritten value
|
||
virtual llvm::Value* put(Type* dty, DValue* v) = 0;
|
||
|
||
/// should return the transformed type for this rewrite
|
||
virtual llvm::Type* type(Type* dty, llvm::Type* t) = 0;
|
||
};
|
||
|
||
// interface called by codegen
|
||
struct TargetABI
|
||
{
|
||
virtual ~TargetABI() {}
|
||
|
||
/// Returns the ABI for the target we're compiling for
|
||
static TargetABI* getTarget();
|
||
|
||
/// Returns the ABI for intrinsics
|
||
static TargetABI* getIntrinsic();
|
||
|
||
/// Returns the LLVM calling convention to be used for the given D linkage
|
||
/// type on the target.
|
||
virtual llvm::CallingConv::ID callingConv(LINK l) = 0;
|
||
|
||
/// Applies any rewrites that might be required to accurately reproduce the
|
||
/// passed function name on LLVM given a specific calling convention.
|
||
///
|
||
/// Using this function at a stage where the name could be user-visible is
|
||
/// almost certainly a mistake; it is intended to e.g. prepend '\1' where
|
||
/// disabling the LLVM-internal name mangling/postprocessing is required.
|
||
virtual std::string mangleForLLVM(llvm::StringRef name, LINK l) { return name; }
|
||
|
||
/// Called if a new function type is resolved
|
||
virtual void newFunctionType(TypeFunction* tf) {}
|
||
|
||
/// Returns true if the return value is passed in a register
|
||
virtual bool returnInArg(TypeFunction* tf) = 0;
|
||
|
||
/// Returns true if the type is passed by value
|
||
virtual bool passByVal(Type* t) = 0;
|
||
|
||
/// Called to give ABI the chance to rewrite the types
|
||
virtual void rewriteFunctionType(TypeFunction* t, IrFuncTy &fty) = 0;
|
||
|
||
/// Called if resolution of new function type is done
|
||
virtual void doneWithFunctionType() {}
|
||
};
|
||
|
||
#endif
|