Danny
029642ae5b
Complete from-scratch Linux distribution targeting AMD Ryzen 9 9950X3D + NVIDIA RTX 5090 on ASUS ROG CROSSHAIR X870E HERO. Deliverables: - dpack: custom package manager in Rust (3,800 lines) - TOML package parser, dependency resolver, build sandbox - CRUX Pkgfile and Gentoo ebuild converters - Shared library conflict detection - 124 package definitions across 4 repos (core/extra/desktop/gaming) - 34 toolchain bootstrap scripts (LFS 13.0 adapted for Zen 5) - Linux 6.19.8 kernel config (hardware-specific, fully commented) - SysVinit init system with rc.d service scripts - Live ISO builder (UEFI-only, squashfs+xorriso) - Interactive installer (GPT partitioning, EFISTUB boot) - Integration test checklist (docs/TESTING.md) No systemd. No bootloader. No display manager. Kernel boots via EFISTUB → auto-login → dwl Wayland compositor. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
160 lines
5.1 KiB
Markdown
160 lines
5.1 KiB
Markdown
# DarkForge Linux
|
||
|
||
A custom, from-scratch Linux distribution built for one machine, one user — optimized ruthlessly for gaming and development.
|
||
|
||
## Target Hardware
|
||
|
||
| Component | Model |
|
||
|-----------|-------|
|
||
| CPU | AMD Ryzen 9 9950X3D (Zen 5, 16C/32T, 3D V-Cache) |
|
||
| RAM | Corsair Vengeance DDR5-6000 96GB CL30 (2×48GB) |
|
||
| Storage | Samsung 9100 PRO 2TB NVMe (PCIe 5.0 x4) |
|
||
| GPU | ASUS GeForce RTX 5090 ROG Astral LC OC 32GB GDDR7 |
|
||
| Motherboard | ASUS ROG CROSSHAIR X870E HERO |
|
||
|
||
## Architecture
|
||
|
||
DarkForge uses a minimal, transparent stack with no systemd:
|
||
|
||
- **Init:** SysVinit + custom rc.d scripts
|
||
- **Device manager:** eudev (no systemd dependency)
|
||
- **Boot:** EFISTUB — the kernel is the bootloader, no GRUB
|
||
- **Display:** Wayland via dwl compositor (dwm-like)
|
||
- **Audio:** PipeWire (started as user service)
|
||
- **Networking:** dhcpcd (ethernet only)
|
||
- **Package manager:** dpack (custom, written in Rust)
|
||
- **Shell:** zsh (user) / bash (build scripts)
|
||
- **Filesystem:** ext4
|
||
|
||
## Project Structure
|
||
|
||
```
|
||
darkforge/
|
||
├── CLAUDE.md # Project directive (AI assistant context)
|
||
├── README.md # This file
|
||
├── docs/
|
||
│ └── CHANGELOG.md # Mandatory changelog for every change
|
||
├── src/
|
||
│ ├── dpack/ # Custom package manager (Rust)
|
||
│ ├── iso/ # Live ISO builder
|
||
│ ├── install/ # Interactive installer
|
||
│ └── repos/ # Package definitions (124 packages)
|
||
│ ├── core/ # 67 base system packages
|
||
│ ├── extra/ # 26 libraries and frameworks
|
||
│ ├── desktop/ # 19 Wayland/desktop packages
|
||
│ └── gaming/ # 12 gaming packages
|
||
├── toolchain/ # Cross-compilation bootstrap scripts
|
||
│ ├── scripts/ # 34 build scripts (LFS Ch. 5-7)
|
||
│ ├── sources/ # Downloaded source tarballs
|
||
│ └── VERSION_MANIFEST.md
|
||
├── kernel/
|
||
│ └── config # Hardware-specific kernel .config
|
||
├── configs/
|
||
│ ├── rc.conf # System configuration
|
||
│ ├── inittab # SysVinit config
|
||
│ ├── rc.d/ # Service scripts
|
||
│ ├── zprofile # User shell profile (auto-starts dwl)
|
||
│ └── fstab.template # Filesystem table template
|
||
└── reference/ # LFS, BLFS, CRUX, Gentoo reference docs
|
||
```
|
||
|
||
## Build Phases
|
||
|
||
The project is built in sequential phases. Each phase has clear deliverables and exit criteria.
|
||
|
||
| Phase | Description | Status |
|
||
|-------|-------------|--------|
|
||
| 0 | Toolchain bootstrap (cross-compiler) | Scripts written |
|
||
| 1 | dpack core (parser, resolver, sandbox, db, build) | Implemented |
|
||
| 2 | dpack advanced (converters, solib, upgrade/remove) | Implemented |
|
||
| 3 | Base system packages (66 core/ definitions) | Complete |
|
||
| 4 | Kernel configuration | Complete |
|
||
| 5 | Init system and service scripts | Complete |
|
||
| 6 | Desktop environment (Wayland/dwl) | Definitions written |
|
||
| 7 | NVIDIA driver stack | Definition written |
|
||
| 8 | Gaming stack (Steam, Wine, Proton) | Definitions written |
|
||
| 9 | Application stack (WezTerm, FreeCAD) | Definitions written |
|
||
| 10 | ISO builder | Script written |
|
||
| 11 | Interactive installer | Scripts written |
|
||
| 12 | Integration testing | Pending |
|
||
|
||
## Quick Start
|
||
|
||
### Prerequisites
|
||
|
||
- A Linux host system for cross-compilation (or the target machine itself)
|
||
- GCC 15.2.0+ (for `-march=znver5` support)
|
||
- Rust toolchain (for building dpack)
|
||
- ~50GB disk space for the build
|
||
|
||
### 1. Build dpack
|
||
|
||
```bash
|
||
cd src/dpack
|
||
cargo build --release
|
||
sudo install -m755 target/release/dpack /usr/local/bin/
|
||
```
|
||
|
||
### 2. Bootstrap the toolchain
|
||
|
||
```bash
|
||
export LFS=/mnt/darkforge
|
||
# Create and mount your target partition, then:
|
||
bash toolchain/scripts/000-env-setup.sh
|
||
bash toolchain/scripts/000a-download-sources.sh
|
||
bash toolchain/scripts/build-all.sh cross
|
||
bash toolchain/scripts/build-all.sh temp
|
||
# Enter chroot and run Phase 7 scripts
|
||
```
|
||
|
||
### 3. Build the kernel
|
||
|
||
```bash
|
||
cp kernel/config /usr/src/linux-6.19.8/.config
|
||
cd /usr/src/linux-6.19.8
|
||
make olddefconfig
|
||
make -j32
|
||
make modules_install
|
||
cp arch/x86/boot/bzImage /boot/vmlinuz
|
||
```
|
||
|
||
### 4. Build the ISO
|
||
|
||
```bash
|
||
bash src/iso/build-iso.sh
|
||
```
|
||
|
||
### 5. Install
|
||
|
||
Boot the ISO on the target machine and run `install`.
|
||
|
||
## Compiler Flags
|
||
|
||
All packages are built with Zen 5 optimizations:
|
||
|
||
```bash
|
||
CFLAGS="-march=znver5 -O2 -pipe -fomit-frame-pointer"
|
||
CXXFLAGS="${CFLAGS}"
|
||
MAKEFLAGS="-j32"
|
||
LDFLAGS="-Wl,-O1,--as-needed"
|
||
```
|
||
|
||
## Key Design Decisions
|
||
|
||
- **No systemd** — SysVinit + rc.d for transparency and speed
|
||
- **No bootloader** — EFISTUB direct kernel boot
|
||
- **No display manager** — auto-login to tty1, dwl launched from shell profile
|
||
- **ext4** — simpler and faster than btrfs for this use case
|
||
- **96GB swap** — matches RAM size for hibernation support
|
||
- **Single target** — every optimization targets exactly this hardware
|
||
|
||
## License
|
||
|
||
The DarkForge project itself is MIT licensed. Individual packages retain their upstream licenses as documented in their `.toml` definitions.
|
||
|
||
## Repository
|
||
|
||
```
|
||
git@git.dannyhaslund.dk:danny8632/darkforge.git
|
||
```
|