//===- ir.go - Bindings for ir --------------------------------------------===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// // // This file defines bindings for the ir component. // //===----------------------------------------------------------------------===// package llvm /* #include "llvm-c/Core.h" #include "llvm-c/Comdat.h" #include "IRBindings.h" #include */ import "C" import "unsafe" import "errors" type ( // We use these weird structs here because *Ref types are pointers and // Go's spec says that a pointer cannot be used as a receiver base type. Context struct { C C.LLVMContextRef } Module struct { C C.LLVMModuleRef } Type struct { C C.LLVMTypeRef } Value struct { C C.LLVMValueRef } Comdat struct { C C.LLVMComdatRef } BasicBlock struct { C C.LLVMBasicBlockRef } Builder struct { C C.LLVMBuilderRef } ModuleProvider struct { C C.LLVMModuleProviderRef } MemoryBuffer struct { C C.LLVMMemoryBufferRef } PassManager struct { C C.LLVMPassManagerRef } Use struct { C C.LLVMUseRef } Metadata struct { C C.LLVMMetadataRef } Attribute struct { C C.LLVMAttributeRef } Opcode C.LLVMOpcode AtomicRMWBinOp C.LLVMAtomicRMWBinOp AtomicOrdering C.LLVMAtomicOrdering TypeKind C.LLVMTypeKind Linkage C.LLVMLinkage Visibility C.LLVMVisibility CallConv C.LLVMCallConv ComdatSelectionKind C.LLVMComdatSelectionKind IntPredicate C.LLVMIntPredicate FloatPredicate C.LLVMRealPredicate LandingPadClause C.LLVMLandingPadClauseTy InlineAsmDialect C.LLVMInlineAsmDialect ) func (c Context) IsNil() bool { return c.C == nil } func (c Module) IsNil() bool { return c.C == nil } func (c Type) IsNil() bool { return c.C == nil } func (c Value) IsNil() bool { return c.C == nil } func (c BasicBlock) IsNil() bool { return c.C == nil } func (c Builder) IsNil() bool { return c.C == nil } func (c ModuleProvider) IsNil() bool { return c.C == nil } func (c MemoryBuffer) IsNil() bool { return c.C == nil } func (c PassManager) IsNil() bool { return c.C == nil } func (c Use) IsNil() bool { return c.C == nil } func (c Attribute) IsNil() bool { return c.C == nil } func (c Metadata) IsNil() bool { return c.C == nil } // helpers func llvmTypeRefPtr(t *Type) *C.LLVMTypeRef { return (*C.LLVMTypeRef)(unsafe.Pointer(t)) } func llvmValueRefPtr(t *Value) *C.LLVMValueRef { return (*C.LLVMValueRef)(unsafe.Pointer(t)) } func llvmMetadataRefPtr(t *Metadata) *C.LLVMMetadataRef { return (*C.LLVMMetadataRef)(unsafe.Pointer(t)) } func llvmBasicBlockRefPtr(t *BasicBlock) *C.LLVMBasicBlockRef { return (*C.LLVMBasicBlockRef)(unsafe.Pointer(t)) } func boolToLLVMBool(b bool) C.LLVMBool { if b { return C.LLVMBool(1) } return C.LLVMBool(0) } func llvmValueRefs(values []Value) (*C.LLVMValueRef, C.unsigned) { var pt *C.LLVMValueRef ptlen := C.unsigned(len(values)) if ptlen > 0 { pt = llvmValueRefPtr(&values[0]) } return pt, ptlen } func llvmMetadataRefs(mds []Metadata) (*C.LLVMMetadataRef, C.unsigned) { var pt *C.LLVMMetadataRef ptlen := C.unsigned(len(mds)) if ptlen > 0 { pt = llvmMetadataRefPtr(&mds[0]) } return pt, ptlen } //------------------------------------------------------------------------- // llvm.Opcode //------------------------------------------------------------------------- const ( Ret Opcode = C.LLVMRet Br Opcode = C.LLVMBr Switch Opcode = C.LLVMSwitch IndirectBr Opcode = C.LLVMIndirectBr Invoke Opcode = C.LLVMInvoke Unreachable Opcode = C.LLVMUnreachable // Standard Binary Operators Add Opcode = C.LLVMAdd FAdd Opcode = C.LLVMFAdd Sub Opcode = C.LLVMSub FSub Opcode = C.LLVMFSub Mul Opcode = C.LLVMMul FMul Opcode = C.LLVMFMul UDiv Opcode = C.LLVMUDiv SDiv Opcode = C.LLVMSDiv FDiv Opcode = C.LLVMFDiv URem Opcode = C.LLVMURem SRem Opcode = C.LLVMSRem FRem Opcode = C.LLVMFRem // Logical Operators Shl Opcode = C.LLVMShl LShr Opcode = C.LLVMLShr AShr Opcode = C.LLVMAShr And Opcode = C.LLVMAnd Or Opcode = C.LLVMOr Xor Opcode = C.LLVMXor // Memory Operators Alloca Opcode = C.LLVMAlloca Load Opcode = C.LLVMLoad Store Opcode = C.LLVMStore GetElementPtr Opcode = C.LLVMGetElementPtr // Cast Operators Trunc Opcode = C.LLVMTrunc ZExt Opcode = C.LLVMZExt SExt Opcode = C.LLVMSExt FPToUI Opcode = C.LLVMFPToUI FPToSI Opcode = C.LLVMFPToSI UIToFP Opcode = C.LLVMUIToFP SIToFP Opcode = C.LLVMSIToFP FPTrunc Opcode = C.LLVMFPTrunc FPExt Opcode = C.LLVMFPExt PtrToInt Opcode = C.LLVMPtrToInt IntToPtr Opcode = C.LLVMIntToPtr BitCast Opcode = C.LLVMBitCast // Other Operators ICmp Opcode = C.LLVMICmp FCmp Opcode = C.LLVMFCmp PHI Opcode = C.LLVMPHI Call Opcode = C.LLVMCall Select Opcode = C.LLVMSelect // UserOp1 // UserOp2 VAArg Opcode = C.LLVMVAArg ExtractElement Opcode = C.LLVMExtractElement InsertElement Opcode = C.LLVMInsertElement ShuffleVector Opcode = C.LLVMShuffleVector ExtractValue Opcode = C.LLVMExtractValue InsertValue Opcode = C.LLVMInsertValue ) const ( AtomicRMWBinOpXchg AtomicRMWBinOp = C.LLVMAtomicRMWBinOpXchg AtomicRMWBinOpAdd AtomicRMWBinOp = C.LLVMAtomicRMWBinOpAdd AtomicRMWBinOpSub AtomicRMWBinOp = C.LLVMAtomicRMWBinOpSub AtomicRMWBinOpAnd AtomicRMWBinOp = C.LLVMAtomicRMWBinOpAnd AtomicRMWBinOpNand AtomicRMWBinOp = C.LLVMAtomicRMWBinOpNand AtomicRMWBinOpOr AtomicRMWBinOp = C.LLVMAtomicRMWBinOpOr AtomicRMWBinOpXor AtomicRMWBinOp = C.LLVMAtomicRMWBinOpXor AtomicRMWBinOpMax AtomicRMWBinOp = C.LLVMAtomicRMWBinOpMax AtomicRMWBinOpMin AtomicRMWBinOp = C.LLVMAtomicRMWBinOpMin AtomicRMWBinOpUMax AtomicRMWBinOp = C.LLVMAtomicRMWBinOpUMax AtomicRMWBinOpUMin AtomicRMWBinOp = C.LLVMAtomicRMWBinOpUMin ) const ( AtomicOrderingNotAtomic AtomicOrdering = C.LLVMAtomicOrderingNotAtomic AtomicOrderingUnordered AtomicOrdering = C.LLVMAtomicOrderingUnordered AtomicOrderingMonotonic AtomicOrdering = C.LLVMAtomicOrderingMonotonic AtomicOrderingAcquire AtomicOrdering = C.LLVMAtomicOrderingAcquire AtomicOrderingRelease AtomicOrdering = C.LLVMAtomicOrderingRelease AtomicOrderingAcquireRelease AtomicOrdering = C.LLVMAtomicOrderingAcquireRelease AtomicOrderingSequentiallyConsistent AtomicOrdering = C.LLVMAtomicOrderingSequentiallyConsistent ) //------------------------------------------------------------------------- // llvm.TypeKind //------------------------------------------------------------------------- const ( VoidTypeKind TypeKind = C.LLVMVoidTypeKind FloatTypeKind TypeKind = C.LLVMFloatTypeKind DoubleTypeKind TypeKind = C.LLVMDoubleTypeKind X86_FP80TypeKind TypeKind = C.LLVMX86_FP80TypeKind FP128TypeKind TypeKind = C.LLVMFP128TypeKind PPC_FP128TypeKind TypeKind = C.LLVMPPC_FP128TypeKind LabelTypeKind TypeKind = C.LLVMLabelTypeKind IntegerTypeKind TypeKind = C.LLVMIntegerTypeKind FunctionTypeKind TypeKind = C.LLVMFunctionTypeKind StructTypeKind TypeKind = C.LLVMStructTypeKind ArrayTypeKind TypeKind = C.LLVMArrayTypeKind PointerTypeKind TypeKind = C.LLVMPointerTypeKind MetadataTypeKind TypeKind = C.LLVMMetadataTypeKind TokenTypeKind TypeKind = C.LLVMTokenTypeKind VectorTypeKind TypeKind = C.LLVMVectorTypeKind ScalableVectorTypeKind TypeKind = C.LLVMScalableVectorTypeKind ) //------------------------------------------------------------------------- // llvm.Linkage //------------------------------------------------------------------------- const ( ExternalLinkage Linkage = C.LLVMExternalLinkage AvailableExternallyLinkage Linkage = C.LLVMAvailableExternallyLinkage LinkOnceAnyLinkage Linkage = C.LLVMLinkOnceAnyLinkage LinkOnceODRLinkage Linkage = C.LLVMLinkOnceODRLinkage WeakAnyLinkage Linkage = C.LLVMWeakAnyLinkage WeakODRLinkage Linkage = C.LLVMWeakODRLinkage AppendingLinkage Linkage = C.LLVMAppendingLinkage InternalLinkage Linkage = C.LLVMInternalLinkage PrivateLinkage Linkage = C.LLVMPrivateLinkage ExternalWeakLinkage Linkage = C.LLVMExternalWeakLinkage CommonLinkage Linkage = C.LLVMCommonLinkage ) //------------------------------------------------------------------------- // llvm.Visibility //------------------------------------------------------------------------- const ( DefaultVisibility Visibility = C.LLVMDefaultVisibility HiddenVisibility Visibility = C.LLVMHiddenVisibility ProtectedVisibility Visibility = C.LLVMProtectedVisibility ) //------------------------------------------------------------------------- // llvm.CallConv //------------------------------------------------------------------------- const ( CCallConv CallConv = C.LLVMCCallConv FastCallConv CallConv = C.LLVMFastCallConv ColdCallConv CallConv = C.LLVMColdCallConv X86StdcallCallConv CallConv = C.LLVMX86StdcallCallConv X86FastcallCallConv CallConv = C.LLVMX86FastcallCallConv ) //------------------------------------------------------------------------- // llvm.ComdatSelectionKind //------------------------------------------------------------------------- const ( AnyComdatSelectionKind ComdatSelectionKind = C.LLVMAnyComdatSelectionKind ExactMatchComdatSelectionKind ComdatSelectionKind = C.LLVMExactMatchComdatSelectionKind LargestComdatSelectionKind ComdatSelectionKind = C.LLVMLargestComdatSelectionKind NoDuplicatesComdatSelectionKind ComdatSelectionKind = C.LLVMNoDuplicatesComdatSelectionKind SameSizeComdatSelectionKind ComdatSelectionKind = C.LLVMSameSizeComdatSelectionKind ) //------------------------------------------------------------------------- // llvm.IntPredicate //------------------------------------------------------------------------- const ( IntEQ IntPredicate = C.LLVMIntEQ IntNE IntPredicate = C.LLVMIntNE IntUGT IntPredicate = C.LLVMIntUGT IntUGE IntPredicate = C.LLVMIntUGE IntULT IntPredicate = C.LLVMIntULT IntULE IntPredicate = C.LLVMIntULE IntSGT IntPredicate = C.LLVMIntSGT IntSGE IntPredicate = C.LLVMIntSGE IntSLT IntPredicate = C.LLVMIntSLT IntSLE IntPredicate = C.LLVMIntSLE ) //------------------------------------------------------------------------- // llvm.FloatPredicate //------------------------------------------------------------------------- const ( FloatPredicateFalse FloatPredicate = C.LLVMRealPredicateFalse FloatOEQ FloatPredicate = C.LLVMRealOEQ FloatOGT FloatPredicate = C.LLVMRealOGT FloatOGE FloatPredicate = C.LLVMRealOGE FloatOLT FloatPredicate = C.LLVMRealOLT FloatOLE FloatPredicate = C.LLVMRealOLE FloatONE FloatPredicate = C.LLVMRealONE FloatORD FloatPredicate = C.LLVMRealORD FloatUNO FloatPredicate = C.LLVMRealUNO FloatUEQ FloatPredicate = C.LLVMRealUEQ FloatUGT FloatPredicate = C.LLVMRealUGT FloatUGE FloatPredicate = C.LLVMRealUGE FloatULT FloatPredicate = C.LLVMRealULT FloatULE FloatPredicate = C.LLVMRealULE FloatUNE FloatPredicate = C.LLVMRealUNE FloatPredicateTrue FloatPredicate = C.LLVMRealPredicateTrue ) //------------------------------------------------------------------------- // llvm.LandingPadClause //------------------------------------------------------------------------- const ( LandingPadCatch LandingPadClause = C.LLVMLandingPadCatch LandingPadFilter LandingPadClause = C.LLVMLandingPadFilter ) //------------------------------------------------------------------------- // llvm.InlineAsmDialect //------------------------------------------------------------------------- const ( InlineAsmDialectATT InlineAsmDialect = C.LLVMInlineAsmDialectATT InlineAsmDialectIntel InlineAsmDialect = C.LLVMInlineAsmDialectIntel ) //------------------------------------------------------------------------- // llvm.Context //------------------------------------------------------------------------- func NewContext() Context { return Context{C.LLVMContextCreate()} } func GlobalContext() Context { return Context{C.LLVMGetGlobalContext()} } func (c Context) Dispose() { C.LLVMContextDispose(c.C) } func (c Context) MDKindID(name string) (id int) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) id = int(C.LLVMGetMDKindIDInContext(c.C, cname, C.unsigned(len(name)))) return } func MDKindID(name string) (id int) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) id = int(C.LLVMGetMDKindID(cname, C.unsigned(len(name)))) return } //------------------------------------------------------------------------- // llvm.Attribute //------------------------------------------------------------------------- func AttributeKindID(name string) (id uint) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) id = uint(C.LLVMGetEnumAttributeKindForName(cname, C.size_t(len(name)))) return } func (c Context) CreateEnumAttribute(kind uint, val uint64) (a Attribute) { a.C = C.LLVMCreateEnumAttribute(c.C, C.unsigned(kind), C.uint64_t(val)) return } func (a Attribute) GetEnumKind() (id int) { id = int(C.LLVMGetEnumAttributeKind(a.C)) return } func (a Attribute) GetEnumValue() (val uint64) { val = uint64(C.LLVMGetEnumAttributeValue(a.C)) return } func (c Context) CreateStringAttribute(kind string, val string) (a Attribute) { ckind := C.CString(kind) defer C.free(unsafe.Pointer(ckind)) cval := C.CString(val) defer C.free(unsafe.Pointer(cval)) a.C = C.LLVMCreateStringAttribute(c.C, ckind, C.unsigned(len(kind)), cval, C.unsigned(len(val))) return } func (a Attribute) GetStringKind() string { length := C.unsigned(0) ckind := C.LLVMGetStringAttributeKind(a.C, &length) return C.GoStringN(ckind, C.int(length)) } func (a Attribute) GetStringValue() string { length := C.unsigned(0) ckind := C.LLVMGetStringAttributeValue(a.C, &length) return C.GoStringN(ckind, C.int(length)) } func (a Attribute) IsEnum() bool { return C.LLVMIsEnumAttribute(a.C) != 0 } func (a Attribute) IsString() bool { return C.LLVMIsStringAttribute(a.C) != 0 } //------------------------------------------------------------------------- // llvm.Module //------------------------------------------------------------------------- // Create and destroy modules. // See llvm::Module::Module. func NewModule(name string) (m Module) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) m.C = C.LLVMModuleCreateWithName(cname) return } func (c Context) NewModule(name string) (m Module) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) m.C = C.LLVMModuleCreateWithNameInContext(cname, c.C) return } // See llvm::Module::~Module func (m Module) Dispose() { C.LLVMDisposeModule(m.C) } // Data layout. See Module::getDataLayout. func (m Module) DataLayout() string { clayout := C.LLVMGetDataLayout(m.C) return C.GoString(clayout) } func (m Module) SetDataLayout(layout string) { clayout := C.CString(layout) defer C.free(unsafe.Pointer(clayout)) C.LLVMSetDataLayout(m.C, clayout) } // Target triple. See Module::getTargetTriple. func (m Module) Target() string { ctarget := C.LLVMGetTarget(m.C) return C.GoString(ctarget) } func (m Module) SetTarget(target string) { ctarget := C.CString(target) defer C.free(unsafe.Pointer(ctarget)) C.LLVMSetTarget(m.C, ctarget) } func (m Module) GetTypeByName(name string) (t Type) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) t.C = C.LLVMGetTypeByName(m.C, cname) return } // See Module::dump. func (m Module) Dump() { C.LLVMDumpModule(m.C) } func (m Module) String() string { cir := C.LLVMPrintModuleToString(m.C) defer C.free(unsafe.Pointer(cir)) ir := C.GoString(cir) return ir } // See Module::setModuleInlineAsm. func (m Module) SetInlineAsm(asm string) { casm := C.CString(asm) defer C.free(unsafe.Pointer(casm)) C.LLVMSetModuleInlineAsm(m.C, casm) } func (m Module) AddNamedMetadataOperand(name string, operand Metadata) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) C.LLVMAddNamedMetadataOperand2(m.C, cname, operand.C) } func (m Module) Context() (c Context) { c.C = C.LLVMGetModuleContext(m.C) return } //------------------------------------------------------------------------- // llvm.Type //------------------------------------------------------------------------- // LLVM types conform to the following hierarchy: // // types: // integer type // real type // function type // sequence types: // array type // pointer type // vector type // void type // label type // opaque type // See llvm::LLVMTypeKind::getTypeID. func (t Type) TypeKind() TypeKind { return TypeKind(C.LLVMGetTypeKind(t.C)) } // See llvm::LLVMType::getContext. func (t Type) Context() (c Context) { c.C = C.LLVMGetTypeContext(t.C) return } // Operations on integer types func (c Context) Int1Type() (t Type) { t.C = C.LLVMInt1TypeInContext(c.C); return } func (c Context) Int8Type() (t Type) { t.C = C.LLVMInt8TypeInContext(c.C); return } func (c Context) Int16Type() (t Type) { t.C = C.LLVMInt16TypeInContext(c.C); return } func (c Context) Int32Type() (t Type) { t.C = C.LLVMInt32TypeInContext(c.C); return } func (c Context) Int64Type() (t Type) { t.C = C.LLVMInt64TypeInContext(c.C); return } func (c Context) IntType(numbits int) (t Type) { t.C = C.LLVMIntTypeInContext(c.C, C.unsigned(numbits)) return } func Int1Type() (t Type) { t.C = C.LLVMInt1Type(); return } func Int8Type() (t Type) { t.C = C.LLVMInt8Type(); return } func Int16Type() (t Type) { t.C = C.LLVMInt16Type(); return } func Int32Type() (t Type) { t.C = C.LLVMInt32Type(); return } func Int64Type() (t Type) { t.C = C.LLVMInt64Type(); return } func IntType(numbits int) (t Type) { t.C = C.LLVMIntType(C.unsigned(numbits)) return } func (t Type) IntTypeWidth() int { return int(C.LLVMGetIntTypeWidth(t.C)) } // Operations on real types func (c Context) FloatType() (t Type) { t.C = C.LLVMFloatTypeInContext(c.C); return } func (c Context) DoubleType() (t Type) { t.C = C.LLVMDoubleTypeInContext(c.C); return } func (c Context) X86FP80Type() (t Type) { t.C = C.LLVMX86FP80TypeInContext(c.C); return } func (c Context) FP128Type() (t Type) { t.C = C.LLVMFP128TypeInContext(c.C); return } func (c Context) PPCFP128Type() (t Type) { t.C = C.LLVMPPCFP128TypeInContext(c.C); return } func FloatType() (t Type) { t.C = C.LLVMFloatType(); return } func DoubleType() (t Type) { t.C = C.LLVMDoubleType(); return } func X86FP80Type() (t Type) { t.C = C.LLVMX86FP80Type(); return } func FP128Type() (t Type) { t.C = C.LLVMFP128Type(); return } func PPCFP128Type() (t Type) { t.C = C.LLVMPPCFP128Type(); return } // Operations on function types func FunctionType(returnType Type, paramTypes []Type, isVarArg bool) (t Type) { var pt *C.LLVMTypeRef var ptlen C.unsigned if len(paramTypes) > 0 { pt = llvmTypeRefPtr(¶mTypes[0]) ptlen = C.unsigned(len(paramTypes)) } t.C = C.LLVMFunctionType(returnType.C, pt, ptlen, boolToLLVMBool(isVarArg)) return } func (t Type) IsFunctionVarArg() bool { return C.LLVMIsFunctionVarArg(t.C) != 0 } func (t Type) ReturnType() (rt Type) { rt.C = C.LLVMGetReturnType(t.C); return } func (t Type) ParamTypesCount() int { return int(C.LLVMCountParamTypes(t.C)) } func (t Type) ParamTypes() []Type { count := t.ParamTypesCount() if count > 0 { out := make([]Type, count) C.LLVMGetParamTypes(t.C, llvmTypeRefPtr(&out[0])) return out } return nil } // Operations on struct types func (c Context) StructType(elementTypes []Type, packed bool) (t Type) { var pt *C.LLVMTypeRef var ptlen C.unsigned if len(elementTypes) > 0 { pt = llvmTypeRefPtr(&elementTypes[0]) ptlen = C.unsigned(len(elementTypes)) } t.C = C.LLVMStructTypeInContext(c.C, pt, ptlen, boolToLLVMBool(packed)) return } func StructType(elementTypes []Type, packed bool) (t Type) { var pt *C.LLVMTypeRef var ptlen C.unsigned if len(elementTypes) > 0 { pt = llvmTypeRefPtr(&elementTypes[0]) ptlen = C.unsigned(len(elementTypes)) } t.C = C.LLVMStructType(pt, ptlen, boolToLLVMBool(packed)) return } func (c Context) StructCreateNamed(name string) (t Type) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) t.C = C.LLVMStructCreateNamed(c.C, cname) return } func (t Type) StructName() string { return C.GoString(C.LLVMGetStructName(t.C)) } func (t Type) StructSetBody(elementTypes []Type, packed bool) { var pt *C.LLVMTypeRef var ptlen C.unsigned if len(elementTypes) > 0 { pt = llvmTypeRefPtr(&elementTypes[0]) ptlen = C.unsigned(len(elementTypes)) } C.LLVMStructSetBody(t.C, pt, ptlen, boolToLLVMBool(packed)) } func (t Type) IsStructPacked() bool { return C.LLVMIsPackedStruct(t.C) != 0 } func (t Type) StructElementTypesCount() int { return int(C.LLVMCountStructElementTypes(t.C)) } func (t Type) StructElementTypes() []Type { out := make([]Type, t.StructElementTypesCount()) if len(out) > 0 { C.LLVMGetStructElementTypes(t.C, llvmTypeRefPtr(&out[0])) } return out } // Operations on array, pointer, and vector types (sequence types) func (t Type) Subtypes() (ret []Type) { ret = make([]Type, C.LLVMGetNumContainedTypes(t.C)) C.LLVMGetSubtypes(t.C, llvmTypeRefPtr(&ret[0])) return } func ArrayType(elementType Type, elementCount int) (t Type) { t.C = C.LLVMArrayType(elementType.C, C.unsigned(elementCount)) return } func PointerType(elementType Type, addressSpace int) (t Type) { t.C = C.LLVMPointerType(elementType.C, C.unsigned(addressSpace)) return } func VectorType(elementType Type, elementCount int) (t Type) { t.C = C.LLVMVectorType(elementType.C, C.unsigned(elementCount)) return } func (t Type) ElementType() (rt Type) { rt.C = C.LLVMGetElementType(t.C); return } func (t Type) ArrayLength() int { return int(C.LLVMGetArrayLength(t.C)) } func (t Type) PointerAddressSpace() int { return int(C.LLVMGetPointerAddressSpace(t.C)) } func (t Type) VectorSize() int { return int(C.LLVMGetVectorSize(t.C)) } // Operations on other types func (c Context) VoidType() (t Type) { t.C = C.LLVMVoidTypeInContext(c.C); return } func (c Context) LabelType() (t Type) { t.C = C.LLVMLabelTypeInContext(c.C); return } func (c Context) TokenType() (t Type) { t.C = C.LLVMTokenTypeInContext(c.C); return } func VoidType() (t Type) { t.C = C.LLVMVoidType(); return } func LabelType() (t Type) { t.C = C.LLVMLabelType(); return } //------------------------------------------------------------------------- // llvm.Value //------------------------------------------------------------------------- // Operations on all values func (v Value) Type() (t Type) { t.C = C.LLVMTypeOf(v.C); return } func (v Value) Name() string { return C.GoString(C.LLVMGetValueName(v.C)) } func (v Value) SetName(name string) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) C.LLVMSetValueName(v.C, cname) } func (v Value) Dump() { C.LLVMDumpValue(v.C) } func (v Value) ReplaceAllUsesWith(nv Value) { C.LLVMReplaceAllUsesWith(v.C, nv.C) } func (v Value) HasMetadata() bool { return C.LLVMHasMetadata(v.C) != 0 } func (v Value) Metadata(kind int) (rv Value) { rv.C = C.LLVMGetMetadata(v.C, C.unsigned(kind)) return } func (v Value) SetMetadata(kind int, node Metadata) { C.LLVMSetMetadata2(v.C, C.unsigned(kind), node.C) } // Conversion functions. // Return the input value if it is an instance of the specified class, otherwise NULL. // See llvm::dyn_cast_or_null<>. func (v Value) IsAArgument() (rv Value) { rv.C = C.LLVMIsAArgument(v.C); return } func (v Value) IsABasicBlock() (rv Value) { rv.C = C.LLVMIsABasicBlock(v.C); return } func (v Value) IsAInlineAsm() (rv Value) { rv.C = C.LLVMIsAInlineAsm(v.C); return } func (v Value) IsAUser() (rv Value) { rv.C = C.LLVMIsAUser(v.C); return } func (v Value) IsAConstant() (rv Value) { rv.C = C.LLVMIsAConstant(v.C); return } func (v Value) IsAConstantAggregateZero() (rv Value) { rv.C = C.LLVMIsAConstantAggregateZero(v.C) return } func (v Value) IsAConstantArray() (rv Value) { rv.C = C.LLVMIsAConstantArray(v.C); return } func (v Value) IsAConstantExpr() (rv Value) { rv.C = C.LLVMIsAConstantExpr(v.C); return } func (v Value) IsAConstantFP() (rv Value) { rv.C = C.LLVMIsAConstantFP(v.C); return } func (v Value) IsAConstantInt() (rv Value) { rv.C = C.LLVMIsAConstantInt(v.C); return } func (v Value) IsAConstantPointerNull() (rv Value) { rv.C = C.LLVMIsAConstantPointerNull(v.C); return } func (v Value) IsAConstantStruct() (rv Value) { rv.C = C.LLVMIsAConstantStruct(v.C); return } func (v Value) IsAConstantVector() (rv Value) { rv.C = C.LLVMIsAConstantVector(v.C); return } func (v Value) IsAGlobalValue() (rv Value) { rv.C = C.LLVMIsAGlobalValue(v.C); return } func (v Value) IsAFunction() (rv Value) { rv.C = C.LLVMIsAFunction(v.C); return } func (v Value) IsAGlobalAlias() (rv Value) { rv.C = C.LLVMIsAGlobalAlias(v.C); return } func (v Value) IsAGlobalVariable() (rv Value) { rv.C = C.LLVMIsAGlobalVariable(v.C); return } func (v Value) IsAUndefValue() (rv Value) { rv.C = C.LLVMIsAUndefValue(v.C); return } func (v Value) IsAInstruction() (rv Value) { rv.C = C.LLVMIsAInstruction(v.C); return } func (v Value) IsABinaryOperator() (rv Value) { rv.C = C.LLVMIsABinaryOperator(v.C); return } func (v Value) IsACallInst() (rv Value) { rv.C = C.LLVMIsACallInst(v.C); return } func (v Value) IsAIntrinsicInst() (rv Value) { rv.C = C.LLVMIsAIntrinsicInst(v.C); return } func (v Value) IsADbgInfoIntrinsic() (rv Value) { rv.C = C.LLVMIsADbgInfoIntrinsic(v.C); return } func (v Value) IsADbgDeclareInst() (rv Value) { rv.C = C.LLVMIsADbgDeclareInst(v.C); return } func (v Value) IsAMemIntrinsic() (rv Value) { rv.C = C.LLVMIsAMemIntrinsic(v.C); return } func (v Value) IsAMemCpyInst() (rv Value) { rv.C = C.LLVMIsAMemCpyInst(v.C); return } func (v Value) IsAMemMoveInst() (rv Value) { rv.C = C.LLVMIsAMemMoveInst(v.C); return } func (v Value) IsAMemSetInst() (rv Value) { rv.C = C.LLVMIsAMemSetInst(v.C); return } func (v Value) IsACmpInst() (rv Value) { rv.C = C.LLVMIsACmpInst(v.C); return } func (v Value) IsAFCmpInst() (rv Value) { rv.C = C.LLVMIsAFCmpInst(v.C); return } func (v Value) IsAICmpInst() (rv Value) { rv.C = C.LLVMIsAICmpInst(v.C); return } func (v Value) IsAExtractElementInst() (rv Value) { rv.C = C.LLVMIsAExtractElementInst(v.C); return } func (v Value) IsAGetElementPtrInst() (rv Value) { rv.C = C.LLVMIsAGetElementPtrInst(v.C); return } func (v Value) IsAInsertElementInst() (rv Value) { rv.C = C.LLVMIsAInsertElementInst(v.C); return } func (v Value) IsAInsertValueInst() (rv Value) { rv.C = C.LLVMIsAInsertValueInst(v.C); return } func (v Value) IsAPHINode() (rv Value) { rv.C = C.LLVMIsAPHINode(v.C); return } func (v Value) IsASelectInst() (rv Value) { rv.C = C.LLVMIsASelectInst(v.C); return } func (v Value) IsAShuffleVectorInst() (rv Value) { rv.C = C.LLVMIsAShuffleVectorInst(v.C); return } func (v Value) IsAStoreInst() (rv Value) { rv.C = C.LLVMIsAStoreInst(v.C); return } func (v Value) IsABranchInst() (rv Value) { rv.C = C.LLVMIsABranchInst(v.C); return } func (v Value) IsAInvokeInst() (rv Value) { rv.C = C.LLVMIsAInvokeInst(v.C); return } func (v Value) IsAReturnInst() (rv Value) { rv.C = C.LLVMIsAReturnInst(v.C); return } func (v Value) IsASwitchInst() (rv Value) { rv.C = C.LLVMIsASwitchInst(v.C); return } func (v Value) IsAUnreachableInst() (rv Value) { rv.C = C.LLVMIsAUnreachableInst(v.C); return } func (v Value) IsAUnaryInstruction() (rv Value) { rv.C = C.LLVMIsAUnaryInstruction(v.C); return } func (v Value) IsAAllocaInst() (rv Value) { rv.C = C.LLVMIsAAllocaInst(v.C); return } func (v Value) IsACastInst() (rv Value) { rv.C = C.LLVMIsACastInst(v.C); return } func (v Value) IsABitCastInst() (rv Value) { rv.C = C.LLVMIsABitCastInst(v.C); return } func (v Value) IsAFPExtInst() (rv Value) { rv.C = C.LLVMIsAFPExtInst(v.C); return } func (v Value) IsAFPToSIInst() (rv Value) { rv.C = C.LLVMIsAFPToSIInst(v.C); return } func (v Value) IsAFPToUIInst() (rv Value) { rv.C = C.LLVMIsAFPToUIInst(v.C); return } func (v Value) IsAFPTruncInst() (rv Value) { rv.C = C.LLVMIsAFPTruncInst(v.C); return } func (v Value) IsAIntToPtrInst() (rv Value) { rv.C = C.LLVMIsAIntToPtrInst(v.C); return } func (v Value) IsAPtrToIntInst() (rv Value) { rv.C = C.LLVMIsAPtrToIntInst(v.C); return } func (v Value) IsASExtInst() (rv Value) { rv.C = C.LLVMIsASExtInst(v.C); return } func (v Value) IsASIToFPInst() (rv Value) { rv.C = C.LLVMIsASIToFPInst(v.C); return } func (v Value) IsATruncInst() (rv Value) { rv.C = C.LLVMIsATruncInst(v.C); return } func (v Value) IsAUIToFPInst() (rv Value) { rv.C = C.LLVMIsAUIToFPInst(v.C); return } func (v Value) IsAZExtInst() (rv Value) { rv.C = C.LLVMIsAZExtInst(v.C); return } func (v Value) IsAExtractValueInst() (rv Value) { rv.C = C.LLVMIsAExtractValueInst(v.C); return } func (v Value) IsALoadInst() (rv Value) { rv.C = C.LLVMIsALoadInst(v.C); return } func (v Value) IsAVAArgInst() (rv Value) { rv.C = C.LLVMIsAVAArgInst(v.C); return } // Operations on Uses func (v Value) FirstUse() (u Use) { u.C = C.LLVMGetFirstUse(v.C); return } func (u Use) NextUse() (ru Use) { ru.C = C.LLVMGetNextUse(u.C); return } func (u Use) User() (v Value) { v.C = C.LLVMGetUser(u.C); return } func (u Use) UsedValue() (v Value) { v.C = C.LLVMGetUsedValue(u.C); return } // Operations on Users func (v Value) Operand(i int) (rv Value) { rv.C = C.LLVMGetOperand(v.C, C.unsigned(i)); return } func (v Value) SetOperand(i int, op Value) { C.LLVMSetOperand(v.C, C.unsigned(i), op.C) } func (v Value) OperandsCount() int { return int(C.LLVMGetNumOperands(v.C)) } // Operations on constants of any type func ConstNull(t Type) (v Value) { v.C = C.LLVMConstNull(t.C); return } func ConstAllOnes(t Type) (v Value) { v.C = C.LLVMConstAllOnes(t.C); return } func Undef(t Type) (v Value) { v.C = C.LLVMGetUndef(t.C); return } func (v Value) IsConstant() bool { return C.LLVMIsConstant(v.C) != 0 } func (v Value) IsNull() bool { return C.LLVMIsNull(v.C) != 0 } func (v Value) IsUndef() bool { return C.LLVMIsUndef(v.C) != 0 } func ConstPointerNull(t Type) (v Value) { v.C = C.LLVMConstPointerNull(t.C); return } // Operations on metadata func (c Context) MDString(str string) (md Metadata) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) md.C = C.LLVMMDString2(c.C, cstr, C.unsigned(len(str))) return } func (c Context) MDNode(mds []Metadata) (md Metadata) { ptr, nvals := llvmMetadataRefs(mds) md.C = C.LLVMMDNode2(c.C, ptr, nvals) return } func (v Value) ConstantAsMetadata() (md Metadata) { md.C = C.LLVMConstantAsMetadata(v.C) return } // Operations on scalar constants func ConstInt(t Type, n uint64, signExtend bool) (v Value) { v.C = C.LLVMConstInt(t.C, C.ulonglong(n), boolToLLVMBool(signExtend)) return } func ConstIntFromString(t Type, str string, radix int) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) v.C = C.LLVMConstIntOfString(t.C, cstr, C.uint8_t(radix)) return } func ConstFloat(t Type, n float64) (v Value) { v.C = C.LLVMConstReal(t.C, C.double(n)) return } func ConstFloatFromString(t Type, str string) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) v.C = C.LLVMConstRealOfString(t.C, cstr) return } func (v Value) ZExtValue() uint64 { return uint64(C.LLVMConstIntGetZExtValue(v.C)) } func (v Value) SExtValue() int64 { return int64(C.LLVMConstIntGetSExtValue(v.C)) } // Operations on composite constants func (c Context) ConstString(str string, addnull bool) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) v.C = C.LLVMConstStringInContext(c.C, cstr, C.unsigned(len(str)), boolToLLVMBool(!addnull)) return } func (c Context) ConstStruct(constVals []Value, packed bool) (v Value) { ptr, nvals := llvmValueRefs(constVals) v.C = C.LLVMConstStructInContext(c.C, ptr, nvals, boolToLLVMBool(packed)) return } func ConstNamedStruct(t Type, constVals []Value) (v Value) { ptr, nvals := llvmValueRefs(constVals) v.C = C.LLVMConstNamedStruct(t.C, ptr, nvals) return } func ConstString(str string, addnull bool) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) v.C = C.LLVMConstString(cstr, C.unsigned(len(str)), boolToLLVMBool(!addnull)) return } func ConstArray(t Type, constVals []Value) (v Value) { ptr, nvals := llvmValueRefs(constVals) v.C = C.LLVMConstArray(t.C, ptr, nvals) return } func ConstStruct(constVals []Value, packed bool) (v Value) { ptr, nvals := llvmValueRefs(constVals) v.C = C.LLVMConstStruct(ptr, nvals, boolToLLVMBool(packed)) return } func ConstVector(scalarConstVals []Value, packed bool) (v Value) { ptr, nvals := llvmValueRefs(scalarConstVals) v.C = C.LLVMConstVector(ptr, nvals) return } // Constant expressions func (v Value) Opcode() Opcode { return Opcode(C.LLVMGetConstOpcode(v.C)) } func (v Value) InstructionOpcode() Opcode { return Opcode(C.LLVMGetInstructionOpcode(v.C)) } func AlignOf(t Type) (v Value) { v.C = C.LLVMAlignOf(t.C); return } func SizeOf(t Type) (v Value) { v.C = C.LLVMSizeOf(t.C); return } func ConstNeg(v Value) (rv Value) { rv.C = C.LLVMConstNeg(v.C); return } func ConstNSWNeg(v Value) (rv Value) { rv.C = C.LLVMConstNSWNeg(v.C); return } func ConstNUWNeg(v Value) (rv Value) { rv.C = C.LLVMConstNUWNeg(v.C); return } func ConstFNeg(v Value) (rv Value) { rv.C = C.LLVMConstFNeg(v.C); return } func ConstNot(v Value) (rv Value) { rv.C = C.LLVMConstNot(v.C); return } func ConstAdd(lhs, rhs Value) (v Value) { v.C = C.LLVMConstAdd(lhs.C, rhs.C); return } func ConstNSWAdd(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNSWAdd(lhs.C, rhs.C); return } func ConstNUWAdd(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNUWAdd(lhs.C, rhs.C); return } func ConstFAdd(lhs, rhs Value) (v Value) { v.C = C.LLVMConstFAdd(lhs.C, rhs.C); return } func ConstSub(lhs, rhs Value) (v Value) { v.C = C.LLVMConstSub(lhs.C, rhs.C); return } func ConstNSWSub(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNSWSub(lhs.C, rhs.C); return } func ConstNUWSub(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNUWSub(lhs.C, rhs.C); return } func ConstFSub(lhs, rhs Value) (v Value) { v.C = C.LLVMConstFSub(lhs.C, rhs.C); return } func ConstMul(lhs, rhs Value) (v Value) { v.C = C.LLVMConstMul(lhs.C, rhs.C); return } func ConstNSWMul(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNSWMul(lhs.C, rhs.C); return } func ConstNUWMul(lhs, rhs Value) (v Value) { v.C = C.LLVMConstNUWMul(lhs.C, rhs.C); return } func ConstFMul(lhs, rhs Value) (v Value) { v.C = C.LLVMConstFMul(lhs.C, rhs.C); return } func ConstUDiv(lhs, rhs Value) (v Value) { v.C = C.LLVMConstUDiv(lhs.C, rhs.C); return } func ConstSDiv(lhs, rhs Value) (v Value) { v.C = C.LLVMConstSDiv(lhs.C, rhs.C); return } func ConstExactSDiv(lhs, rhs Value) (v Value) { v.C = C.LLVMConstExactSDiv(lhs.C, rhs.C); return } func ConstFDiv(lhs, rhs Value) (v Value) { v.C = C.LLVMConstFDiv(lhs.C, rhs.C); return } func ConstURem(lhs, rhs Value) (v Value) { v.C = C.LLVMConstURem(lhs.C, rhs.C); return } func ConstSRem(lhs, rhs Value) (v Value) { v.C = C.LLVMConstSRem(lhs.C, rhs.C); return } func ConstFRem(lhs, rhs Value) (v Value) { v.C = C.LLVMConstFRem(lhs.C, rhs.C); return } func ConstAnd(lhs, rhs Value) (v Value) { v.C = C.LLVMConstAnd(lhs.C, rhs.C); return } func ConstOr(lhs, rhs Value) (v Value) { v.C = C.LLVMConstOr(lhs.C, rhs.C); return } func ConstXor(lhs, rhs Value) (v Value) { v.C = C.LLVMConstXor(lhs.C, rhs.C); return } func ConstICmp(pred IntPredicate, lhs, rhs Value) (v Value) { v.C = C.LLVMConstICmp(C.LLVMIntPredicate(pred), lhs.C, rhs.C) return } func ConstFCmp(pred FloatPredicate, lhs, rhs Value) (v Value) { v.C = C.LLVMConstFCmp(C.LLVMRealPredicate(pred), lhs.C, rhs.C) return } func ConstShl(lhs, rhs Value) (v Value) { v.C = C.LLVMConstShl(lhs.C, rhs.C); return } func ConstLShr(lhs, rhs Value) (v Value) { v.C = C.LLVMConstLShr(lhs.C, rhs.C); return } func ConstAShr(lhs, rhs Value) (v Value) { v.C = C.LLVMConstAShr(lhs.C, rhs.C); return } func ConstGEP(v Value, indices []Value) (rv Value) { ptr, nvals := llvmValueRefs(indices) rv.C = C.LLVMConstGEP(v.C, ptr, nvals) return } func ConstInBoundsGEP(v Value, indices []Value) (rv Value) { ptr, nvals := llvmValueRefs(indices) rv.C = C.LLVMConstInBoundsGEP(v.C, ptr, nvals) return } func ConstTrunc(v Value, t Type) (rv Value) { rv.C = C.LLVMConstTrunc(v.C, t.C); return } func ConstSExt(v Value, t Type) (rv Value) { rv.C = C.LLVMConstSExt(v.C, t.C); return } func ConstZExt(v Value, t Type) (rv Value) { rv.C = C.LLVMConstZExt(v.C, t.C); return } func ConstFPTrunc(v Value, t Type) (rv Value) { rv.C = C.LLVMConstFPTrunc(v.C, t.C); return } func ConstFPExt(v Value, t Type) (rv Value) { rv.C = C.LLVMConstFPExt(v.C, t.C); return } func ConstUIToFP(v Value, t Type) (rv Value) { rv.C = C.LLVMConstUIToFP(v.C, t.C); return } func ConstSIToFP(v Value, t Type) (rv Value) { rv.C = C.LLVMConstSIToFP(v.C, t.C); return } func ConstFPToUI(v Value, t Type) (rv Value) { rv.C = C.LLVMConstFPToUI(v.C, t.C); return } func ConstFPToSI(v Value, t Type) (rv Value) { rv.C = C.LLVMConstFPToSI(v.C, t.C); return } func ConstPtrToInt(v Value, t Type) (rv Value) { rv.C = C.LLVMConstPtrToInt(v.C, t.C); return } func ConstIntToPtr(v Value, t Type) (rv Value) { rv.C = C.LLVMConstIntToPtr(v.C, t.C); return } func ConstBitCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstBitCast(v.C, t.C); return } func ConstZExtOrBitCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstZExtOrBitCast(v.C, t.C); return } func ConstSExtOrBitCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstSExtOrBitCast(v.C, t.C); return } func ConstTruncOrBitCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstTruncOrBitCast(v.C, t.C) return } func ConstPointerCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstPointerCast(v.C, t.C); return } func ConstIntCast(v Value, t Type, signed bool) (rv Value) { rv.C = C.LLVMConstIntCast(v.C, t.C, boolToLLVMBool(signed)) return } func ConstFPCast(v Value, t Type) (rv Value) { rv.C = C.LLVMConstFPCast(v.C, t.C); return } func ConstSelect(cond, iftrue, iffalse Value) (rv Value) { rv.C = C.LLVMConstSelect(cond.C, iftrue.C, iffalse.C) return } func ConstExtractElement(vec, i Value) (rv Value) { rv.C = C.LLVMConstExtractElement(vec.C, i.C) return } func ConstInsertElement(vec, elem, i Value) (rv Value) { rv.C = C.LLVMConstInsertElement(vec.C, elem.C, i.C) return } func ConstShuffleVector(veca, vecb, mask Value) (rv Value) { rv.C = C.LLVMConstShuffleVector(veca.C, vecb.C, mask.C) return } //TODO //LLVMValueRef LLVMConstExtractValue(LLVMValueRef AggConstant, unsigned *IdxList, // unsigned NumIdx); func ConstExtractValue(agg Value, indices []uint32) (rv Value) { n := len(indices) if n == 0 { panic("one or more indices are required") } ptr := (*C.unsigned)(&indices[0]) rv.C = C.LLVMConstExtractValue(agg.C, ptr, C.unsigned(n)) return } func ConstInsertValue(agg, val Value, indices []uint32) (rv Value) { n := len(indices) if n == 0 { panic("one or more indices are required") } ptr := (*C.unsigned)(&indices[0]) rv.C = C.LLVMConstInsertValue(agg.C, val.C, ptr, C.unsigned(n)) return } func BlockAddress(f Value, bb BasicBlock) (v Value) { v.C = C.LLVMBlockAddress(f.C, bb.C) return } // Operations on global variables, functions, and aliases (globals) func (v Value) GlobalParent() (m Module) { m.C = C.LLVMGetGlobalParent(v.C); return } func (v Value) IsDeclaration() bool { return C.LLVMIsDeclaration(v.C) != 0 } func (v Value) Linkage() Linkage { return Linkage(C.LLVMGetLinkage(v.C)) } func (v Value) SetLinkage(l Linkage) { C.LLVMSetLinkage(v.C, C.LLVMLinkage(l)) } func (v Value) Section() string { return C.GoString(C.LLVMGetSection(v.C)) } func (v Value) SetSection(str string) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) C.LLVMSetSection(v.C, cstr) } func (v Value) Visibility() Visibility { return Visibility(C.LLVMGetVisibility(v.C)) } func (v Value) SetVisibility(vi Visibility) { C.LLVMSetVisibility(v.C, C.LLVMVisibility(vi)) } func (v Value) Alignment() int { return int(C.LLVMGetAlignment(v.C)) } func (v Value) SetAlignment(a int) { C.LLVMSetAlignment(v.C, C.unsigned(a)) } func (v Value) SetUnnamedAddr(ua bool) { C.LLVMSetUnnamedAddr(v.C, boolToLLVMBool(ua)) } // Operations on global variables func AddGlobal(m Module, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMAddGlobal(m.C, t.C, cname) return } func AddGlobalInAddressSpace(m Module, t Type, name string, addressSpace int) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMAddGlobalInAddressSpace(m.C, t.C, cname, C.unsigned(addressSpace)) return } func (m Module) NamedGlobal(name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMGetNamedGlobal(m.C, cname) return } func (m Module) FirstGlobal() (v Value) { v.C = C.LLVMGetFirstGlobal(m.C); return } func (m Module) LastGlobal() (v Value) { v.C = C.LLVMGetLastGlobal(m.C); return } func NextGlobal(v Value) (rv Value) { rv.C = C.LLVMGetNextGlobal(v.C); return } func PrevGlobal(v Value) (rv Value) { rv.C = C.LLVMGetPreviousGlobal(v.C); return } func (v Value) EraseFromParentAsGlobal() { C.LLVMDeleteGlobal(v.C) } func (v Value) Initializer() (rv Value) { rv.C = C.LLVMGetInitializer(v.C); return } func (v Value) SetInitializer(cv Value) { C.LLVMSetInitializer(v.C, cv.C) } func (v Value) IsThreadLocal() bool { return C.LLVMIsThreadLocal(v.C) != 0 } func (v Value) SetThreadLocal(tl bool) { C.LLVMSetThreadLocal(v.C, boolToLLVMBool(tl)) } func (v Value) IsGlobalConstant() bool { return C.LLVMIsGlobalConstant(v.C) != 0 } func (v Value) SetGlobalConstant(gc bool) { C.LLVMSetGlobalConstant(v.C, boolToLLVMBool(gc)) } func (v Value) IsVolatile() bool { return C.LLVMGetVolatile(v.C) != 0 } func (v Value) SetVolatile(volatile bool) { C.LLVMSetVolatile(v.C, boolToLLVMBool(volatile)) } func (v Value) Ordering() AtomicOrdering { return AtomicOrdering(C.LLVMGetOrdering(v.C)) } func (v Value) SetOrdering(ordering AtomicOrdering) { C.LLVMSetOrdering(v.C, C.LLVMAtomicOrdering(ordering)) } func (v Value) IsAtomicSingleThread() bool { return C.LLVMIsAtomicSingleThread(v.C) != 0 } func (v Value) SetAtomicSingleThread(singleThread bool) { C.LLVMSetAtomicSingleThread(v.C, boolToLLVMBool(singleThread)) } func (v Value) CmpXchgSuccessOrdering() AtomicOrdering { return AtomicOrdering(C.LLVMGetCmpXchgSuccessOrdering(v.C)) } func (v Value) SetCmpXchgSuccessOrdering(ordering AtomicOrdering) { C.LLVMSetCmpXchgSuccessOrdering(v.C, C.LLVMAtomicOrdering(ordering)) } func (v Value) CmpXchgFailureOrdering() AtomicOrdering { return AtomicOrdering(C.LLVMGetCmpXchgFailureOrdering(v.C)) } func (v Value) SetCmpXchgFailureOrdering(ordering AtomicOrdering) { C.LLVMSetCmpXchgFailureOrdering(v.C, C.LLVMAtomicOrdering(ordering)) } // Operations on aliases func AddAlias(m Module, t Type, aliasee Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMAddAlias(m.C, t.C, aliasee.C, cname) return } // Operations on comdat func (m Module) Comdat(name string) (c Comdat) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) c.C = C.LLVMGetOrInsertComdat(m.C, cname) return } func (v Value) Comdat() (c Comdat) { c.C = C.LLVMGetComdat(v.C); return } func (v Value) SetComdat(c Comdat) { C.LLVMSetComdat(v.C, c.C) } func (c Comdat) SelectionKind() ComdatSelectionKind { return ComdatSelectionKind(C.LLVMGetComdatSelectionKind(c.C)) } func (c Comdat) SetSelectionKind(k ComdatSelectionKind) { C.LLVMSetComdatSelectionKind(c.C, (C.LLVMComdatSelectionKind)(k)) } // Operations on functions func AddFunction(m Module, name string, ft Type) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMAddFunction(m.C, cname, ft.C) return } func (m Module) NamedFunction(name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMGetNamedFunction(m.C, cname) return } func (m Module) FirstFunction() (v Value) { v.C = C.LLVMGetFirstFunction(m.C); return } func (m Module) LastFunction() (v Value) { v.C = C.LLVMGetLastFunction(m.C); return } func NextFunction(v Value) (rv Value) { rv.C = C.LLVMGetNextFunction(v.C); return } func PrevFunction(v Value) (rv Value) { rv.C = C.LLVMGetPreviousFunction(v.C); return } func (v Value) EraseFromParentAsFunction() { C.LLVMDeleteFunction(v.C) } func (v Value) IntrinsicID() int { return int(C.LLVMGetIntrinsicID(v.C)) } func (v Value) FunctionCallConv() CallConv { return CallConv(C.LLVMCallConv(C.LLVMGetFunctionCallConv(v.C))) } func (v Value) SetFunctionCallConv(cc CallConv) { C.LLVMSetFunctionCallConv(v.C, C.unsigned(cc)) } func (v Value) GC() string { return C.GoString(C.LLVMGetGC(v.C)) } func (v Value) SetGC(name string) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) C.LLVMSetGC(v.C, cname) } func (v Value) AddAttributeAtIndex(i int, a Attribute) { C.LLVMAddAttributeAtIndex(v.C, C.LLVMAttributeIndex(i), a.C) } func (v Value) AddFunctionAttr(a Attribute) { v.AddAttributeAtIndex(C.LLVMAttributeFunctionIndex, a) } func (v Value) GetEnumAttributeAtIndex(i int, kind uint) (a Attribute) { a.C = C.LLVMGetEnumAttributeAtIndex(v.C, C.LLVMAttributeIndex(i), C.unsigned(kind)) return } func (v Value) GetEnumFunctionAttribute(kind uint) Attribute { return v.GetEnumAttributeAtIndex(C.LLVMAttributeFunctionIndex, kind) } func (v Value) GetStringAttributeAtIndex(i int, kind string) (a Attribute) { ckind := C.CString(kind) defer C.free(unsafe.Pointer(ckind)) a.C = C.LLVMGetStringAttributeAtIndex(v.C, C.LLVMAttributeIndex(i), ckind, C.unsigned(len(kind))) return } func (v Value) RemoveEnumAttributeAtIndex(i int, kind uint) { C.LLVMRemoveEnumAttributeAtIndex(v.C, C.LLVMAttributeIndex(i), C.unsigned(kind)) } func (v Value) RemoveEnumFunctionAttribute(kind uint) { v.RemoveEnumAttributeAtIndex(C.LLVMAttributeFunctionIndex, kind) } func (v Value) RemoveStringAttributeAtIndex(i int, kind string) { ckind := C.CString(kind) defer C.free(unsafe.Pointer(ckind)) C.LLVMRemoveStringAttributeAtIndex(v.C, C.LLVMAttributeIndex(i), ckind, C.unsigned(len(kind))) } func (v Value) AddTargetDependentFunctionAttr(attr, value string) { cattr := C.CString(attr) defer C.free(unsafe.Pointer(cattr)) cvalue := C.CString(value) defer C.free(unsafe.Pointer(cvalue)) C.LLVMAddTargetDependentFunctionAttr(v.C, cattr, cvalue) } func (v Value) SetPersonality(p Value) { C.LLVMSetPersonalityFn(v.C, p.C) } // Operations on parameters func (v Value) ParamsCount() int { return int(C.LLVMCountParams(v.C)) } func (v Value) Params() []Value { out := make([]Value, v.ParamsCount()) if len(out) > 0 { C.LLVMGetParams(v.C, llvmValueRefPtr(&out[0])) } return out } func (v Value) Param(i int) (rv Value) { rv.C = C.LLVMGetParam(v.C, C.unsigned(i)); return } func (v Value) ParamParent() (rv Value) { rv.C = C.LLVMGetParamParent(v.C); return } func (v Value) FirstParam() (rv Value) { rv.C = C.LLVMGetFirstParam(v.C); return } func (v Value) LastParam() (rv Value) { rv.C = C.LLVMGetLastParam(v.C); return } func NextParam(v Value) (rv Value) { rv.C = C.LLVMGetNextParam(v.C); return } func PrevParam(v Value) (rv Value) { rv.C = C.LLVMGetPreviousParam(v.C); return } func (v Value) SetParamAlignment(align int) { C.LLVMSetParamAlignment(v.C, C.unsigned(align)) } // Operations on basic blocks func (bb BasicBlock) AsValue() (v Value) { v.C = C.LLVMBasicBlockAsValue(bb.C); return } func (v Value) IsBasicBlock() bool { return C.LLVMValueIsBasicBlock(v.C) != 0 } func (v Value) AsBasicBlock() (bb BasicBlock) { bb.C = C.LLVMValueAsBasicBlock(v.C); return } func (bb BasicBlock) Parent() (v Value) { v.C = C.LLVMGetBasicBlockParent(bb.C); return } func (v Value) BasicBlocksCount() int { return int(C.LLVMCountBasicBlocks(v.C)) } func (v Value) BasicBlocks() []BasicBlock { out := make([]BasicBlock, v.BasicBlocksCount()) C.LLVMGetBasicBlocks(v.C, llvmBasicBlockRefPtr(&out[0])) return out } func (v Value) FirstBasicBlock() (bb BasicBlock) { bb.C = C.LLVMGetFirstBasicBlock(v.C); return } func (v Value) LastBasicBlock() (bb BasicBlock) { bb.C = C.LLVMGetLastBasicBlock(v.C); return } func NextBasicBlock(bb BasicBlock) (rbb BasicBlock) { rbb.C = C.LLVMGetNextBasicBlock(bb.C); return } func PrevBasicBlock(bb BasicBlock) (rbb BasicBlock) { rbb.C = C.LLVMGetPreviousBasicBlock(bb.C); return } func (v Value) EntryBasicBlock() (bb BasicBlock) { bb.C = C.LLVMGetEntryBasicBlock(v.C); return } func (c Context) AddBasicBlock(f Value, name string) (bb BasicBlock) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) bb.C = C.LLVMAppendBasicBlockInContext(c.C, f.C, cname) return } func (c Context) InsertBasicBlock(ref BasicBlock, name string) (bb BasicBlock) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) bb.C = C.LLVMInsertBasicBlockInContext(c.C, ref.C, cname) return } func AddBasicBlock(f Value, name string) (bb BasicBlock) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) bb.C = C.LLVMAppendBasicBlock(f.C, cname) return } func InsertBasicBlock(ref BasicBlock, name string) (bb BasicBlock) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) bb.C = C.LLVMInsertBasicBlock(ref.C, cname) return } func (bb BasicBlock) EraseFromParent() { C.LLVMDeleteBasicBlock(bb.C) } func (bb BasicBlock) MoveBefore(pos BasicBlock) { C.LLVMMoveBasicBlockBefore(bb.C, pos.C) } func (bb BasicBlock) MoveAfter(pos BasicBlock) { C.LLVMMoveBasicBlockAfter(bb.C, pos.C) } // Operations on instructions func (v Value) EraseFromParentAsInstruction() { C.LLVMInstructionEraseFromParent(v.C) } func (v Value) RemoveFromParentAsInstruction() { C.LLVMInstructionRemoveFromParent(v.C) } func (v Value) InstructionParent() (bb BasicBlock) { bb.C = C.LLVMGetInstructionParent(v.C); return } func (v Value) InstructionDebugLoc() (md Metadata) { md.C = C.LLVMInstructionGetDebugLoc(v.C); return } func (v Value) InstructionSetDebugLoc(md Metadata) { C.LLVMInstructionSetDebugLoc(v.C, md.C) } func (bb BasicBlock) FirstInstruction() (v Value) { v.C = C.LLVMGetFirstInstruction(bb.C); return } func (bb BasicBlock) LastInstruction() (v Value) { v.C = C.LLVMGetLastInstruction(bb.C); return } func NextInstruction(v Value) (rv Value) { rv.C = C.LLVMGetNextInstruction(v.C); return } func PrevInstruction(v Value) (rv Value) { rv.C = C.LLVMGetPreviousInstruction(v.C); return } // Operations on call sites func (v Value) SetInstructionCallConv(cc CallConv) { C.LLVMSetInstructionCallConv(v.C, C.unsigned(cc)) } func (v Value) InstructionCallConv() CallConv { return CallConv(C.LLVMCallConv(C.LLVMGetInstructionCallConv(v.C))) } func (v Value) AddCallSiteAttribute(i int, a Attribute) { C.LLVMAddCallSiteAttribute(v.C, C.LLVMAttributeIndex(i), a.C) } func (v Value) SetInstrParamAlignment(i int, align int) { C.LLVMSetInstrParamAlignment(v.C, C.unsigned(i), C.unsigned(align)) } func (v Value) CalledValue() (rv Value) { rv.C = C.LLVMGetCalledValue(v.C) return } // Operations on call instructions (only) func (v Value) IsTailCall() bool { return C.LLVMIsTailCall(v.C) != 0 } func (v Value) SetTailCall(is bool) { C.LLVMSetTailCall(v.C, boolToLLVMBool(is)) } // Operations on phi nodes func (v Value) AddIncoming(vals []Value, blocks []BasicBlock) { ptr, nvals := llvmValueRefs(vals) C.LLVMAddIncoming(v.C, ptr, llvmBasicBlockRefPtr(&blocks[0]), nvals) } func (v Value) IncomingCount() int { return int(C.LLVMCountIncoming(v.C)) } func (v Value) IncomingValue(i int) (rv Value) { rv.C = C.LLVMGetIncomingValue(v.C, C.unsigned(i)) return } func (v Value) IncomingBlock(i int) (bb BasicBlock) { bb.C = C.LLVMGetIncomingBlock(v.C, C.unsigned(i)) return } // Operations on inline assembly func InlineAsm(t Type, asmString, constraints string, hasSideEffects, isAlignStack bool, dialect InlineAsmDialect) (rv Value) { casm := C.CString(asmString) defer C.free(unsafe.Pointer(casm)) cconstraints := C.CString(constraints) defer C.free(unsafe.Pointer(cconstraints)) rv.C = C.LLVMGetInlineAsm(t.C, casm, C.size_t(len(asmString)), cconstraints, C.size_t(len(constraints)), boolToLLVMBool(hasSideEffects), boolToLLVMBool(isAlignStack), C.LLVMInlineAsmDialect(dialect)) return } // Operations on aggregates func (v Value) Indices() []uint32 { num := C.LLVMGetNumIndices(v.C) indicesPtr := C.LLVMGetIndices(v.C) // https://github.com/golang/go/wiki/cgo#turning-c-arrays-into-go-slices rawIndices := (*[1 << 20]C.uint)(unsafe.Pointer(indicesPtr))[:num:num] indices := make([]uint32, num) for i := range indices { indices[i] = uint32(rawIndices[i]) } return indices } // Operations on comparisons func (v Value) IntPredicate() IntPredicate { return IntPredicate(C.LLVMGetICmpPredicate(v.C)) } func (v Value) FloatPredicate() FloatPredicate { return FloatPredicate(C.LLVMGetFCmpPredicate(v.C)) } //------------------------------------------------------------------------- // llvm.Builder //------------------------------------------------------------------------- // An instruction builder represents a point within a basic block, and is the // exclusive means of building instructions using the C interface. func (c Context) NewBuilder() (b Builder) { b.C = C.LLVMCreateBuilderInContext(c.C); return } func NewBuilder() (b Builder) { b.C = C.LLVMCreateBuilder(); return } func (b Builder) SetInsertPoint(block BasicBlock, instr Value) { C.LLVMPositionBuilder(b.C, block.C, instr.C) } func (b Builder) SetInsertPointBefore(instr Value) { C.LLVMPositionBuilderBefore(b.C, instr.C) } func (b Builder) SetInsertPointAtEnd(block BasicBlock) { C.LLVMPositionBuilderAtEnd(b.C, block.C) } func (b Builder) GetInsertBlock() (bb BasicBlock) { bb.C = C.LLVMGetInsertBlock(b.C); return } func (b Builder) ClearInsertionPoint() { C.LLVMClearInsertionPosition(b.C) } func (b Builder) Insert(instr Value) { C.LLVMInsertIntoBuilder(b.C, instr.C) } func (b Builder) InsertWithName(instr Value, name string) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) C.LLVMInsertIntoBuilderWithName(b.C, instr.C, cname) } func (b Builder) Dispose() { C.LLVMDisposeBuilder(b.C) } // Metadata type DebugLoc struct { Line, Col uint Scope Metadata InlinedAt Metadata } func (b Builder) SetCurrentDebugLocation(line, col uint, scope, inlinedAt Metadata) { C.LLVMGoSetCurrentDebugLocation(b.C, C.unsigned(line), C.unsigned(col), scope.C, inlinedAt.C) } // Get current debug location. Please do not call this function until setting debug location with SetCurrentDebugLocation() func (b Builder) GetCurrentDebugLocation() (loc DebugLoc) { md := C.LLVMGoGetCurrentDebugLocation(b.C) loc.Line = uint(md.Line) loc.Col = uint(md.Col) loc.Scope = Metadata{C: md.Scope} loc.InlinedAt = Metadata{C: md.InlinedAt} return } func (b Builder) SetInstDebugLocation(v Value) { C.LLVMSetInstDebugLocation(b.C, v.C) } func (b Builder) InsertDeclare(module Module, storage Value, md Value) Value { f := module.NamedFunction("llvm.dbg.declare") if f.IsNil() { ftyp := FunctionType(VoidType(), []Type{storage.Type(), md.Type()}, false) f = AddFunction(module, "llvm.dbg.declare", ftyp) } return b.CreateCall(f, []Value{storage, md}, "") } // Terminators func (b Builder) CreateRetVoid() (rv Value) { rv.C = C.LLVMBuildRetVoid(b.C); return } func (b Builder) CreateRet(v Value) (rv Value) { rv.C = C.LLVMBuildRet(b.C, v.C); return } func (b Builder) CreateAggregateRet(vs []Value) (rv Value) { ptr, nvals := llvmValueRefs(vs) rv.C = C.LLVMBuildAggregateRet(b.C, ptr, nvals) return } func (b Builder) CreateBr(bb BasicBlock) (rv Value) { rv.C = C.LLVMBuildBr(b.C, bb.C); return } func (b Builder) CreateCondBr(ifv Value, thenb, elseb BasicBlock) (rv Value) { rv.C = C.LLVMBuildCondBr(b.C, ifv.C, thenb.C, elseb.C) return } func (b Builder) CreateSwitch(v Value, elseb BasicBlock, numCases int) (rv Value) { rv.C = C.LLVMBuildSwitch(b.C, v.C, elseb.C, C.unsigned(numCases)) return } func (b Builder) CreateIndirectBr(addr Value, numDests int) (rv Value) { rv.C = C.LLVMBuildIndirectBr(b.C, addr.C, C.unsigned(numDests)) return } func (b Builder) CreateInvoke(fn Value, args []Value, then, catch BasicBlock, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) ptr, nvals := llvmValueRefs(args) rv.C = C.LLVMBuildInvoke(b.C, fn.C, ptr, nvals, then.C, catch.C, cname) return } func (b Builder) CreateUnreachable() (rv Value) { rv.C = C.LLVMBuildUnreachable(b.C); return } // Add a case to the switch instruction func (v Value) AddCase(on Value, dest BasicBlock) { C.LLVMAddCase(v.C, on.C, dest.C) } // Add a destination to the indirectbr instruction func (v Value) AddDest(dest BasicBlock) { C.LLVMAddDestination(v.C, dest.C) } // Arithmetic func (b Builder) CreateAdd(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildAdd(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNSWAdd(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNSWAdd(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNUWAdd(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNUWAdd(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateFAdd(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFAdd(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateSub(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSub(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNSWSub(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNSWSub(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNUWSub(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNUWSub(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateFSub(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) v.C = C.LLVMBuildFSub(b.C, lhs.C, rhs.C, cname) C.free(unsafe.Pointer(cname)) return } func (b Builder) CreateMul(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildMul(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNSWMul(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNSWMul(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateNUWMul(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildNUWMul(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateFMul(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFMul(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateUDiv(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildUDiv(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateSDiv(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSDiv(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateExactSDiv(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildExactSDiv(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateFDiv(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFDiv(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateURem(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildURem(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateSRem(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSRem(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateFRem(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFRem(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateShl(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildShl(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateLShr(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildLShr(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateAShr(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildAShr(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateAnd(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildAnd(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateOr(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildOr(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateXor(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildXor(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateBinOp(op Opcode, lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildBinOp(b.C, C.LLVMOpcode(op), lhs.C, rhs.C, cname) return } func (b Builder) CreateNeg(v Value, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) rv.C = C.LLVMBuildNeg(b.C, v.C, cname) return } func (b Builder) CreateNSWNeg(v Value, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) rv.C = C.LLVMBuildNSWNeg(b.C, v.C, cname) return } func (b Builder) CreateNUWNeg(v Value, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) rv.C = C.LLVMBuildNUWNeg(b.C, v.C, cname) return } func (b Builder) CreateFNeg(v Value, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) rv.C = C.LLVMBuildFNeg(b.C, v.C, cname) return } func (b Builder) CreateNot(v Value, name string) (rv Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) rv.C = C.LLVMBuildNot(b.C, v.C, cname) return } // Memory func (b Builder) CreateMalloc(t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildMalloc(b.C, t.C, cname) return } func (b Builder) CreateArrayMalloc(t Type, val Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildArrayMalloc(b.C, t.C, val.C, cname) return } func (b Builder) CreateAlloca(t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildAlloca(b.C, t.C, cname) return } func (b Builder) CreateArrayAlloca(t Type, val Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildArrayAlloca(b.C, t.C, val.C, cname) return } func (b Builder) CreateFree(p Value) (v Value) { v.C = C.LLVMBuildFree(b.C, p.C) return } func (b Builder) CreateLoad(p Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildLoad(b.C, p.C, cname) return } func (b Builder) CreateStore(val Value, p Value) (v Value) { v.C = C.LLVMBuildStore(b.C, val.C, p.C) return } func (b Builder) CreateGEP(p Value, indices []Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) ptr, nvals := llvmValueRefs(indices) v.C = C.LLVMBuildGEP(b.C, p.C, ptr, nvals, cname) return } func (b Builder) CreateInBoundsGEP(p Value, indices []Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) ptr, nvals := llvmValueRefs(indices) v.C = C.LLVMBuildInBoundsGEP(b.C, p.C, ptr, nvals, cname) return } func (b Builder) CreateStructGEP(p Value, i int, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildStructGEP(b.C, p.C, C.unsigned(i), cname) return } func (b Builder) CreateGlobalString(str, name string) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildGlobalString(b.C, cstr, cname) return } func (b Builder) CreateGlobalStringPtr(str, name string) (v Value) { cstr := C.CString(str) defer C.free(unsafe.Pointer(cstr)) cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildGlobalStringPtr(b.C, cstr, cname) return } func (b Builder) CreateAtomicRMW(op AtomicRMWBinOp, ptr, val Value, ordering AtomicOrdering, singleThread bool) (v Value) { v.C = C.LLVMBuildAtomicRMW(b.C, C.LLVMAtomicRMWBinOp(op), ptr.C, val.C, C.LLVMAtomicOrdering(ordering), boolToLLVMBool(singleThread)) return } func (b Builder) CreateAtomicCmpXchg(ptr, cmp, newVal Value, successOrdering, failureOrdering AtomicOrdering, singleThread bool) (v Value) { v.C = C.LLVMBuildAtomicCmpXchg(b.C, ptr.C, cmp.C, newVal.C, C.LLVMAtomicOrdering(successOrdering), C.LLVMAtomicOrdering(failureOrdering), boolToLLVMBool(singleThread)) return } // Casts func (b Builder) CreateTrunc(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildTrunc(b.C, val.C, t.C, cname) return } func (b Builder) CreateZExt(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildZExt(b.C, val.C, t.C, cname) return } func (b Builder) CreateSExt(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSExt(b.C, val.C, t.C, cname) return } func (b Builder) CreateFPToUI(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFPToUI(b.C, val.C, t.C, cname) return } func (b Builder) CreateFPToSI(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFPToSI(b.C, val.C, t.C, cname) return } func (b Builder) CreateUIToFP(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildUIToFP(b.C, val.C, t.C, cname) return } func (b Builder) CreateSIToFP(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSIToFP(b.C, val.C, t.C, cname) return } func (b Builder) CreateFPTrunc(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFPTrunc(b.C, val.C, t.C, cname) return } func (b Builder) CreateFPExt(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFPExt(b.C, val.C, t.C, cname) return } func (b Builder) CreatePtrToInt(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildPtrToInt(b.C, val.C, t.C, cname) return } func (b Builder) CreateIntToPtr(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildIntToPtr(b.C, val.C, t.C, cname) return } func (b Builder) CreateBitCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildBitCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateZExtOrBitCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildZExtOrBitCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateSExtOrBitCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSExtOrBitCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateTruncOrBitCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildTruncOrBitCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateCast(val Value, op Opcode, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildCast(b.C, C.LLVMOpcode(op), val.C, t.C, cname) return } // func (b Builder) CreatePointerCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildPointerCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateIntCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildIntCast(b.C, val.C, t.C, cname) return } func (b Builder) CreateFPCast(val Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFPCast(b.C, val.C, t.C, cname) return } // Comparisons func (b Builder) CreateICmp(pred IntPredicate, lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildICmp(b.C, C.LLVMIntPredicate(pred), lhs.C, rhs.C, cname) return } func (b Builder) CreateFCmp(pred FloatPredicate, lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildFCmp(b.C, C.LLVMRealPredicate(pred), lhs.C, rhs.C, cname) return } // Miscellaneous instructions func (b Builder) CreatePHI(t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildPhi(b.C, t.C, cname) return } func (b Builder) CreateCall(fn Value, args []Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) ptr, nvals := llvmValueRefs(args) v.C = C.LLVMBuildCall(b.C, fn.C, ptr, nvals, cname) return } func (b Builder) CreateSelect(ifv, thenv, elsev Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildSelect(b.C, ifv.C, thenv.C, elsev.C, cname) return } func (b Builder) CreateVAArg(list Value, t Type, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildVAArg(b.C, list.C, t.C, cname) return } func (b Builder) CreateExtractElement(vec, i Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildExtractElement(b.C, vec.C, i.C, cname) return } func (b Builder) CreateInsertElement(vec, elt, i Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildInsertElement(b.C, vec.C, elt.C, i.C, cname) return } func (b Builder) CreateShuffleVector(v1, v2, mask Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildShuffleVector(b.C, v1.C, v2.C, mask.C, cname) return } func (b Builder) CreateExtractValue(agg Value, i int, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildExtractValue(b.C, agg.C, C.unsigned(i), cname) return } func (b Builder) CreateInsertValue(agg, elt Value, i int, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildInsertValue(b.C, agg.C, elt.C, C.unsigned(i), cname) return } func (b Builder) CreateIsNull(val Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildIsNull(b.C, val.C, cname) return } func (b Builder) CreateIsNotNull(val Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildIsNotNull(b.C, val.C, cname) return } func (b Builder) CreatePtrDiff(lhs, rhs Value, name string) (v Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) v.C = C.LLVMBuildPtrDiff(b.C, lhs.C, rhs.C, cname) return } func (b Builder) CreateLandingPad(t Type, nclauses int, name string) (l Value) { cname := C.CString(name) defer C.free(unsafe.Pointer(cname)) l.C = C.LLVMBuildLandingPad(b.C, t.C, nil, C.unsigned(nclauses), cname) return l } func (l Value) AddClause(v Value) { C.LLVMAddClause(l.C, v.C) } func (l Value) SetCleanup(cleanup bool) { C.LLVMSetCleanup(l.C, boolToLLVMBool(cleanup)) } func (b Builder) CreateResume(ex Value) (v Value) { v.C = C.LLVMBuildResume(b.C, ex.C) return } //------------------------------------------------------------------------- // llvm.ModuleProvider //------------------------------------------------------------------------- // Changes the type of M so it can be passed to FunctionPassManagers and the // JIT. They take ModuleProviders for historical reasons. func NewModuleProviderForModule(m Module) (mp ModuleProvider) { mp.C = C.LLVMCreateModuleProviderForExistingModule(m.C) return } // Destroys the module M. func (mp ModuleProvider) Dispose() { C.LLVMDisposeModuleProvider(mp.C) } //------------------------------------------------------------------------- // llvm.MemoryBuffer //------------------------------------------------------------------------- func NewMemoryBufferFromFile(path string) (b MemoryBuffer, err error) { var cmsg *C.char cpath := C.CString(path) defer C.free(unsafe.Pointer(cpath)) fail := C.LLVMCreateMemoryBufferWithContentsOfFile(cpath, &b.C, &cmsg) if fail != 0 { b.C = nil err = errors.New(C.GoString(cmsg)) C.LLVMDisposeMessage(cmsg) } return } func NewMemoryBufferFromStdin() (b MemoryBuffer, err error) { var cmsg *C.char fail := C.LLVMCreateMemoryBufferWithSTDIN(&b.C, &cmsg) if fail != 0 { b.C = nil err = errors.New(C.GoString(cmsg)) C.LLVMDisposeMessage(cmsg) } return } func (b MemoryBuffer) Bytes() []byte { cstart := C.LLVMGetBufferStart(b.C) csize := C.LLVMGetBufferSize(b.C) return C.GoBytes(unsafe.Pointer(cstart), C.int(csize)) } func (b MemoryBuffer) Dispose() { C.LLVMDisposeMemoryBuffer(b.C) } //------------------------------------------------------------------------- // llvm.PassManager //------------------------------------------------------------------------- // Constructs a new whole-module pass pipeline. This type of pipeline is // suitable for link-time optimization and whole-module transformations. // See llvm::PassManager::PassManager. func NewPassManager() (pm PassManager) { pm.C = C.LLVMCreatePassManager(); return } // Constructs a new function-by-function pass pipeline over the module // provider. It does not take ownership of the module provider. This type of // pipeline is suitable for code generation and JIT compilation tasks. // See llvm::FunctionPassManager::FunctionPassManager. func NewFunctionPassManagerForModule(m Module) (pm PassManager) { pm.C = C.LLVMCreateFunctionPassManagerForModule(m.C) return } // Initializes, executes on the provided module, and finalizes all of the // passes scheduled in the pass manager. Returns 1 if any of the passes // modified the module, 0 otherwise. See llvm::PassManager::run(Module&). func (pm PassManager) Run(m Module) bool { return C.LLVMRunPassManager(pm.C, m.C) != 0 } // Initializes all of the function passes scheduled in the function pass // manager. Returns 1 if any of the passes modified the module, 0 otherwise. // See llvm::FunctionPassManager::doInitialization. func (pm PassManager) InitializeFunc() bool { return C.LLVMInitializeFunctionPassManager(pm.C) != 0 } // Executes all of the function passes scheduled in the function pass manager // on the provided function. Returns 1 if any of the passes modified the // function, false otherwise. // See llvm::FunctionPassManager::run(Function&). func (pm PassManager) RunFunc(f Value) bool { return C.LLVMRunFunctionPassManager(pm.C, f.C) != 0 } // Finalizes all of the function passes scheduled in the function pass // manager. Returns 1 if any of the passes modified the module, 0 otherwise. // See llvm::FunctionPassManager::doFinalization. func (pm PassManager) FinalizeFunc() bool { return C.LLVMFinalizeFunctionPassManager(pm.C) != 0 } // Frees the memory of a pass pipeline. For function pipelines, does not free // the module provider. // See llvm::PassManagerBase::~PassManagerBase. func (pm PassManager) Dispose() { C.LLVMDisposePassManager(pm.C) }