INotFail/Elyz
2
2
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: rename RINA to LISA

Browse Source
This commit is contained in:
Faynot
2026-06-23 22:48:46 +03:00
parent d542b5586d
commit 8a195462e5
3 changed files with 104 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files

152
README.md
View File

@@ -1,43 +1,47 @@
<h1 align="center"> <h1 align="center">
<img width="512" src="https://git.inotfail.com/ami-chuu/Elyz/raw/commit/3831cfd967afb60efe108a7579a767ec2309631b/logo.png" alt="Elyz"> <img width="512" src="./logo.png" alt="Elyz">
</h1> </h1>
<p align="center"> <p align="center">
<b>H2O</b> <b>H2O</b>
</p> </p>
Elyz is a microkernel operating system written in Rust. The project uses the Limine bootloader and supports multiple architectures. The current implementation includes basic kernel initialization, physical memory management, paging, and graphical output via framebuffer. **Elyz is a microkernel OS** that radically rejects the technological deadwood of the past. While traditional systems are hamstrung by decades of legacy code, Elyz is built on a foundation of uncompromising modernity.
We implement technologies that others can't afford. This isn't an attempt to fix the old, but to create a flexible and secure environment, building a proper OS from scratch, capable of instantly adapting to the challenges of tomorrow.
## Project Structure ## Project Structure
| Directory/File | Description | | Directory/File | Description |
|----------------|-------------| | -------------- | -------------------------------------- |
| `kernel/` | Kernel source code (Rust) | | `kernel/` | Kernel source code |
| `limine/` | Limine bootloader | | `limine/` | Limine bootloader |
| `ovmf/` | UEFI firmware for emulation | | `ovmf/` | UEFI firmware for emulation |
| `limine.conf` | Boot menu configuration | | `limine.conf` | Boot menu configuration |
| `GNUmakefile` | Main Makefile for building and running | | `GNUmakefile` | Main Makefile for building and running |
## System Requirements ## System Requirements
| Tool | Version/Requirements | Purpose | | Tool | Version/Requirements | Purpose |
|------|---------------------|---------| | -------- | ----------------------- | ------------------- |
| GNU Make | ≥ 4.0 | Project building | | GNU Make | ≥ 4.0 | Project building |
| Rust | Nightly with `rust-src` | Kernel compilation | | Rust | Nightly with `rust-src` | Kernel compilation |
| xorriso | Any | ISO image creation | | xorriso | Any | ISO image creation |
| sgdisk | Any | Disk image creation | | sgdisk | Any | Disk image creation |
| mtools | Any | Disk image handling | | mtools | Any | Disk image handling |
| QEMU | ≥ 6.0 | Emulation | | QEMU | ≥ 6.0 | Emulation |
**Installing dependencies:** **Installing dependencies:**
**Ubuntu/Debian:** **Ubuntu/Debian:**
```bash ```bash
sudo apt install make rustc xorriso gdisk mtools qemu-system-x86 sudo apt install make rustc xorriso gdisk mtools qemu-system-x86
rustup toolchain install nightly --component rust-src rustup toolchain install nightly --component rust-src
``` ```
**Arch Linux:** **Arch Linux:**
```bash ```bash
sudo pacman -S make rust xorriso gdisk mtools qemu-desktop sudo pacman -S make rust xorriso gdisk mtools qemu-desktop
rustup toolchain install nightly --component rust-src rustup toolchain install nightly --component rust-src
@@ -46,6 +50,7 @@ rustup toolchain install nightly --component rust-src
## Building and Running ## Building and Running
### Preparation ### Preparation
```bash ```bash
git clone https://git.inotfail.com/INotFail/Elyz.git git clone https://git.inotfail.com/INotFail/Elyz.git
cd Elyz cd Elyz
@@ -54,17 +59,18 @@ rustup override set nightly
### Main Makefile Targets ### Main Makefile Targets
| Target | Description | Result | | Target | Description | Result |
|--------|-------------|--------| | --------------- | --------------------------------- | -------------- |
| `make all` | Kernel compilation + ISO creation | `Elyz.iso` | | `make all` | Kernel compilation + ISO creation | `Elyz.iso` |
| `make run` | Full build + QEMU launch (BIOS) | UEFI emulation | | `make run` | Full build + QEMU launch (BIOS) | UEFI emulation |
| `make run-bios` | Run existing image (BIOS) | BIOS emulation | | `make run-bios` | Run existing image (BIOS) | BIOS emulation |
| `make run-uefi` | Full build + QEMU launch (UEFI) | UEFI emulation | | `make run-uefi` | Full build + QEMU launch (UEFI) | UEFI emulation |
| `make all-hdd` | Compilation + HDD/USB image | `Elyz.hdd` | | `make all-hdd` | Compilation + HDD/USB image | `Elyz.hdd` |
| `make run-hdd` | Build HDD + QEMU launch | HDD emulation | | `make run-hdd` | Build HDD + QEMU launch | HDD emulation |
| `make clean` | Clean build artifacts | — | | `make clean` | Clean build artifacts | — |
**Run examples:** **Run examples:**
```bash ```bash
# BIOS with auto-build # BIOS with auto-build
make run make run
@@ -80,14 +86,15 @@ make all-hdd
The `KARCH` environment variable sets the target architecture (default: `x86_64`). The `KARCH` environment variable sets the target architecture (default: `x86_64`).
| Architecture | `KARCH` value | Status | | Architecture | `KARCH` value | Status |
|--------------|---------------|--------| | ------------ | ------------- | ------------ |
| x86_64 | `x86_64` | Full support | | x86_64 | `x86_64` | Full support |
| AArch64 | `aarch64` | Experimental | | AArch64 | `aarch64` | Experimental |
| RISC-V 64 | `riscv64` | Experimental | | RISC-V 64 | `riscv64` | Experimental |
| LoongArch 64 | `loongarch64` | Experimental | | LoongArch 64 | `loongarch64` | Experimental |
**Running other architecture:** **Running other architecture:**
```bash ```bash
make run KARCH=aarch64 make run KARCH=aarch64
``` ```
@@ -96,59 +103,60 @@ make run KARCH=aarch64
## Current Functionality ## Current Functionality
| Component | Status | Description | | Component | Status | Description |
|-----------|--------|-------------| | -------------------- | ------- | -------------------------- |
| Limine Bootloader | ✅ Done | BIOS/UEFI support | | Limine Bootloader | ✅ Done | BIOS/UEFI support |
| Physical MM (Bitmap) | ✅ Done | Page bitmap | | Physical MM (Bitmap) | ✅ Done | Page bitmap |
| Page Tables (x86_64) | ✅ Done | 4-level addressing | | Page Tables (x86_64) | ✅ Done | 4-level addressing |
| Global Allocator | ✅ Done | Bump allocator (8MB) | | Global Allocator | ✅ Done | Bump allocator (8MB) |
| Framebuffer | ✅ Done | Graphical output | | Framebuffer | ✅ Done | Graphical output |
| Console | ✅ Done | Text output with scrolling | | Console | ✅ Done | Text output with scrolling |
## Memory System Development Status ## Memory System Development Status
| Task | Status | Note | | Task | Status | Note |
|------|--------|------| | --------------------------- | -------------- | ----------------------- |
| **Basic initialization** | ✅ Ready | Limine, MMU, PMM | | **Basic initialization** | ✅ Ready | Limine, MMU, PMM |
| **Physical allocator** | ✅ Ready | BitmapPMM working | | **Physical allocator** | ✅ Ready | BitmapPMM working |
| **Paging** | ✅ Ready | P4->P1 mapping | | **Paging** | ✅ Ready | P4->P1 mapping |
| **Global heap** | ✅ Ready | 8MB bump allocator | | **Global heap** | ✅ Ready | 8MB bump allocator |
| **Descriptor memory model** | ⏳ Not Started | Planned | | **Descriptor memory model** | ⏳ Not Started | Planned |
| **Processes and spaces** | ⏳ Not Started | No IPC | | **Processes and spaces** | ⏳ Not Started | No IPC |
| **Memory syscalls** | ⏳ Not Started | allocate/clone/transfer | | **Memory syscalls** | ⏳ Not Started | allocate/clone/transfer |
| **Weak references** | ⏳ Not Started | borrow/release | | **Weak references** | ⏳ Not Started | borrow/release |
| **Process auto-cleanup** | ⏳ Not Started | On exit | | **Process auto-cleanup** | ⏳ Not Started | On exit |
## Development Plan (TODO) ## Development Plan (TODO)
### Detailed Task List ### Detailed Task List
| # | Task | Subtasks | Priority | Dependencies | | # | Task | Subtasks | Priority | Dependencies |
|---|------|----------|----------|--------------| | --- | --------------------------- | ---------------------------------- | -------- | ------------ |
| 1 | **Descriptor memory model** | | High | PMM, VMM | | 1 | **Descriptor memory model** | | High | PMM, VMM |
| | | 1.1. `MemoryObject` structure | | | | | | 1.1. `MemoryObject` structure | | |
| | | 1.2. Descriptor table per process | | | | | | 1.2. Descriptor table per process | | |
| | | 1.3. Refcounting (strong/weak) | | | | | | 1.3. Refcounting (strong/weak) | | |
| | | 1.4. Syscalls: `allocate`, `clone` | | | | | | 1.4. Syscalls: `allocate`, `clone` | | |
| 2 | **Processes** | | High | Descriptors | | 2 | **Processes** | | High | Descriptors |
| | | 2.1. PCB structure | | | | | | 2.1. PCB structure | | |
| | | 2.2. Descriptor Table per process | | | | | | 2.2. Descriptor Table per process | | |
| | | 2.3. Auto-cleanup on exit | | | | | | 2.3. Auto-cleanup on exit | | |
| 3 | **Syscalls API** | | Medium | Processes | | 3 | **Syscalls API** | | Medium | Processes |
| | | 3.1. `transfer(desc, target)` | | | | | | 3.1. `transfer(desc, target)` | | |
| | | 3.2. `borrow(desc, duration)` | | | | | | 3.2. `borrow(desc, duration)` | | |
| | | 3.3. `release(desc)` | | | | | | 3.3. `release(desc)` | | |
| 4 | **MMU Integration** | | Medium | Syscalls | | 4 | **MMU Integration** | | Medium | Syscalls |
| | | 4.1. Page table per process | | | | | | 4.1. Page table per process | | |
| | | 4.2. Mapping by descriptors | | | | | | 4.2. Mapping by descriptors | | |
| | | 4.3. Unmapping on release | | | | | | 4.3. Unmapping on release | | |
| 5 | **Circular references** | | Low | All above | | 5 | **Circular references** | | Low | All above |
## Debugging ## Debugging
**Logs are output to QEMU console.** Panic output via serial port (COM1). **Logs are output to QEMU console.** Panic output via serial port (COM1).
**Useful QEMU options:** **Useful QEMU options:**
```bash ```bash
# Serial port for logs # Serial port for logs
make run QEMU_FLAGS="-serial stdio" make run QEMU_FLAGS="-serial stdio"
@@ -158,15 +166,17 @@ make run QEMU_FLAGS="-s -S"
``` ```
**Cleanup:** **Cleanup:**
```bash ```bash
make clean # Remove all artifacts make clean # Remove all artifacts
make distclean # + git clean make distclean # + git clean
``` ```
## Links ## Links
- Original Repository: https://git.inotfail.com/INotFail/Elyz - Original Repository: https://git.inotfail.com/INotFail/Elyz
- Related projects: - Related projects:
- Original template with bootloader: https://github.com/jasondyoungberg/limine-rust-template - Original template with bootloader: https://github.com/jasondyoungberg/limine-rust-template

2
kernel/Cargo.toml
View File

@@ -1,5 +1,5 @@
[package] [package]
name = "RINA" name = "LISA"
version = "0.1.0" version = "0.1.0"
edition = "2024" edition = "2024"

2
kernel/src/main.rs
View File

@@ -172,7 +172,7 @@ unsafe extern "C" fn kmain() -> ! {
let mut console = Console::new(FramebufferDisplay { framebuffer: &fb }); let mut console = Console::new(FramebufferDisplay { framebuffer: &fb });
console.clear(); console.clear();
info!(console, "BOOT", "RINA Kernel Starting..."); info!(console, "BOOT", "LISA Kernel Starting...");
unsafe { mem::pmm::BitmapPMM::init(&mmap_res, hhdm_offset); } unsafe { mem::pmm::BitmapPMM::init(&mmap_res, hhdm_offset); }
info!(console, "MEM", "Physical Memory Manager initialized."); info!(console, "MEM", "Physical Memory Manager initialized.");