A second iteration of the RoureXOS operating system, rewritten in Rust.
The goal of this project is to make the rou2exOS kernel to follow the microkernel architecture. For purposes of the external program development, there are two key links to consider opening when thinking about extending the system:
- ABI specification document
- Syscall client implementation examples (aka
rou2exOSApps)
To run the OS, you can use the attached ISO image from any Release, and run it in QEMU emulator. The system was also tested on the x86_64 baremetal (booted from the USB flash disk). To enable the filesystem functionalities, attach a IMG file to QEMU as well (in virtual floppy drive A).
qemu-system-x86_64 -boot d -cdrom r2.iso -fda fat.img
# install Rust and its dependencies
make init
# make sure you have `xorriso`, `net-tools` and `grub2-tools` (or just grub-tools)
# installed (Linux)
dnf install xorriso net-tools grub2-tools qemu qemu-common qemu-system-x86
# compile the kernel and stage2 bootloader, link it into an ELF binary and bake into an ISO
# image with GRUB stage1 bootloader
make build
# run the QEMU emulation with ISO image
make run_iso
# create a floppy image and attach it to virtual machine (will enable filesystem-related features)
# please do note that the floppy image is overwritten every time you hit this target
make run_iso_floppy
# (alternative) run the kernel exclusively only (needs the `bootloader`
# dependency in Cargo.toml to be added)
cargo bootimage
make runStart a virtual machine to receive the pty handle:
make run_iso
char device redirected to /dev/pts/3 (label serial0)
Listen for SLIP packets and create a sl0 interface:
sudo slattach -L -p slip -s 115200 /dev/pts/3
sudo ifconfig sl0 192.168.3.1 pointopoint 192.168.3.2 up
Catch packets using tcpdump:
sudo tcpdump -i sl0
Run the response command in the system shell to handle ICMP
response
Now you should be able to ping the machine from your machine
ping 192.168.3.2
Download a font (ideally in PSF format), add the selected font file into src/video/fonts as console.psf.
To convert a font from BDF format use the bdf2psf utility (should be available in the Linux distro repos). We especially want to render the font to Framebuffer (--fb flag). An example command syntax is shown below.
bdf2psf --fb terminus-font-4.49.1/ter-u16b.bdf /usr/share/bdf2psf/standard.equivalents /usr/share/bdf2psf/ascii.set 256 console.psf