Merge pull request #2457 from Kiirx/master

Added documentation to run a cosmos kernel on linux

Author: quajak

Docs/articles/Installation/Running.md

@@ -10,6 +10,61 @@ The ISO option creates an ISO image of the Cosmos output. This ISO file can be
 mounted and booted by most virtualization technologies. In addition, a physical
 optical disk can be burned and used to boot physical hardware.
 
+# Linux/Posix
+### DISCLAIMER: This article assumes that you are using a debian based operating system
+
+## QEMU
+Here you can use a generic run file, you can run it by using `sh run.sh -i <ISO> -m <memory size> -h <hdd image>`.
+It has to be at the root directory of the project
+
+QEMU is required and can be installed with `apt-get install qemu-system`.
+
+To create an hdd image, you have to convert this [.vmdk](https://github.com/CosmosOS/Cosmos/blob/master/Build/VMWare/Workstation/Filesystem.vmdk?raw=true) file to a .img wich can then be used by QEMU using the following command
+`qemu-img convert -f vmdk -O raw Filesystem.vmdk cosmos.img`
+
+`run.sh:`
+```sh
+#!/bin/bash
+
+helpFunction()
+{
+   echo ""
+   echo "Usage: $0 -i <ISO> -m <memory size> -h <hdd image>"
+   echo "\t-i ISO path to be used"
+   echo "\t-m Memory size to allocate to the Virtual Machine"
+   echo "\t-h Hard disk image location, can be created with qemu-img"
+   exit 1 # Exit script after printing help
+}
+
+while getopts "i:m:h:" opt
+do
+   case "$opt" in
+      i ) ISO="$OPTARG" ;;
+      m ) MEMORY_SIZE="$OPTARG" ;;
+      h ) HDD_IMAGE="$OPTARG" ;;
+      ? ) helpFunction ;; # Print helpFunction in case parameter is non-existent
+   esac
+done
+
+# Print helpFunction in case parameters are empty
+if [ -z "$ISO" ] || [ -z "$MEMORY_SIZE" ] || [ -z "$HDD_IMAGE" ]
+then
+   echo "Some or all of the parameters are empty";
+   helpFunction
+fi
+
+# Build the project
+dotnet build
+
+# Emulate the ISO
+qemu-system-x86_64 -boot d -cdrom $ISO -m $MEMORY_SIZE -hda $HDD_IMAGE
+```
+
+## Virtualbox
+Create a virtual machine and use this [.vmdk](https://github.com/CosmosOS/Cosmos/blob/master/Build/VMWare/Workstation/Filesystem.vmdk?raw=true) as HDD image
+
+# Windows
+
 ## VMWare
 
 WMWare Workstation and VMWare Player are the preferred testing environments
@@ -58,3 +113,5 @@ Wait and your os will boot up.
 ## Hyper-V
 
 Not supported at this time.
+
+