How sanufar/karkinos works
Project type and purpose
• This is a minimal operating‐system kernel written in Rust, with support for BIOS and UEFI boot (via QEMU targets) plus an associated host‐side testing harness.
• Its purpose is to compile a kernel library/crate, link it into bootable images, and run it under QEMU (and to run unit tests in “kernel mode” where possible).
File structure
• Top-level files and tools:
• Cargo.toml, rust-toolchain.toml, .cargo/config.toml → define Rust toolchain, dependencies, sccache setup
• build.rs, Makefile, test.sh → orchestrate custom build steps, caching, QEMU invocation
• src/bin/*.rs → host‐side binaries to launch QEMU with BIOS or UEFI payloads
• src/main.rs → default host binary (e.g., convenience CLI)
• kernel/ → the actual kernel crate
– src/lib.rs, src/main.rs → kernel entry point and library API
– framebuffer.rs, gdt.rs, idt.rs, interrupts.rs, logger.rs → hardware setup & HAL layers
– src/tests/ → in-kernel unit tests (math.rs, etc.)
README for additional insights
• Project name: “karkínos” (‘crab’ in Greek)
• Notes mention sccache usage and a TODO in the build script for Homebrew paths