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