Documentation

An integer with a given width in bits.

32 bit floating point

64 bit floating point

80 bit (x86 only) floating point

128 bit floating point

A pointer to a LlvmType

An array of LlvmType

A vector of LlvmType

A LlvmVar can represent a label (address)

Void type

Packed structure type

Unpacked structure type

A type alias

LLVM Metadata

Function type, used to create pointers to functions

Mutable global variable

Constant global variable

Alias of another variable

Variables with a global scope.

Variables local to a function or parameters.

Named local variables. Sometimes we need to be able to explicitly name variables (e.g for function arguments).

A constant variable

Refers to an integer constant (i64 42).

Floating point literal

Literal NULL, only applicable to pointer types

Vector literal

Undefined value, random bit pattern. Useful for optimisations.

A comment in a static section

A static variant of a literal value

For uninitialised data

Defines a static LMString

A static array

A static structure type

A pointer to other data

Pointer to Pointer conversion

Pointer to Integer conversion

Constant addition operation

Constant subtraction operation

This indicates to the code generator that the parameter or return value should be zero-extended to a 32-bit value by the caller (for a parameter) or the callee (for a return value).

This indicates to the code generator that the parameter or return value should be sign-extended to a 32-bit value by the caller (for a parameter) or the callee (for a return value).

This indicates that this parameter or return value should be treated in a special target-dependent fashion during while emitting code for a function call or return (usually, by putting it in a register as opposed to memory).

This indicates that the pointer parameter should really be passed by value to the function.

This indicates that the pointer parameter specifies the address of a structure that is the return value of the function in the source program.

This indicates that the pointer does not alias any global or any other parameter.

This indicates that the callee does not make any copies of the pointer that outlive the callee itself

This indicates that the pointer parameter can be excised using the trampoline intrinsics.

This attribute indicates that the inliner should attempt to inline this function into callers whenever possible, ignoring any active inlining size threshold for this caller.

This attribute indicates that the source code contained a hint that inlining this function is desirable (such as the "inline" keyword in C/C++). It is just a hint; it imposes no requirements on the inliner.

This attribute indicates that the inliner should never inline this function in any situation. This attribute may not be used together with the alwaysinline attribute.

This attribute suggests that optimization passes and code generator passes make choices that keep the code size of this function low, and otherwise do optimizations specifically to reduce code size.

This function attribute indicates that the function never returns normally. This produces undefined behavior at runtime if the function ever does dynamically return.

This function attribute indicates that the function never returns with an unwind or exceptional control flow. If the function does unwind, its runtime behavior is undefined.

This attribute indicates that the function computes its result (or decides to unwind an exception) based strictly on its arguments, without dereferencing any pointer arguments or otherwise accessing any mutable state (e.g. memory, control registers, etc) visible to caller functions. It does not write through any pointer arguments (including byval arguments) and never changes any state visible to callers. This means that it cannot unwind exceptions by calling the C++ exception throwing methods, but could use the unwind instruction.

This attribute indicates that the function does not write through any pointer arguments (including byval arguments) or otherwise modify any state (e.g. memory, control registers, etc) visible to caller functions. It may dereference pointer arguments and read state that may be set in the caller. A readonly function always returns the same value (or unwinds an exception identically) when called with the same set of arguments and global state. It cannot unwind an exception by calling the C++ exception throwing methods, but may use the unwind instruction.

This attribute indicates that the function should emit a stack smashing protector. It is in the form of a "canary"—a random value placed on the stack before the local variables that's checked upon return from the function to see if it has been overwritten. A heuristic is used to determine if a function needs stack protectors or not.

If a function that has an ssp attribute is inlined into a function that doesn't have an ssp attribute, then the resulting function will have an ssp attribute.

This attribute indicates that the function should always emit a stack smashing protector. This overrides the ssp function attribute.

If a function that has an sspreq attribute is inlined into a function that doesn't have an sspreq attribute or which has an ssp attribute, then the resulting function will have an sspreq attribute.

This attribute indicates that the code generator should not use a red zone, even if the target-specific ABI normally permits it.

This attributes disables implicit floating point instructions.

This attribute disables prologue / epilogue emission for the function. This can have very system-specific consequences.

Normal call, allocate a new stack frame.

Tail call, perform the call in the current stack frame.

The C calling convention. This calling convention (the default if no other calling convention is specified) matches the target C calling conventions. This calling convention supports varargs function calls and tolerates some mismatch in the declared prototype and implemented declaration of the function (as does normal C).

This calling convention attempts to make calls as fast as possible (e.g. by passing things in registers). This calling convention allows the target to use whatever tricks it wants to produce fast code for the target, without having to conform to an externally specified ABI (Application Binary Interface). Implementations of this convention should allow arbitrary tail call optimization to be supported. This calling convention does not support varargs and requires the prototype of al callees to exactly match the prototype of the function definition.

This calling convention attempts to make code in the caller as efficient as possible under the assumption that the call is not commonly executed. As such, these calls often preserve all registers so that the call does not break any live ranges in the caller side. This calling convention does not support varargs and requires the prototype of all callees to exactly match the prototype of the function definition.

The GHC-specific registerised calling convention.

Any calling convention may be specified by number, allowing target-specific calling conventions to be used. Target specific calling conventions start at 64.

X86 Specific StdCall convention. LLVM includes a specific alias for it rather than just using CC_Ncc.

Global values with internal linkage are only directly accessible by objects in the current module. In particular, linking code into a module with an internal global value may cause the internal to be renamed as necessary to avoid collisions. Because the symbol is internal to the module, all references can be updated. This corresponds to the notion of the static keyword in C.

Globals with linkonce linkage are merged with other globals of the same name when linkage occurs. This is typically used to implement inline functions, templates, or other code which must be generated in each translation unit that uses it. Unreferenced linkonce globals are allowed to be discarded.

weak linkage is exactly the same as linkonce linkage, except that unreferenced weak globals may not be discarded. This is used for globals that may be emitted in multiple translation units, but that are not guaranteed to be emitted into every translation unit that uses them. One example of this are common globals in C, such as int X; at global scope.

appending linkage may only be applied to global variables of pointer to array type. When two global variables with appending linkage are linked together, the two global arrays are appended together. This is the Llvm, typesafe, equivalent of having the system linker append together sections with identical names when .o files are linked.

The semantics of this linkage follow the ELF model: the symbol is weak until linked, if not linked, the symbol becomes null instead of being an undefined reference.

The symbol participates in linkage and can be used to resolve external symbol references.

Alias for ExternallyVisible but with explicit textual form in LLVM assembly.

Symbol is private to the module and should not appear in the symbol table

add two integer, floating point or vector values.

subtract two ...

multiply ..

unsigned integer or vector division.

signed integer ..

unsigned integer or vector remainder (mod)

signed ...

add two floating point or vector values.

subtract two ...

multiply ...

divide ...

remainder ...

Left shift

Logical shift right Shift right, filling with zero

Arithmetic shift right The most significant bits of the result will be equal to the sign bit of the left operand.

AND bitwise logical operation.

OR bitwise logical operation.

XOR bitwise logical operation.

Equal (Signed and Unsigned)

Not equal (Signed and Unsigned)

Unsigned greater than

Unsigned greater than or equal

Unsigned less than

Unsigned less than or equal

Signed greater than

Signed greater than or equal

Signed less than

Signed less than or equal

Float equal

Float not equal

Float greater than

Float greater than or equal

Float less than

Float less than or equal

Integer truncate

Integer extend (zero fill)

Integer extend (sign fill)

Float truncate

Float extend

Float to unsigned Integer

Float to signed Integer

Unsigned Integer to Float

Signed Int to Float

Pointer to Integer

Integer to Pointer

Cast between types where no bit manipulation is needed