Skip to main content

Module engine

Module engine 

Source
Expand description

Engine selection — map a (defvm …) Hypervisor to an in-process [maquina_engine::MaquinaEngine].

Only the Rust-native backends are real engines (zero shell-out): Libkrun (tateru) and Kasou (VZ). Vfkit / VfkitDarwin / Qemu are CLI emitters (the vfkit module) with no in-process engine — selecting them here is an error by design (see theory/MAQUINA.md § zero-shell-out).

The real engines live behind tatara-vm’s engines feature (macOS), which forwards to maquina-engine’s tateru-backend + kasou-backend. Without that feature (the default build, or any non-macOS target), engine_for reports the engine as unavailable so the host-agnostic build of tatara-vm stays dependency-light.

Enums§

EngineSelectError
Why an engine could not be selected for a hypervisor.

Functions§

engine_for
Fallback when no engine backend is compiled in (default build / non-macOS).