rust-osdev / rust-osdev/bootimage

[README] If you wanna boot on real hardware!

Open
#98 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
906
Forks
70
PR merge metrics
No merged PRs in 30d

Description

Hello everyone,

I saw some issues regarding this.
And i self had also some trouble getting this to work.

To boot on real hardware make sure you have LEGACY booting enabled or CSM.
UEFI wont work.

Like on default on my PC you can on default only boot UEFI

After that just do this

    cargo clean
    cargo bootimage --target yourtarget.json --release

    cd target/x86_64-youros/release
    sudo dd if=bootimage-youros.bin of=/dev/yourusb bs=4M status=progress && sync

and then boot the usb stick trough your bootmenu

Hopes that helped.

This is not an issue this is just an "post" to help others with this.
You can maybe add this to the README (in an better format)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the README and the real-hardware boot steps in the issue, including legacy/CSM booting, the cargo bootimage command, and writing the image to USB. Add a clearly formatted README section if appropriate, preserving the relevant commands and making the hardware prerequisites understandable.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation, operating-systems
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.