Skip to content

Concepts

The ideas that make xollvm predictable and safe to deploy. Read these once and the rest of the docs — every pass, every flag — falls into place.

Architecture

The module analysis, the config cache, the entry pass, and the function driver — how a build flows end to end.

Annotation model

Why obfuscation is opt-in per function, how llvm.global.annotations is parsed, and how configs merge.

Pipeline & ordering

The topological order the driver enforces, the vmflattening conflict, and how to override ordering.

Determinism & seeds

The base → module → function → pass seed cascade and the manifest that makes builds auditable.

Safety rails & budgeting

Instruction / block / loop-depth gates and the IR-growth budget that stop obfuscation from exploding.

Presets

The light / medium / high / max bundles for mba and vm, and the recommended per-tier strategy bundles.