# OSDK User Reference

OSDK is a command line tool that can be used as a subcommand of Cargo. The common usage of OSDK is:

```bash
cargo osdk <COMMAND>
```

You can use `cargo osdk -h` to see the full list of available commands. For the specific usage of a subcommand, you can use `cargo osdk help <COMMAND>`.

## Manifest

OSDK utilizes a manifest named `OSDK.toml` to define its precise behavior regarding how to run a kernel with QEMU. The `OSDK.toml` file should be placed in the same folder as the project's `Cargo.toml`. The [Manifest documentation](manifest.md) provides an introduction to all the available configuration options.

The command line tool can also be used to set the options in the manifest. If both occur, the command line options will always take priority over the options in the manifest. For example, if the manifest defines the path of QEMU as:

```toml
[qemu]
path = "/usr/bin/qemu-system-x86_64"
```

But the user provides a new QEMU path when running the project using:

```bash
cargo osdk run --qemu.path="/usr/local/qemu-kvm"
```

Then, the actual path of QEMU should be `/usr/local/qemu-kvm` since command line options have higher priority.