Red Bear OS
83a34a1515
Per local/AGENTS.md \xC2\xA7 "Category 2 - Local forks of upstream packages", all Cat 2 forks must use the `<upstream-tag>-rb<N>` version convention. The `-rb1` suffix is a Cargo pre-release identifier that prevents upstream `<upstream-tag>` from silently substituting for this fork in transitive dependency resolution. - The base tag (e.g. 0.9.0 for redox_syscall) tracks upstream unchanged. - The `rb1` part records that one Red Bear patch round has been applied on top of the upstream tag. This is the initial policy enforcement pass. The branch is considered unfrozen at this point; once a freeze is declared, future `-rbN` increments will land on a frozen `0.X.Y` branch per local/AGENTS.md.
Bootloader
Redox OS Bootloader
Requirements
These software needs to be available on the PATH at build time:
Building
make TARGET=<triplet> BUILD=build all
The <triplet> is one of:
| ARCH | Boot Mode | Triplets |
|---|---|---|
i686 |
BIOS | x86-unknown-none |
x86_64 |
BIOS | x86-unknown-none |
x86_64 |
UEFI | x86_64-unknown-uefi |
aarch64 |
UEFI | aarch64-unknown-uefi |
riscv64gc |
UEFI | riscv64gc-unknown-uefi |
See mk directory for more information of how the build is working.
Entry points
Please read Boot Process in the Redox OS Book for an introductory guide.
In this source code, some interesting files for entry points are:
- BIOS boot stages: asm/x86-unknown-none/bootloader.asm
- BIOS boot entry:
fn startat src/os/bios/mod.rs - UEFI boot entry:
fn mainat src/os/uefi/mod.rs - Common boot process:
fn mainat src/main.rs - UEFI kernel entry:
fn kernel_entryin each arch:x86_64: src/os/uefi/arch/x86_64.rsaarch64: src/os/uefi/arch/aarch64.rsriscv64gc: src/os/uefi/arch/riscv64/mod.rs
Debugging
QEMU
make TARGET=<triplet> BUILD=build qemu
How To Contribute
To learn how to contribute to this system component you need to read the following document:
Development
To learn how to do development with this system component inside the Redox build system you need to read the Build System and Coding and Building pages.