https://github.com/refcell/rust_os
Rust-powered OS following the https://os.phil-opp.com/ tutorial
https://github.com/refcell/rust_os
Last synced: 8 months ago
JSON representation
Rust-powered OS following the https://os.phil-opp.com/ tutorial
- Host: GitHub
- URL: https://github.com/refcell/rust_os
- Owner: refcell
- License: mit
- Created: 2021-05-30T15:45:40.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-05-31T20:26:04.000Z (about 5 years ago)
- Last Synced: 2025-01-03T17:34:44.192Z (over 1 year ago)
- Language: Rust
- Size: 24.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rust_os
Rust-powered OS following the https://os.phil-opp.com/ tutorial
## Building
Requires
- [Rust Nightly](https://doc.rust-lang.org/book/appendix-07-nightly-rust.html)
- In short, `rustup toolchain install nightly` installs the nightly build and `rustup override set nightly` sets the toolchain as nightly for this project directory
- `rust-src` component (install with `rustup component add rust-src`)
- `bootimage` tool to compile kernal and bootloader and then link the two together after, creating a bootable disk image.
- Install with `cargo install bootimage`
- Requires `llvm-tools-preview` rustup component (install with `rustup component add llvm-tools-preview`).
Build: `cargo build` or specify the verbose build target with `cargo build --target x86-64-blog-os.json`
Create a bootable disk: `cargo bootimage`
## Booting
Boot in QEMU: `qemu-system-x86_64 -drive format=raw,file=target/x86-64-blog-os/debug/bootimage-rust-os.bin`
This opens a window like:
## Write to a USB Stick
Run `dd if=target/x86-64-blog-os/debug/bootimage-rust-os.bin of=/dev/sdX && sync`
NOTE (from [os.phil-opp.com](https://os.phil-opp.com/minimal-rust-kernel/#real-machine)):
```
Where sdX is the device name of your USB stick. Be careful to choose the correct device name, because everything on that device is overwritten.
```
## Running
Compile kernal and boot into QEMU with `cargo run`
## Testing
Simply run `cargo test` in the root directory.