packages /

llvm 0.1.0

Bindings to LLVM's C API (LLVM 23), for the Auk compiler's back end: build IR, verify and print it, optimize it, emit object files and bitcode, link modules,...

files / src/lib.auk 6.4 kB · 106 lines

// Generated by packages/llvm/gen/gen.py from gen/bind.txt and the LLVM 23.1.4 C headers; don't edit.
/// Bindings to LLVM's C API (LLVM 23), for the Auk compiler's back end. Generated from a list
/// (gen/bind.txt) by gen/gen.py: one `extern fn` per C function, named in snake_case without
/// `LLVM` (`LLVMBuildAdd` → `llvm.builder.build_add`), in a module per area:
///
/// - `llvm.ir`: contexts, modules, types, attributes, verification, printing
/// - `llvm.values`: constants, globals, functions, parameters, basic blocks, instructions
/// - `llvm.builder`: the instruction builder
/// - `llvm.debug`: the DIBuilder (DWARF)
/// - `llvm.target`: targets, target machines, data layouts, object files
/// - `llvm.orc`: ORC LLJIT and LLVM errors
/// - `llvm.bitcode`: memory buffers, bitcode, the linker
/// - `llvm.passes`: the new pass manager
/// - `llvm.kit` (by hand): target setup, errors as `str`, buffers as bytes, calling JIT code
///
/// Each `LLVM*Ref` is its own type here (`llvm.Value`, `llvm.Type`, ...), so they don't mix.
/// `LLVMBool` and enums are `int` (enum values are the constants below: `LLVMIntEQ` →
/// `llvm.INT_EQ`). Strings LLVM hands over are copied and disposed of; a `const char *` with a
/// length takes a `str` alone, and an array with a count takes a list alone. Out-parameters are
/// `var`: `var m: llvm.Module? = none; parse_bitcode_in_context2(c, buf, &m)`.
///
/// Everything here `uses ffi`: LLVM can abort the process, which `catch` can't stop.

// ---- opaque C types (one per `LLVM*Ref`) ----

pub extern type Attribute = "LLVMAttributeRef"
pub extern type BasicBlock = "LLVMBasicBlockRef"
pub extern type Builder = "LLVMBuilderRef"
pub extern type Context = "LLVMContextRef"
pub extern type DIBuilder = "LLVMDIBuilderRef"
pub extern type Error = "LLVMErrorRef"
pub extern type MemoryBuffer = "LLVMMemoryBufferRef"
pub extern type Metadata = "LLVMMetadataRef"
pub extern type Module = "LLVMModuleRef"
pub extern type OrcDefinitionGenerator = "LLVMOrcDefinitionGeneratorRef"
pub extern type OrcJITDylib = "LLVMOrcJITDylibRef"
pub extern type OrcLLJITBuilder = "LLVMOrcLLJITBuilderRef"
pub extern type OrcLLJIT = "LLVMOrcLLJITRef"
pub extern type OrcMaterializationUnit = "LLVMOrcMaterializationUnitRef"
pub extern type OrcSymbolStringPoolEntry = "LLVMOrcSymbolStringPoolEntryRef"
pub extern type PassBuilderOptions = "LLVMPassBuilderOptionsRef"
pub extern type TargetData = "LLVMTargetDataRef"
pub extern type TargetMachine = "LLVMTargetMachineRef"
pub extern type Target = "LLVMTargetRef"
pub extern type Type = "LLVMTypeRef"
pub extern type Value = "LLVMValueRef"

// ---- enum values ----

pub let MODULE_FLAG_BEHAVIOR_WARNING = 1       // LLVMModuleFlagBehaviorWarning
pub let RETURN_STATUS_ACTION = 2               // LLVMReturnStatusAction
pub let INTEGER_TYPE_KIND = 8                  // LLVMIntegerTypeKind
pub let FLOAT_TYPE_KIND = 2                    // LLVMFloatTypeKind
pub let DOUBLE_TYPE_KIND = 3                   // LLVMDoubleTypeKind
pub let FUNCTION_TYPE_KIND = 9                 // LLVMFunctionTypeKind
pub let POINTER_TYPE_KIND = 12                 // LLVMPointerTypeKind
pub let EXTERNAL_LINKAGE = 0                   // LLVMExternalLinkage
pub let INTERNAL_LINKAGE = 8                   // LLVMInternalLinkage
pub let PRIVATE_LINKAGE = 9                    // LLVMPrivateLinkage
pub let AVAILABLE_EXTERNALLY_LINKAGE = 1       // LLVMAvailableExternallyLinkage
pub let GLOBAL_UNNAMED_ADDR = 2                // LLVMGlobalUnnamedAddr
pub let INT_EQ = 32                            // LLVMIntEQ
pub let INT_NE = 33                            // LLVMIntNE
pub let INT_SGE = 39                           // LLVMIntSGE
pub let INT_SGT = 38                           // LLVMIntSGT
pub let INT_SLE = 41                           // LLVMIntSLE
pub let INT_SLT = 40                           // LLVMIntSLT
pub let INT_UGE = 35                           // LLVMIntUGE
pub let INT_UGT = 34                           // LLVMIntUGT
pub let INT_ULE = 37                           // LLVMIntULE
pub let INT_ULT = 36                           // LLVMIntULT
pub let REAL_OEQ = 1                           // LLVMRealOEQ
pub let REAL_OGE = 3                           // LLVMRealOGE
pub let REAL_OGT = 2                           // LLVMRealOGT
pub let REAL_OLE = 5                           // LLVMRealOLE
pub let REAL_OLT = 4                           // LLVMRealOLT
pub let REAL_UNE = 14                          // LLVMRealUNE
pub let ATOMIC_RMW_BIN_OP_ADD = 1              // LLVMAtomicRMWBinOpAdd
pub let ATOMIC_RMW_BIN_OP_SUB = 2              // LLVMAtomicRMWBinOpSub
pub let ATOMIC_ORDERING_ACQUIRE = 4            // LLVMAtomicOrderingAcquire
pub let ATOMIC_ORDERING_MONOTONIC = 2          // LLVMAtomicOrderingMonotonic
pub let ATOMIC_ORDERING_RELEASE = 5            // LLVMAtomicOrderingRelease
pub let DI_FLAG_ARTIFICIAL = 64                // LLVMDIFlagArtificial
pub let DI_FLAG_ZERO = 0                       // LLVMDIFlagZero
pub let DWARF_EMISSION_FULL = 1                // LLVMDWARFEmissionFull
pub let DWARF_SOURCE_LANGUAGE_C99 = 11         // LLVMDWARFSourceLanguageC99
pub let CODE_GEN_LEVEL_NONE = 0                // LLVMCodeGenLevelNone
pub let CODE_GEN_LEVEL_DEFAULT = 2             // LLVMCodeGenLevelDefault
pub let CODE_GEN_LEVEL_AGGRESSIVE = 3          // LLVMCodeGenLevelAggressive
pub let RELOC_PIC = 2                          // LLVMRelocPIC
pub let CODE_MODEL_DEFAULT = 0                 // LLVMCodeModelDefault
pub let OBJECT_FILE = 1                        // LLVMObjectFile
pub let JIT_SYMBOL_GENERIC_FLAGS_CALLABLE = 4  // LLVMJITSymbolGenericFlagsCallable
pub let JIT_SYMBOL_GENERIC_FLAGS_EXPORTED = 1  // LLVMJITSymbolGenericFlagsExported
pub let ASSEMBLY_FILE = 0                      // LLVMAssemblyFile
pub let ABORT_PROCESS_ACTION = 0               // LLVMAbortProcessAction
pub let PRINT_MESSAGE_ACTION = 1               // LLVMPrintMessageAction
pub let RELOC_DEFAULT = 0                      // LLVMRelocDefault
pub let CODE_GEN_LEVEL_LESS = 1                // LLVMCodeGenLevelLess
pub let ATTRIBUTE_RETURN_INDEX = 0             // LLVMAttributeReturnIndex
pub let ATTRIBUTE_FUNCTION_INDEX = -1          // LLVMAttributeFunctionIndex
pub let WEAK_ANY_LINKAGE = 5                   // LLVMWeakAnyLinkage
pub let LINK_ONCE_ODR_LINKAGE = 3              // LLVMLinkOnceODRLinkage
pub let VOID_TYPE_KIND = 0                     // LLVMVoidTypeKind
pub let STRUCT_TYPE_KIND = 10                  // LLVMStructTypeKind
pub let ARRAY_TYPE_KIND = 11                   // LLVMArrayTypeKind