mirror of
https://github.com/Leonmmcoset/cleonos.git
synced 2026-04-21 10:40:00 +00:00
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
|
# CLeonOS Stage6
|
||
|
|
|
||
|
|
## Stage Goal
|
||
|
|
- Add ramdisk filesystem foundation in CLKS based on the Limine module.
|
||
|
|
- Parse tar-format ramdisk and build hierarchical directory/file nodes.
|
||
|
|
- Provide VFS-style path interfaces for stat/read/list operations.
|
||
|
|
- Enforce required root layout: `/system`, `/shell`, `/temp`, `/driver`.
|
||
|
|
|
||
|
|
## Acceptance Criteria
|
||
|
|
- Kernel boots and prints `CLEONOS STAGE6 START`.
|
||
|
|
- Filesystem logs `RAMDISK VFS ONLINE` and node/file statistics.
|
||
|
|
- Root layout validation reports `/SYSTEM /SHELL /TEMP /DRIVER OK`.
|
||
|
|
- `clks_fs_count_children("/")` returns non-zero and is logged.
|
||
|
|
- Kernel continues to scheduler/ELF/syscall/interrupt init without panic.
|
||
|
|
|
||
|
|
## Build Targets
|
||
|
|
- `make setup`
|
||
|
|
- `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
|
||
|
|
- `NO RAMDISK MODULE FROM LIMINE`:
|
||
|
|
- Verify `module_path: boot():/boot/cleonos_ramdisk.tar` exists in `configs/limine.conf`.
|
||
|
|
- `RAMDISK TAR PARSE FAILED`:
|
||
|
|
- Ensure ramdisk is packed as tar (`make ramdisk`) and module size is not zero.
|
||
|
|
- `MISSING REQUIRED DIRECTORY`:
|
||
|
|
- Confirm ramdisk root contains `/system`, `/shell`, `/temp`, `/driver`.
|
||
|
|
- Filesystem APIs always fail:
|
||
|
|
- Check `clks_fs_init()` is called and `clks_fs_is_ready()` is true.
|
||
|
|
- Build failure on new symbols:
|
||
|
|
- Confirm `ramdisk.c` and `fs.c` are present in `C_SOURCES`.
|