Environment Variables Reference
English
| Variable | Default | Purpose |
|---|---|---|
ROOT_DIR | repo root | Override repository root. |
WORKSPACE_MANIFEST | Cargo.toml | Override workspace manifest path. |
CARGO_TARGET_DIR | target | Override Cargo target dir. |
CARGO | cargo | Cargo executable. |
RUSTUP | rustup | rustup executable. |
CC | gcc | C compiler. |
MINGW_CC | x86_64-w64-mingw32-gcc | Windows PE compiler. |
QEMU_BIN | qemu-system-x86_64 | QEMU executable. |
KERNEL_TARGET | x86_64-unknown-linux-gnu | Kernel/userspace target. |
GRUB_MKSTANDALONE | grub-mkstandalone | GRUB standalone EFI builder. |
GRUB_FILE | grub-file | Multiboot2 artifact validator. |
GPG | gpg | GPG executable used for detached kernel signatures. |
RUSTOS_GRUB_PUBKEY | build/dev-grub.pub | Binary GPG public key file embedded into GRUB, produced with gpg --export. |
RUSTOS_GRUB_SIGNING_KEY | RustOS Dev GRUB <rustos-dev-grub@example.invalid> | GPG key id or fingerprint used to sign nucleus.elf; xtask build creates the default development key when missing. |
RUSTOS_GPG_HOME | build/dev-grub-gpg | Optional GPG home for signing. |
RUSTOS_GRUB_SBAT | empty | Optional SBAT metadata file passed to grub-mkstandalone. |
RUSTOS_GRUB_MODULES | secure boot module set | Optional GRUB module list override. |
BUILD_DIR | build | Build output root. |
IMAGE_DIR | build/image | Staged image root. |
OVMF_PATH | vendor/firmware/ovmf/OVMF.fd | Firmware image. |
RUSTOS_QEMU_PROFILE | default | QEMU profile default. |
RUSTOS_QEMU_ACCEL | empty | QEMU accelerator profile default. |
RUSTOS_QEMU_NETWORK | enabled | Set 0, false, off, or no to disable default network. |
RUSTOS_UI_BOOT_TRACE | disabled | Enable uiserver local boot trace. |
RUSTOS_UI_PROFILE | disabled | Enable uiserver profiling lines. |
Most build variables are parsed by tools/xtask/src/config.rs. QEMU run
variables are parsed by tools/xtask/src/qemu.rs. For repeated KVM no-opt
debugging, use cargo xtask run --profile nvme --accel-profile kvm --usb-input --debugcon file --timeout 35 --summarize-log -- --no-reboot.
한국어
| Variable | Default | Purpose |
|---|---|---|
ROOT_DIR | repo root | repository root override |
WORKSPACE_MANIFEST | Cargo.toml | workspace manifest path override |
CARGO_TARGET_DIR | target | Cargo target dir override |
CARGO | cargo | Cargo executable |
RUSTUP | rustup | rustup executable |
CC | gcc | C compiler |
MINGW_CC | x86_64-w64-mingw32-gcc | Windows PE compiler |
QEMU_BIN | qemu-system-x86_64 | QEMU executable |
KERNEL_TARGET | x86_64-unknown-linux-gnu | kernel/userspace target |
GRUB_MKSTANDALONE | grub-mkstandalone | GRUB standalone EFI builder |
GRUB_FILE | grub-file | Multiboot2 artifact validator |
GPG | gpg | detached kernel signature 생성용 GPG executable |
RUSTOS_GRUB_PUBKEY | build/dev-grub.pub | gpg --export로 만든 GRUB embed용 binary GPG public key file |
RUSTOS_GRUB_SIGNING_KEY | RustOS Dev GRUB <rustos-dev-grub@example.invalid> | nucleus.elf 서명에 사용할 GPG key id/fingerprint. 없으면 xtask build가 기본 개발 키를 생성 |
RUSTOS_GPG_HOME | build/dev-grub-gpg | signing에 사용할 optional GPG home |
RUSTOS_GRUB_SBAT | empty | grub-mkstandalone에 넘길 optional SBAT metadata file |
RUSTOS_GRUB_MODULES | secure boot module set | optional GRUB module list override |
BUILD_DIR | build | build output root |
IMAGE_DIR | build/image | staged image root |
OVMF_PATH | vendor/firmware/ovmf/OVMF.fd | firmware image |
RUSTOS_QEMU_PROFILE | default | QEMU profile default |
RUSTOS_QEMU_ACCEL | empty | QEMU accelerator profile default |
RUSTOS_QEMU_NETWORK | enabled | 0, false, off, no로 default network 비활성화 |
RUSTOS_UI_BOOT_TRACE | disabled | uiserver local boot trace 활성화 |
RUSTOS_UI_PROFILE | disabled | uiserver profiling line 활성화 |
대부분의 build variable은 tools/xtask/src/config.rs에서 읽습니다. QEMU run
variable은 tools/xtask/src/qemu.rs에서 읽습니다. 반복 KVM no-opt 디버깅은
cargo xtask run --profile nvme --accel-profile kvm --usb-input --debugcon file --timeout 35 --summarize-log -- --no-reboot를 사용합니다.