How sallespro/litebox works
LiteBox is a security-focused library OS: a North-side ABI shim pairs with a South-side platform to run guest programs while reducing their direct host interface. A representative workflow is an unmodified Linux program entering the Linux shim, using LiteBox services, and executing through a selected platform; runners configure concrete combinations. The workspace also includes Windows and OP-TEE shims, multiple platform implementations, and broker components. The graph preserves documented capabilities and indexed core modules; unsampled subsystem internals and connections are shown only where the README or source index supports them.
Main entry points: src/lib.rs Linux shim · src/lib.rs macOS platform · hvf_backend.rs HVF backend · src/lib.rs Linux ABI types
Components 27
Guest interfaces
- Linux shim
litebox_shim_linux/src/lib.rs - Linux file calls
litebox_shim_linux/src/syscalls/file.rs - Linux process calls
litebox_shim_linux/src/syscalls/process.rs - Windows shim
litebox_shim_windows/src/lib.rs - Windows sections
litebox_shim_windows/src/syscalls/section.rs - OP-TEE shim
litebox_shim_optee/src/lib.rs
LiteBox core
- LiteBox services
litebox/src/lib.rs - Linux ABI types
litebox_common_linux/src/lib.rs - Linux memory support
litebox_common_linux/src/mm.rs - Physical pointers
litebox_common_linux/src/physical_pointers.rs - Virtual mapping
litebox_common_linux/src/vmap.rs - Broker services
litebox_broker_core/src/lib.rs
Execution platforms
- macOS platform
litebox_platform_macos_userland/src/lib.rs - Guest management
litebox_platform_macos_userland/src/guest.rs - Darwin bindings
litebox_platform_macos_userland/src/darwin.rs - HVF backend
litebox_platform_macos_userland/src/hvf_backend.rs - HVF probe
litebox_platform_macos_userland/src/hvf.rs - HVF memory
litebox_platform_macos_userland/src/hvf_memory.rs - HVF vCPU
litebox_platform_macos_userland/src/hvf_vcpu.rs - HVF counters
litebox_platform_macos_userland/src/diagnostics_counters.rs - macOS vDSO
litebox_platform_macos_userland/src/vdso.rs - Linux platforms
litebox_platform_linux_userland/src/lib.rs - LVBS platform
litebox_platform_lvbs/src/lib.rs - SEV-SNP platform
litebox_platform_linux_kernel/src/lib.rs
Runners and brokers
- Platform runners
litebox_runner_linux_on_macos_userland/src/main.rs - Broker process
litebox_broker_userland/src/main.rs
Other components
- Guest program
Connections 32
- Guest program → Linux shim: issues Linux calls
README.md - Linux shim → LiteBox services: uses services
README.md - Linux shim → Linux file calls: dispatches file calls
litebox_shim_linux/src/lib.rs - Linux shim → Linux process calls: dispatches process calls
litebox_shim_linux/src/lib.rs - Linux shim → Linux ABI types: uses ABI types
- Windows shim → Windows sections: uses section calls
- Linux ABI types → Linux memory support: defines memory support
litebox_common_linux/src/lib.rs - Linux ABI types → Physical pointers: defines pointer support
litebox_common_linux/src/lib.rs - Linux ABI types → Virtual mapping: defines virtual mapping
litebox_common_linux/src/lib.rs - Physical pointers → Virtual mapping: referenced by
litebox_common_linux/src/physical_pointers.rs - Virtual mapping → Linux memory support: uses
litebox_common_linux/src/vmap.rs - Physical pointers → Virtual mapping: uses
litebox_common_linux/src/physical_pointers.rs - Linux shim → macOS platform: pairs with
README.md - Linux shim → Linux platforms: pairs with
README.md - Linux shim → LVBS platform: pairs with
README.md - Linux shim → SEV-SNP platform: pairs with
README.md - OP-TEE shim → Linux platforms: runs on
README.md - Platform runners → Linux shim: configures
- macOS platform → Darwin bindings: uses bindings
litebox_platform_macos_userland/src/lib.rs - macOS platform → Guest management: uses guest manager
litebox_platform_macos_userland/src/lib.rs - macOS platform → HVF backend: uses backend
litebox_platform_macos_userland/src/lib.rs - macOS platform → HVF probe: uses probe
litebox_platform_macos_userland/src/lib.rs - macOS platform → HVF memory: uses memory support
litebox_platform_macos_userland/src/lib.rs - macOS platform → HVF vCPU: uses vCPU support
litebox_platform_macos_userland/src/lib.rs - macOS platform → HVF counters: uses counters
litebox_platform_macos_userland/src/lib.rs - macOS platform → macOS vDSO: uses vDSO support
litebox_platform_macos_userland/src/lib.rs - HVF backend → HVF probe: references
litebox_platform_macos_userland/src/hvf_backend.rs - HVF backend → HVF memory: uses memory support
litebox_platform_macos_userland/src/hvf_backend.rs - HVF backend → HVF vCPU: uses vCPU support
litebox_platform_macos_userland/src/hvf_backend.rs - HVF backend → HVF counters: uses counters
litebox_platform_macos_userland/src/hvf_backend.rs - HVF backend → macOS vDSO: uses vDSO support
litebox_platform_macos_userland/src/hvf_backend.rs - Broker process → Broker services: uses broker core