greatbridf_os/README.md

gbos

A simple OS kernel written in C++ and Rust that aims to be Linux compatible out of the box.

• Multitasking
• Memory management
• Filesystem implementation
• ELF program loader
• Some rather naive AHCI driver and FAT32 impl.
• TTY and job control interface (partially working)
• Move to Rust (WIP)
• SMP support (WIP)
• POSIX thread support (WIP)
• Network stack (WIP)
• Dynamic loader support
• Users, permission...

Build & Run

Prerequisites

Compile

• GCC (Tested) or

• Clang (It should work, but haven't been tested for a while.)

• Rust

• CMake

Generate disk image

• (Optional) busybox (We have a prebuilt version of busybox in the project directory)
• fdisk
• mtools

Debug and Run

• GDB
• QEMU

Build and Run

./configure && make prepare && make build

make nativerun

# or if you need debugging

# 1:
make srun

# 2:
make debug

You may want to specify the correct version of build tools to use when running ./configure in ENV.

• QEMU: QEMU used to debug run. qemu-system-x86_64 by default.
• GDB: GDB used by make debug. We will search for gdb and x86_64-elf-gdb and check the supported archs by default.
• FDISK_BIN: fdisk executable used to create disk image part tables. fdisk by default.

If you are doing a cross compile, run ./configure with CROSS_COMPILE set to the corresponding target triple of your cross compiler.

Run your own program

The user directory under the project dir exists mainly for some historical reason and has almost no use. So don't ever try to look inside that.

To copy your program into the built disk image, you can edit the CMakeLists.txt and add a line to the boot.img section. You can also try editing the init_script.sh to customize the booting procedure.