An application suite for the rou2exOS kernel. All aplications must follow (implement) the syscall ABI specification.
Languages currently implementing (parts of) the ABI:
- C
- C++
- Go (using TinyGo)
- NASM
- Rust
Each listed language has its workspace in a related directory in the repository root. Each implementation example should include:
- linker script (
linker.ld) - Makefile
- README.md (optional)
- the source code file(s)
The linker script should ensure proper memory alignment with the .text section at the beginning.
At the moment, all executables (elf-x86-64) have to be converted into a flat memory binary file. ELF files cannot be loaded directly yet. See tooling below for more.
All executable should be of the format of elf64-x86-64 (OUTPUT_FORMAT). The r2 kernel is now capable of loading and running ELF executables, just provide a file with the .ELF extension.
dir
-> PRINT.ELF
run PRINT
To run a binary (.BIN) in the r2 shell, it has to be loaded onto a floppy image with FAT12 filesystem (see the root Makefile). When it's loaded, boot the system using attached ISO image and the floppy image:
qemu-system-x86_64 -boot d -m 2G -cdrom r2.iso -fda fat.img
In the shell, ensure the file is there and then just load it and run (do not include the binary extension):
dir
-> PRINT.BIN
runb PRINT
Tooling strictly depends on the selected language. However, these tools are required to be able to compile, link, convert, and debug the source code:
- mtools
- llvm tools
- lld
- qemu
- gnumake
- gcc (cross compiler)
- nasm