Embedding the VM

Host Lopolith from a C program: load modules once, create VMs, run entry classes on host threads, and shut everything down cleanly.

What you need

• A built toolchain: make (the VM objects and the loth CLI) and make libs (the standard library plugins).
• A C compiler. The host links the VM objects directly; no shared VM library is needed.

The running example

The track builds one host program: two entry classes that run concurrently on two host threads, sharing one VM and one singleton.

AppA: shared n=...
AppB: shared n=5000
total=5000 expect=5000
HOST OK

Chapters

• 01 Concepts — the three surfaces, Engine vs VM, when to embed.
• 02 Your first host — the lifecycle, in order, with a minimal program.
• 03 Loading modules — dependencies, .lothc, native library lookup.
• 04 Running code — vm_run, vm_call, arguments, exit codes, output.
• 05 Concurrency — one shared VM, or many isolated VMs.
• 06 Operations — building, errors, limits, troubleshooting.