mirror of
https://github.com/Leonmmcoset/cleonos.git
synced 2026-04-21 10:40:00 +00:00
40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
|
# CLeonOS Stage7
|
||
|
|
|
||
|
|
## Stage Goal
|
||
|
|
- Add user-space foundation under `/cleonos/` with C + Rust mixed development.
|
||
|
|
- Build first ELF app set: `/shell/shell.elf`, `/system/elfrunner.elf`, `/system/memc.elf`.
|
||
|
|
- Add user syscall wrapper (`int 0x80`) and minimal user runtime entry (`_start`).
|
||
|
|
- Integrate user ELF packaging into ramdisk build pipeline.
|
||
|
|
|
||
|
|
## Acceptance Criteria
|
||
|
|
- Kernel boots and prints `CLEONOS STAGE7 START`.
|
||
|
|
- FS and userland framework initialize without panic.
|
||
|
|
- Kernel logs `USERLAND FRAMEWORK ONLINE`.
|
||
|
|
- Kernel can probe and inspect all required ELF files:
|
||
|
|
- `/shell/shell.elf`
|
||
|
|
- `/system/elfrunner.elf`
|
||
|
|
- `/system/memc.elf`
|
||
|
|
- `make userapps` outputs 3 ELF files and `make iso` packs them into ramdisk.
|
||
|
|
|
||
|
|
## Build Targets
|
||
|
|
- `make setup`
|
||
|
|
- `make userapps`
|
||
|
|
- `make iso`
|
||
|
|
- `make run`
|
||
|
|
- `make debug`
|
||
|
|
|
||
|
|
## QEMU Command
|
||
|
|
- `qemu-system-x86_64 -M q35 -m 1024M -cdrom build/CLeonOS-x86_64.iso -serial stdio`
|
||
|
|
|
||
|
|
## Common Bugs and Debugging
|
||
|
|
- `missing tool: rustc` in `make setup`:
|
||
|
|
- Install Rust toolchain or set `RUSTC` to valid executable path.
|
||
|
|
- User ELF linking fails:
|
||
|
|
- Verify `USER_CC`, `USER_LD`, and `cleonos/c/user.ld` are valid.
|
||
|
|
- `USERLAND INIT FAILED` at boot:
|
||
|
|
- Confirm ramdisk contains `shell.elf`, `elfrunner.elf`, `memc.elf` in expected directories.
|
||
|
|
- `ELF INSPECT FAILED` on user files:
|
||
|
|
- Ensure built apps are ELF64 and not stripped into unsupported format.
|
||
|
|
- Ramdisk missing user apps:
|
||
|
|
- Run `make userapps` then `make iso`; check staging path `build/x86_64/ramdisk_root`.
|