mirror of
https://github.com/phil-opp/blog_os.git
synced 2025-12-16 22:37:49 +00:00
70 lines
2.0 KiB
Markdown
70 lines
2.0 KiB
Markdown
# Blog OS (VGA Text Mode)
|
|
|
|
[](https://dev.azure.com/phil-opp/blog_os/_build?definitionId=1)
|
|
|
|
This repository contains the source code for the [VGA Text Mode][post] post of the [Writing an OS in Rust](https://os.phil-opp.com) series.
|
|
|
|
[post]: https://os.phil-opp.com/vga-text-mode/
|
|
|
|
**Check out the [master branch](https://github.com/phil-opp/blog_os) for more information.**
|
|
|
|
## Building
|
|
|
|
You need a nightly Rust compiler. First you need to install the `cargo-xbuild` and `bootimage` tools:
|
|
|
|
```
|
|
cargo install cargo-xbuild bootimage
|
|
```
|
|
|
|
Then you can build the project by running:
|
|
|
|
```
|
|
cargo xbuild
|
|
```
|
|
|
|
To create a bootable disk image, run:
|
|
|
|
```
|
|
cargo bootimage
|
|
```
|
|
|
|
This creates a bootable disk image in the `target/x86_64-blog_os/debug` directory.
|
|
|
|
Please file an issue if you have any problems.
|
|
|
|
## Running
|
|
|
|
You can run the disk image in [QEMU] through:
|
|
|
|
[QEMU]: https://www.qemu.org/
|
|
|
|
```
|
|
cargo xrun
|
|
```
|
|
|
|
Of course [QEMU] needs to be installed for this.
|
|
|
|
You can also write the image to an USB stick for booting it on a real machine. On Linux, the command for this is:
|
|
|
|
```
|
|
dd if=target/x86_64-blog_os/debug/bootimage-blog_os.bin of=/dev/sdX && sync
|
|
```
|
|
|
|
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.
|
|
|
|
## License
|
|
|
|
Licensed under either of
|
|
|
|
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
|
|
http://www.apache.org/licenses/LICENSE-2.0)
|
|
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
|
|
|
|
at your option.
|
|
|
|
Note that this only applies to this git branch, other branches might be licensed differently.
|
|
|
|
### Contribution
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
|