README.md

   1 # loadnothing
   2 Can I run boot code?
   3
   4 Requires nasm and qemu-system-x86.
   5
   6 Rust nightly needs to be installed. If no nightly toolchain shows up
   7 when you run `rustup toolchain list`, install it:
   8
   9 ```sh
  10 rustup toolchain install nightly
  11 ```
  12
  13 # Building
  14 Follow the instructions below to build the project without running it.
  15
  16 ```sh
  17 rustup default nightly
  18 rustup component add rust-src
  19
  20 make nothing.img
  21 ```
  22
  23 # Running
  24 Simply type `make` to build and run the project.
  25 QEMU may require a VNC viewer.
  26
  27 If it's working you should see "Hello Stage2!" on the screen.
  28
  29 # Real Hardware
  30 It is possible to test this project on real hardware.
  31 The only supported platform at the moment is x86. UEFI is not supported
  32 and UEFI support is unlikely to be added in the future. If you use UEFI
  33 make sure to enable CSM / Legacy Boot in your UEFI settings.
  34 If you don't have CSM you can still use a virtual machine as explained above.
  35
  36 You can use `dd` to write the `nothing.img` file to a block device
  37 of your choice (but only if you've built it). It is exactly 32 MiB in size.
  38
  39 **This will overwrite the partition table so be careful not to write
  40 to the wrong device.**
  41
  42 You can then boot from the device. It should once again print "Hello Stage2!".