Asterinas is a secure, fast, and general-purpose OS kernel, written in Rust and providing Linux-compatible ABI.
Go to file
Arthur Paulino 6a67807fd0 Implement `IdSet::iter_in`
This patch enables more expressive ways to slice and iterate over
the `Id`s in an `IdSet` with `IdSet::iter_in`, which takes an arbitrary
`IdSetSlicer`.

`IdSet::iter_in` efficiently slices out unintended inner parts and
then, within the remaining parts, skips inactive bits by using
`BitSlice::iter_ones` from the `bitvec` crate.

It also delivers several implementations of `IdSetSlicer` so OSTD
consumers can represent `Id` ranges ergonomically.

In the Asterinas kernel, `CpuSet::iter_in` enables a cleaner way to
define an interator that cycles over the CPUs.
2025-10-25 11:23:13 +08:00
.github Bump version to 0.16.1 2025-09-24 13:55:48 +08:00
.vscode Use rust-analyzer for riscv64 and loongarch64 target 2025-08-29 16:57:06 +08:00
book Support arrays with multiple element types in SCML 2025-10-22 20:30:30 +08:00
kernel Implement `IdSet::iter_in` 2025-10-25 11:23:13 +08:00
osdk Bump version to 0.16.1 2025-09-24 13:55:48 +08:00
ostd Implement `IdSet::iter_in` 2025-10-25 11:23:13 +08:00
test Add test for multi-threaded execve 2025-10-25 10:36:30 +08:00
tools Upgrade Linux kernel version to 6.16.0 in Docker images 2025-09-18 10:06:46 +08:00
.code-workspace
.dockerignore Rename regression to test 2024-06-28 20:33:21 +08:00
.gitignore Let git ignore profile results 2025-02-13 16:01:40 +08:00
.licenserc.yaml
.typos.toml Add the `arch::cpu::cpuid` module 2025-09-10 12:10:40 +08:00
CODEOWNERS Assign pci code owner 2025-09-21 10:32:23 +08:00
COPYRIGHT
Cargo.lock Implement fixed_point module to replace the usage of fixed crate 2025-10-13 12:34:01 +08:00
Cargo.toml chore: allow unexpected_cfgs `cfg(ktest)` to circumvent warnings 2025-09-30 11:44:24 +08:00
Components.toml Init PCI compoment 2025-09-21 10:32:23 +08:00
DOCKER_IMAGE_VERSION Bump the Docker image to 0.16.1 2025-09-23 14:55:50 +08:00
LICENSE-MPL
Makefile Fix a problem of using INITRAMFS_SKIP_GZIP=1 2025-09-27 20:53:05 +08:00
OSDK.toml Add the support for LoongArch in OSDK 2025-07-25 17:37:24 +08:00
README.md Update README.md for ICSE 2026 paper acceptance 2025-10-18 17:58:52 +08:00
README_CN.md Add Benchmark Intel TDX badge 2025-10-13 13:34:04 +08:00
README_JP.md Add Benchmark Intel TDX badge 2025-10-13 13:34:04 +08:00
RELEASES.md Add the release notes for version 0.16.0 2025-08-05 09:11:17 +08:00
VERSION Bump version to 0.16.1 2025-09-24 13:55:48 +08:00
rust-toolchain.toml Upgrade the toolchain to nightly-2025-02-01 2025-02-27 09:05:03 +08:00
rustfmt.toml Add macros `chmod` and `mkmod` 2025-09-22 10:20:36 +08:00
triagebot.toml Manage S-waiting-on-author and S-waiting-on-review automatically 2024-10-24 19:12:04 +08:00

README.md

asterinas-logo
A secure, fast, and general-purpose OS kernel written in Rust and compatible with Linux
Test x86-64 Test riscv64 Test loongarch64 Test Intel TDX Benchmark x86-64 Benchmark Intel TDX

English | 中文版 | 日本語

News:

Congratulations to the Asterinas community🎉🎉🎉

Introducing Asterinas

Asterinas is a secure, fast, and general-purpose OS kernel that provides Linux-compatible ABI. It can serve as a seamless replacement for Linux while enhancing memory safety and developer friendliness.

  • Asterinas prioritizes memory safety by employing Rust as its sole programming language and limiting the use of unsafe Rust to a clearly defined and minimal Trusted Computing Base (TCB). This innovative approach, known as the framekernel architecture, establishes Asterinas as a more secure and dependable kernel option.

  • Asterinas surpasses Linux in terms of developer friendliness. It empowers kernel developers to (1) utilize the more productive Rust programming language, (2) leverage a purpose-built toolkit called OSDK to streamline their workflows, and (3) choose between releasing their kernel modules as open source or keeping them proprietary, thanks to the flexibility offered by MPL.

While the journey towards a production-grade OS kernel is challenging, we are steadfastly progressing towards this goal. Over the course of 2024, we significantly enhanced Asterinas's maturity, as detailed in our end-year report. In 2025, our primary goal is to make Asterinas production-ready on x86-64 virtual machines and attract real users!

Getting Started

Get yourself an x86-64 Linux machine with Docker installed. Follow the three simple steps below to get Asterinas up and running.

  1. Download the latest source code.
git clone https://github.com/asterinas/asterinas
  1. Run a Docker container as the development environment.
docker run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.16.1-20250922
  1. Inside the container, go to the project folder to build and run Asterinas.
make build
make run

If everything goes well, Asterinas is now up and running inside a VM.

The Book

See The Asterinas Book to learn more about the project.

License

Asterinas's source code and documentation primarily use the Mozilla Public License (MPL), Version 2.0. Select components are under more permissive licenses, detailed here. For the rationales behind the choice of MPL, see here.