# FoundryOS

## Cloning
```sh
git clone https://git.zxq5.dev/OsDev/FoundryOS.git
```

## Build dependencies

* latest rust nightly release
* all necessary rust components installed
* xorriso: creates ISO images to be booted from.
* (Optional / Recommended) Qemu: to run the kernel. (this may be packaged as qemu-desktop)
* (Optional) GDB: for debugging the kernel.

```sh
rustup update
rustup override set nightly
rustup component add rust-src
rustup component add llvm-tools-preview
```

## Building & Running in Qemu:
```sh
cargo run
```

## Running in GDB:
```sh
USE_GDB=1 cargo run
```