Merge branch 'master' of https://github.com/TheFocusMan/Cosmos

Author: TheFocusMan

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.
+
+

SOLUTIONS.md

@@ -1,53 +1,39 @@
-# Solution File ReadMe
-
-### Cosmos
-- Old monolithic solution.
-- Will be removed after all smaller parts split out.
-- Use of this solution is necessary for some users until all parts are split out.
-
-### Build
-- Used by the build process (Builder).
-- Not meant for direct end user use.
-- Do not change unless you know what you are doing.
-
-### Builder
-
-Projects used to build Cosmos itself. Essentially this is what makes User Kit go.
-
-- C.B.Builder - Essentially the user kit. A C# program which automates the building and installation of Cosmos wtih a GUI.
-
-- C.B.Insaller - This is the UAC workaround task?
-
-- Add C.B.Common & C.B.MSBuild or to compiler?
-
-### Compiler
-
-Parts:
-- Assembler
-- Compiler
-- XSharp (Compiler Parts)
-- Tools (Compiler Parts)
-
-Notes:
-- In future XSharp may be separated or a SLN with only XSharp parts in it. But it is needed often when using compiler.
-
-Bin Cache Dependencies:
-
-### IDE
-
-TODO Exists, but needs cleaned up still a lot.
-
-Debug, Deploy, Visual Studio, XSharp (IDE Parts), Tools (IDE Parts)
-
-### Kernel
-
-- Kernel, Demos (not  User), Tests
-
-### Tests
-
-- All unit tests
-
-### Tools
-
-- Misc Tools 
-
+# Visual Studio Solutions
+
+## `Build.sln`
+Currently contains every used Cosmos component for
+using by Cosmos Builder to compile and pack code.
+Do not use it in Visual Studio directly and do not
+modify it, unless you know what you're doing.
+
+## `Builder.sln`
+Currently contains only Cosmos Builder app project 
+that used to compile, pack and install Cosmos.
+
+## `IDE.sln`
+Currently contains Visual Studio extensions for VS
+integration. Do not confuse with `Kernel.sln`.
+
+## `Kernel.sln`
+Currently contains the main Cosmos code that runs on
+target virtual machines. If you want to modify OS
+behavior more percisely, contribute to this solution.
+### Cosmos.System2
+Contains the highest library, that controls entire
+system abstractly, as another manage mostly hardware.
+### Cosmos.HAL2
+Contains Hardware Abstraction Layer and most of 
+system drivers used by Cosmos. These include PS/2,
+PCI, PIT, etc.
+### Cosmos.Core
+Contains the most basic things that used by NET BCL
+and Cosmos, such as Plugs and XSharp snippets.
+
+## `Demos.sln`
+Currently contains user-made Cosmos project examples.
+Also, it can be used as test solution
+
+## `Test.sln`
+Currently contains all unit tests that Cosmos uses
+to ensure that there are no bugs. You can use it while
+development of new features of DevKit to test new changes