50b731f1b7
Derivative of Redox OS (https://www.redox-os.org) adding: - AMD GPU driver (amdgpu) via LinuxKPI compat layer - ext4 filesystem support (ext4d scheme daemon) - ACPI fixes for AMD bare metal (x2APIC, DMAR, IVRS, MCFG) - Custom branding (hostname, os-release, boot identity) Build system is full upstream Redox with RBOS overlay in local/. Patches for kernel, base, and relibc are symlinked from local/patches/ and protected from make clean/distclean. Custom recipes live in local/recipes/ with symlinks into the recipes/ search path. Build: make all CONFIG_NAME=redbear-full Sync: ./local/scripts/sync-upstream.sh
2.8 KiB
2.8 KiB
Redox OS Fork — Wayland, KDE & Linux Driver Compatibility
Technical documentation for forking Redox OS to include Wayland protocol support, KDE Plasma desktop environment, and a Linux driver compatibility layer.
Documents
| # | Document | Description |
|---|---|---|
| 01 | Architecture Overview | Redox OS internals: microkernel, scheme system, driver model, display stack |
| 02 | Gap Analysis & Roadmap | What's missing between current Redox and our Wayland/KDE/driver-compat goals |
| 03 | Wayland on Redox | Deep-dive into Wayland protocol requirements and current porting status |
| 04 | Linux Driver Compatibility Layer | Design for a FreeBSD LinuxKPI-style driver compatibility shim |
| 05 | KDE Plasma on Redox | Feasibility study and implementation plan for KDE Plasma |
| 06 | Build System Setup | How to build Redox from this repository |
Current State Summary (as of Redox 0.9.0)
- Display server: Orbital (custom, scheme-based) — works
- Wayland: Experimental, WIP. Smallvil (Smithay) and cosmic-comp partially working.
libwayland patched with shimmed-out
signalfd,timerfd,eventfd. - X11: Working via X.org dummy driver inside Orbital.
- Mesa: Software-rendered only (LLVMpipe/OSMesa). No GPU acceleration.
- GPU drivers: VESA framebuffer + VirtIO GPU only. Experimental Intel modesetting.
- KDE: 19 app recipes in WIP, no KDE Plasma infrastructure.
- Linux driver compat: None. Redox explicitly chose source-level porting over binary compat.
Quick Start
# 1. Install dependencies (Arch/Manjaro)
sudo pacman -S --needed --noconfirm gdb meson nasm patchelf python-mako \
doxygen expat file fuse3 gmp libjpeg-turbo libpng po4a scons \
sdl12-compat syslinux texinfo xdg-utils zstd
# 2. Install Rust + tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install just cbindgen
# 3. Configure for native build (no Podman)
echo 'PODMAN_BUILD?=0' > .config
# 4. Build (downloads cross-toolchain, then compiles)
make all
# 5. Run in QEMU
make qemu
Key Repositories
| Repo | Purpose | URL |
|---|---|---|
| Kernel | Microkernel | https://gitlab.redox-os.org/redox-os/kernel |
| Base | Drivers + system components | https://gitlab.redox-os.org/redox-os/base |
| relibc | C library (Rust) | https://gitlab.redox-os.org/redox-os/relibc |
| Orbital | Display server + WM | https://gitlab.redox-os.org/redox-os/orbital |
| RedoxFS | Default filesystem | https://gitlab.redox-os.org/redox-os/redoxfs |
| libredox | System library | https://gitlab.redox-os.org/redox-os/libredox |
| This repo | Build system | https://gitlab.redox-os.org/redox-os/redox |