Skip to content

Latest commit

 

History

History
51 lines (38 loc) · 2.16 KB

README.md

File metadata and controls

51 lines (38 loc) · 2.16 KB
Raw

Requirements

rOS was built and tested on Ubuntu 20.04 LTS via WLS. Programs needed to build and mount on a virtual machine are:

  • nasm, version 2.14.02
  • as, GNU assembler 2.34
  • ld, GNU ld 2.34
  • make, GNU 4.2.1
  • gcc-10
  • g++-10
  • Virtualbox

NASM may be substituted for as to build assembly files. MinGW or Cygwin could be used and configured on windows operating sytems if WLS is not available.

Pointer to the location programs may be changed in the header portion of the Makefile.

Environment Setup

  1. Ubuntu 20.04 OR Windows 10, Update 2004 or higher with WSL 2

    • Open Command prompt to enable WSL and Virtual Machine Platform

      dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

    • You also need to update the WSL to WSL 2 Linux kernel

    • Set WLS 2 as the default version

      wsl --set-default-version 2

    • Install Ubuntu 20.04 or higher

    • To check your version of WSL run wsl -l -v, and possibly run wsl --set-version {MACHINE_NAME} 2 to change the version to 2.

  2. Alternativly Ubuntu 20.04 or higher
  3. Install required software, and VirtualBox 
    sudo apt-get update -y
sudo apt-get install -y nasm binutils gcc-10 g++-10

Build & Test

  1. Ensure the path to the VirtualBox is correct in the Makefile
  2. Build and Run the VM 
    make VMSetup
make startVM