LLVM

(Fn [LLVMTargetData, LLVMType] Int)

ABI alignment of ty in bytes.

(Fn [LLVMTargetData, LLVMType] Long)

ABI size of ty in bytes.

(Fn [LLVMValue, Int, LLVMAttribute] ())

Attach an attribute to a function/callsite at idx (see attr-*-index).

(Fn [LLVMValue, LLVMValue, LLVMBasicBlock] ())

Add a (on-val -> dest) case to a switch instruction.

(Fn [LLVMModule, (Ptr CChar), LLVMType] LLVMValue)

Declare a function name of type ty in mod.

(Fn [LLVMModule, LLVMType, (Ptr CChar)] LLVMValue)

Declare a global variable name of type ty in mod.

(Fn [LLVMValue, (Ref (Array LLVMValue) a), (Ref (Array LLVMBasicBlock) b)] ())

                        (add-incoming phi vals blocks)
                    

Add incoming vals/blocks (parallel arrays) to a phi node.

(Fn [LLVMModule, Int, (Ptr CChar), LLVMMetadata] ())

Add a module flag (key -> metadata) with a merge behavior.

(Fn [LLVMModule, (Ptr CChar), LLVMValue] ())

Append a value to a named metadata node (e.g. "llvm.ident").

(Fn [LLVMContext, LLVMValue, (Ptr CChar)] LLVMBasicBlock)

Append a basic block named name to function fn.

(Fn [LLVMType, Int] LLVMType)

An array of count elements of type elem.

Int

Attribute index for the function itself.

Int

Attribute index for the return value.

Int

Module-flag merge behavior: error on conflict.

Int

Module-flag merge behavior: warn on conflict.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs + rhs (integer).

(Fn [LLVMBuilder, LLVMType, (Ptr CChar)] LLVMValue)

Stack-allocate a slot of type ty.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs & rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit arithmetic lhs >> rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Reinterpret a value as another type of the same size.

(Fn [LLVMBuilder, LLVMBasicBlock] LLVMValue)

Emit an unconditional branch to dest.

(Fn [LLVMBuilder, LLVMType, LLVMValue, (Ref (Array LLVMValue) a), (Ptr CChar)] LLVMValue)

                        (build-call b fnty fn args name)
                    

Emit a call to fn (of type fnty) with args.

(Fn [LLVMBuilder, LLVMValue, LLVMBasicBlock, LLVMBasicBlock] LLVMValue)

Branch to then if cond else else.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Extract the element at idx (a value) from a vector.

(Fn [LLVMBuilder, LLVMValue, Int, (Ptr CChar)] LLVMValue)

Extract field idx from an aggregate value.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs + rhs (floating point).

(Fn [LLVMBuilder, Int, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit a floating-point comparison with one of the real-* predicates.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs / rhs (floating point).

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs * rhs (floating point).

(Fn [LLVMBuilder, LLVMValue, (Ptr CChar)] LLVMValue)

Emit -val (floating point).

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Extend a float to a wider float type.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Convert a float to a signed integer.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Convert a float to an unsigned integer.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Truncate a float to a narrower float type.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs % rhs (floating point).

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs - rhs (floating point).

(Fn [LLVMBuilder, LLVMType, LLVMValue, (Ref (Array LLVMValue) a), (Ptr CChar)] LLVMValue)

                        (build-gep b ty ptr indices name)
                    

Emit a getelementptr into ptr (of pointee type ty) with indices.

(Fn [LLVMBuilder, (Ptr CChar), (Ptr CChar)] LLVMValue)

Intern str as a private global and yield an i8* to it.

(Fn [LLVMBuilder, Int, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit an integer comparison with one of the int-* predicates.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Insert elt at idx (a value) into a vector.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, Int, (Ptr CChar)] LLVMValue)

Insert elt into field idx of an aggregate value.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Cast an integer to a pointer.

(Fn [LLVMBuilder, LLVMType, LLVMValue, (Ptr CChar)] LLVMValue)

Load a ty value from pointer ptr.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit logical lhs >> rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs * rhs (integer).

(Fn [LLVMBuilder, LLVMValue, (Ptr CChar)] LLVMValue)

Emit -val (integer).

(Fn [LLVMBuilder, LLVMValue, (Ptr CChar)] LLVMValue)

Emit ~val.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs | rhs.

(Fn [LLVMBuilder, LLVMType, (Ptr CChar)] LLVMValue)

Emit a phi node of type ty.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Cast a pointer to an integer.

(Fn [LLVMBuilder, LLVMValue] LLVMValue)

Emit ret val.

(Fn [LLVMBuilder] LLVMValue)

Emit ret void.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit signed lhs / rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit cond ? then : else.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Sign-extend an integer to a wider type.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs << rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Shuffle two vectors v1/v2 by the constant mask.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Convert a signed integer to a float.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit signed lhs % rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue] LLVMValue)

Store val into pointer ptr.

(Fn [LLVMBuilder, LLVMType, LLVMValue, Int, (Ptr CChar)] LLVMValue)

Emit a getelementptr to field idx of the struct ty behind ptr.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs - rhs (integer).

(Fn [LLVMBuilder, LLVMValue, LLVMBasicBlock, Int] LLVMValue)

Emit a switch on val with else as default, reserving num-cases slots. Add cases with add-case.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Truncate an integer to a narrower type.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit unsigned lhs / rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Convert an unsigned integer to a float.

(Fn [LLVMBuilder] LLVMValue)

Emit an unreachable terminator.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit unsigned lhs % rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMValue, (Ptr CChar)] LLVMValue)

Emit lhs ^ rhs.

(Fn [LLVMBuilder, LLVMValue, LLVMType, (Ptr CChar)] LLVMValue)

Zero-extend an integer to a wider type.

(Fn [LLVMContext] LLVMBuilder)

Create an IR builder bound to ctx.

(Fn [LLVMBuilder] ())

Free a builder.

(Fn [Long, Float] Float)

Call a JIT'd (float)->float function at addr with a.

(Fn [Long] Int)

Call a JIT'd ()->i32 function at addr.

(Fn [Long, Int] Int)

Call a JIT'd (i32)->i32 function at addr with a.

(Fn [Long, Int, Int] Int)

Call a JIT'd (i32,i32)->i32 function at addr with a and b.

(Fn [Long, Int, Int, Int] Int)

Call a JIT'd (i32,i32,i32)->i32 function at addr with a, b, and c.

(Fn [LLVMBuilder] ())

Clear the builder's current debug location.

Int

Optimization level: -O3.

Int

Optimization level: -O2.

Int

Optimization level: -O1.

Int

Optimization level: -O0.

Int

Code model: target default.

Int

Code model: small.

(Fn [LLVMType, Long, Int] LLVMValue)

An integer constant of type ty. sign-extend? sign-extends n.

(Fn [LLVMType] LLVMValue)

The all-zero/null constant of type ty (good for initializers).

(Fn [LLVMType, Double] LLVMValue)

A floating-point constant of type ty.

(Fn [(Ref (Array LLVMValue) a)] LLVMValue)

                        (const-vector elems)
                    

A constant vector from the scalar constants elems.

(Fn [] LLVMContext)

Create a fresh LLVM context. Dispose with context-dispose.

(Fn [LLVMContext] ())

Free a context and everything it owns.

(Fn [LLVMContext, Int, Long] LLVMAttribute)

Create an enum attribute of the given kind (see enum-attribute-kind).

(Fn [LLVMModule] LLVMEngine)

Create an MCJIT engine that takes ownership of mod. Returns a null handle on failure (check with engine-null?).

(Fn [LLVMContext, (Ptr CChar), (Ptr CChar)] LLVMAttribute)

Create a string (key=value) attribute.

(Fn [LLVMTargetMachine] LLVMTargetData)

The data layout of a target machine. Dispose with dispose-target-data; independent of the machine's lifetime.

(Fn [LLVMTarget, (Ptr CChar), (Ptr CChar), (Ptr CChar), Int, Int, Int] LLVMTargetMachine)

Create a target machine. cpu/features may be empty C strings; level/reloc/codemodel take the codegen-level-*/reloc-*/codemodel-* values.

(Fn [LLVMContext, Int, Int, LLVMMetadata] LLVMMetadata)

A source location (line, col) within scope.

(Fn [] String)

The host target triple (e.g. "arm64-apple-darwin24.6.0").

(Fn [LLVMDIBuilder, (Ptr CChar), Long, Int] LLVMMetadata)

A DWARF base type (name, size-in-bits, a dwarf-* encoding).

(Fn [LLVMModule] LLVMDIBuilder)

Create a debug-info builder for mod. Call di-finalize then di-builder-dispose when done.

(Fn [LLVMDIBuilder] ())

Free a debug-info builder.

(Fn [LLVMDIBuilder, LLVMMetadata, (Ptr CChar)] LLVMMetadata)

A C-language DWARF compile unit for file (defaults: unoptimized, full emission).

(Fn [LLVMDIBuilder, (Ptr CChar), (Ptr CChar)] LLVMMetadata)

A debug-info file entry (name, dir).

(Fn [LLVMDIBuilder] ())

Resolve all deferred debug-info nodes. Call before disposing.

(Fn [LLVMDIBuilder, LLVMMetadata, (Ptr CChar), LLVMMetadata, Int, LLVMMetadata] LLVMMetadata)

A DWARF subprogram for a function (defaults: definition, not-local, unoptimized).

(Fn [LLVMDIBuilder, LLVMMetadata, LLVMMetadata, Int] LLVMMetadata)

A file-specific scope nested under a function scope, for synthesized functions whose instructions originate in many files.

(Fn [LLVMDIBuilder, LLVMMetadata, (Ref (Array LLVMMetadata) a)] LLVMMetadata)

                        (di-subroutine-type b file param-types)
                    

A function-type descriptor. param-types is [return-type, arg-types...].

(Fn [LLVMTargetData] ())

Free a target data layout.

(Fn [LLVMTargetMachine] ())

Free a target machine.

(Fn [LLVMContext] LLVMType)

The double type.

(Fn [(Ref a b)] a)

Duplicate a handle out of a reference (e.g. from an array or accessor). Handles are trivially copyable pointers, but the @ operator needs a copy implementation they can't have, so use this instead.

Int

DWARF base-type encoding: boolean.

Int

DWARF base-type encoding: floating point.

Int

DWARF base-type encoding: signed integer.

Int

DWARF base-type encoding: unsigned integer.

(Fn [LLVMTargetMachine, LLVMModule, (Ptr CChar), Int] String)

Emit mod to path as filetype-object/filetype-assembly. Returns "" on success or an error String.

(Fn [LLVMEngine] ())

Free an execution engine (and the module it owns).

(Fn [LLVMEngine] Bool)

Whether engine creation failed.

(Fn [(Ptr CChar)] Int)

The numeric kind id for a named enum attribute (e.g. "noinline").

Int

Emit a textual assembly file.

Int

Emit an object file.

(Fn [LLVMContext] LLVMType)

The float type.

(Fn [LLVMEngine, (Ptr CChar)] Long)

Address of JIT-compiled function name as a Long, or 0 if absent.

(Fn [LLVMType, (Ref (Array LLVMType) a), Bool] LLVMType)

                        (function-type ret params vararg?)
                    

Function type returning ret with parameter types params. vararg? marks a C-style variadic function.

(Fn [LLVMBuilder] LLVMBasicBlock)

The basic block the builder is currently appending to (needed as the incoming block for a phi after emitting a branch's body).

(Fn [LLVMModule, (Ptr CChar)] LLVMValue)

Look up a declared function by name (may be a null handle).

(Fn [LLVMModule, (Ptr CChar)] LLVMValue)

Look up a global variable by name (may be a null handle).

(Fn [LLVMValue, Int] LLVMValue)

The i-th parameter of function value fn.

(Fn [] Int)

Initialize the host asm printer. Returns 0 on success.

(Fn [] Int)

Initialize codegen for the host target. Returns 0 on success.

(Fn [LLVMValue] Bool)

Whether an LLVM value is an instruction rather than a constant, function, global, or argument.

Int

icmp predicate: equal.

Int

icmp predicate: not equal.

Int

icmp predicate: signed >=.

Int

icmp predicate: signed >.

Int

icmp predicate: signed <=.

Int

icmp predicate: signed <.

Int

icmp predicate: unsigned >=.

Int

icmp predicate: unsigned >.

Int

icmp predicate: unsigned <=.

Int

icmp predicate: unsigned <.

(Fn [LLVMContext] LLVMType)

The i1 (boolean) type.

(Fn [LLVMContext] LLVMType)

The i16 type.

(Fn [LLVMContext] LLVMType)

The i32 type.

(Fn [LLVMContext] LLVMType)

The i64 type.

(Fn [LLVMContext] LLVMType)

The i8 type.

(Fn [] ())

Pull the MCJIT engine into the link. Call once before creating an engine.

Int

External linkage (the default for defined functions/globals).

Int

Internal linkage (static, module-private).

Int

Private linkage (not in the symbol table).

(Fn [LLVMContext, (Ptr CChar)] Int)

Intern a metadata kind name (e.g. "dbg", "tbaa") to an id.

(Fn [LLVMContext, (Ref (Array LLVMMetadata) a)] LLVMMetadata)

                        (md-node ctx operands)
                    

Create a metadata node (tuple) from operands.

(Fn [LLVMContext, (Ptr CChar)] LLVMMetadata)

Create a metadata string.

(Fn [LLVMMemoryBuffer] Bool)

Whether a memory-buffer read failed.

(Fn [(Ptr CChar)] LLVMMemoryBuffer)

Read a file into a memory buffer, or a null handle on error.

(Fn [LLVMContext, LLVMMetadata] LLVMValue)

Wrap metadata as a value (for set-metadata/named metadata).

(Fn [(Ptr CChar), LLVMContext] LLVMModule)

Create a module named name in ctx.

(Fn [LLVMModule] ())

Free a module.

(Fn [LLVMModule] Bool)

Whether a module handle is null (e.g. a failed parse).

(Fn [LLVMTargetData, LLVMType, Int] Long)

Byte offset of struct element idx under a data layout.

(Fn [LLVMOrcLLJIT, LLVMOrcJITDylib, LLVMOrcThreadSafeModule] String)

Add a thread-safe module to the persistent JIT. The JIT takes ownership when called, including on failure. Returns an error string.

(Fn [LLVMOrcLLJIT, LLVMOrcResourceTracker, LLVMOrcThreadSafeModule] String)

Add a thread-safe module under tracker. ORC takes module ownership when called, including on failure.

(Fn [LLVMOrcJITDylib] String)

Remove every resource published in a JITDylib. Returns an error string; the LLJIT and its shared context remain alive.

(Fn [] LLVMOrcLLJIT)

Create a host LLJIT, or a null handle on failure.

(Fn [LLVMOrcLLJIT] ())

Dispose a persistent LLJIT and all code it owns.

(Fn [LLVMOrcThreadSafeContext] ())

Release the caller's shared-context reference.

(Fn [LLVMOrcLLJIT] String)

Make symbols from the current process and RTLD_GLOBAL libraries visible to JIT modules. Returns an error string.

(Fn [LLVMOrcLLJIT] Bool)

Whether LLJIT creation failed.

(Fn [LLVMOrcLLJIT, (Ptr CChar)] Long)

Look up a published symbol, returning its address or zero.

(Fn [LLVMOrcLLJIT] LLVMOrcJITDylib)

The main JITDylib owned by jit.

(Fn [LLVMOrcResourceTracker] ())

Release the caller's resource-tracker reference.

(Fn [LLVMOrcResourceTracker] String)

Remove every JIT resource associated with a tracker.

(Fn [LLVMOrcJITDylib] LLVMOrcResourceTracker)

Create a resource tracker for one incremental module. Release the caller's reference after publishing or removing it.

(Fn [LLVMContext] LLVMOrcThreadSafeContext)

Transfer ctx into a shared ORC context. Do not dispose ctx separately after this call.

(Fn [LLVMModule, LLVMOrcThreadSafeContext] LLVMOrcThreadSafeModule)

Wrap mod in the shared context and transfer module ownership to the wrapper.

(Fn [LLVMContext, LLVMMemoryBuffer] LLVMModule)

Parse textual IR or bitcode in buf into a module (consumes buf). Returns a null-module handle on error; check with module-null?.

(Fn [] LLVMPassBuilderOptions)

Create pass-builder options. Dispose with pass-options-dispose.

(Fn [LLVMPassBuilderOptions] ())

Free pass-builder options.

(Fn [LLVMType, Int] LLVMType)

A pointer to elem in the given address space.

(Fn [LLVMBuilder, LLVMBasicBlock] ())

Point the builder at the end of block.

(Fn [LLVMModule] String)

Render a module's textual IR as a Carp String (owns the copy).

Int

fcmp predicate: ordered equal.

Int

fcmp predicate: ordered >=.

Int

fcmp predicate: ordered >.

Int

fcmp predicate: ordered <=.

Int

fcmp predicate: ordered <.

Int

fcmp predicate: ordered not equal.

Int

fcmp predicate: unordered or equal.

Int

fcmp predicate: unordered or not equal.

Int

Relocation model: target default.

Int

Relocation model: position-independent.

Int

Relocation model: static.

(Fn [LLVMModule, (Ptr CChar), LLVMTargetMachine, LLVMPassBuilderOptions] String)

Run a pass pipeline (e.g. "default", "instcombine,mem2reg") on mod. Returns "" on success or an error String.

(Fn [LLVMBuilder, LLVMMetadata] ())

Set the builder's current debug location for emitted instructions.

(Fn [LLVMValue, Int] ())

Mark a global variable as constant (1) or mutable (0).

(Fn [LLVMValue, LLVMValue] ())

Set the constant initializer of a global variable.

(Fn [LLVMValue, LLVMMetadata] ())

Attach a debug location directly to an instruction value.

(Fn [LLVMValue, Int] ())

Set the linkage of a function or global with a linkage-* value.

(Fn [LLVMValue, Int, LLVMValue] ())

Attach metadata node of kind kind-id to an instruction value.

(Fn [LLVMModule, LLVMTargetData] ())

Attach a data layout to a module.

(Fn [LLVMValue, LLVMMetadata] ())

Attach a di-function subprogram to a function value.

(Fn [LLVMModule, (Ptr CChar)] ())

Set the module's target triple.

Dynamic

                        (setup :rest prefix)
                    

Wire include paths and linking against a Homebrew LLVM keg. prefix defaults to the Homebrew LLVM keg on macOS and the output of llvm-config --prefix elsewhere. Pass another LLVM prefix as the first argument to override it.

(Fn [LLVMContext, (Ptr CChar)] LLVMType)

Create an (initially opaque) named struct type in ctx. Fill it in later with struct-set-body — this is how you build recursive types.

(Fn [LLVMType, (Ref (Array LLVMType) a), Bool] ())

                        (struct-set-body ty elems packed?)
                    

Set the field types of a named struct.

(Fn [LLVMContext, (Ref (Array LLVMType) a), Bool] LLVMType)

                        (struct-type ctx elems packed?)
                    

An anonymous struct type with fields elems. packed? removes padding.

(Fn [(Ptr CChar)] LLVMTarget)

Look up the target for a triple. Null handle on failure (see target-null?).

(Fn [LLVMTarget] Bool)

Whether a target lookup failed.

(Fn [LLVMValue] LLVMMetadata)

View a value (e.g. a constant) as metadata.

(Fn [LLVMValue] Bool)

Whether a value handle is null (e.g. a failed named lookup).

(Fn [LLVMType, Int] LLVMType)

A fixed-width vector of count elements of type elem.

(Fn [LLVMModule] String)

Verify a module. Returns "" if valid, else the error String.

(Fn [LLVMContext] LLVMType)

The void type.

(Fn [LLVMModule, (Ptr CChar)] Int)

Write module bitcode to path. Returns 0 on success.

(Fn [LLVMModule, (Ptr CChar)] String)

Write textual IR to path. Returns "" on success or an error String.