Skip to content

Interested-Deving-1896/litebox

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

529 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

[update-readmes] Mode: rewrite — migrating to template structure...

litebox

Built with Ona

LiteBox is a security-focused library operating system designed to support execution in both kernel and user modes. It provides a modular framework for running applications across various platforms, including Linux, Windows, and trusted execution environments like OP-TEE. Developers and researchers use LiteBox to build and test secure, isolated execution environments with fine-grained control over system calls and platform-specific behavior.

Architecture

The LiteBox architecture consists of modular components designed to support security-focused library OS functionality across multiple platforms. The project is organized into distinct crates, each addressing specific aspects of the system, such as kernel-mode execution, user-mode execution, platform-specific implementations, and syscall rewriting. Interaction between components is facilitated through shared libraries and common interfaces, enabling portability and modularity.

Key components include:

  • litebox: Core library OS logic.
  • litebox_common_*: Shared utilities and abstractions for Linux and OP-TEE platforms.
  • litebox_platform_*: Platform-specific implementations for Linux kernel, userland, Windows userland, and other environments.
  • litebox_runner_*: Execution environments for various configurations, such as Linux userland and OP-TEE on Linux.
  • litebox_shim_*: Shims for platform-specific syscall handling.
  • litebox_syscall_rewriter: Module for rewriting syscalls to enhance security.
  • dev_tests/dev_bench: Development utilities for testing and benchmarking.

Directory structure:

litebox/
├── litebox/
├── litebox_common_linux/
├── litebox_common_optee/
├── litebox_platform_linux_kernel/
├── litebox_platform_linux_userland/
├── litebox_platform_windows_userland/
├── litebox_platform_lvbs/
├── litebox_platform_multiplex/
├── litebox_runner_linux_userland/
├── litebox_runner_linux_on_windows_userland/
├── litebox_runner_lvbs/
├── litebox_runner_optee_on_linux_userland/
├── litebox_shim_linux/
├── litebox_syscall_rewriter/
├── dev_tests/
└── dev_bench/

Components interact through shared interfaces defined in litebox_common_* crates, while platform-specific logic resides in litebox_platform_* and litebox_runner_* crates.

Install

git clone https://github.com/Interested-Deving-1896/litebox.git
cd litebox

Usage

Configuration

CI

  • ci.yml: Runs tests, builds all workspace members, and checks formatting and linting using cargo fmt and cargo clippy. No secrets required.

  • copilot-setup-steps.yml: Validates GitHub Copilot configuration and ensures proper setup for contributors. No secrets required.

  • semver-checks.yml: Verifies semantic versioning compliance for public APIs using cargo semver-checks. No secrets required.

Mirror chain

This repo is maintained in Interested-Deving-1896/litebox and mirrored through:

Interested-Deving-1896/litebox  ──►  OpenOS-Project-OSP/litebox  ──►  OpenOS-Project-Ecosystem-OOC/litebox

Changes flow downstream automatically via the hourly mirror chain in fork-sync-all. Direct commits to OSP or OOC are detected and opened as PRs back to Interested-Deving-1896.

Contributors

This repository is a mirror. The upstream source can be found here.

Origins

Original project — no upstream fork.

Resources

No additional resource files found.

License

MIT © 2026 Interested-Deving-1896

About

A security-focused library OS supporting kernel- and user-mode execution

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Rust 95.7%
  • C 1.5%
  • JavaScript 1.4%
  • CSS 0.4%
  • Assembly 0.4%
  • Python 0.3%
  • Other 0.3%