docs and name changes

README.md

@@ -1,6 +1,6 @@
 # Kybus
 
-Kybus is a repository
+Kybus is a repository which aims to provide a vulnerable environment for blue team members to safely experiment with a selected CVE.
 
 ## Requirements
 
@@ -21,14 +21,39 @@ All versions mentioned above are only what was used during testing, other versio
 
 ## Getting Started
 
-Running `setup.sh` will ensure requisites are installed and download needed VM images.
-The Kybus container image will also be generated during this process
+Running `setup.sh` will ensure prerequisites are installed, and download needed VM images.
+The Kybus container image will also be generated during this process.
+
+## Initial Run
+
+When running Kybus for the first time a VM will be created with the name `kybus_kybus`.
+Since all setup and tear down is conducted within a temporary container, this will be the only indication left on the system once Kybus is run.
+
+If you run `docker ps` during the run of Kybus, you will see a `kybus:latest` image running; running `docker ps -a` post run will not show anything since the `--rm` flag is passed when creating the container.
 
 ## Writing a Plugin
 
 Initial plugin structure can be generated using `ansible-galaxy role init {plugin name}`.
 Plugin names are suggested to be the relavent CVE record; however, certain plugins exist as helpers and may deviate.
 
-Once the plugin is created
+Once the plugin is created everything follows a standard [ansible role](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse_roles.html) structure.
+The only additional information which needs to be added into the structure is a `meta/kybus.yml` configuration file.
+This file defines the appropriate image to be used with the role.
+The image name should be exactly as it appears once downloaded in the `download` folder.
+An example can be seen below:
+
+```yaml
+---
+image: {image name with extension}
+...
+
+```
+
+If this is still unclean please reference a role which is already complete.
+
+## Completed Roles
+
+Below is a list of completed roles along with there current state of testing:
+
+- CVE-2011-2523
 
-##

kybus

@@ -10,6 +10,25 @@ source ./_libs/libbase.sh
 # shellcheck disable=SC1091
 source ./kybus.conf
 
+function helpKybus {
+  cat <<EOF
+------
+Kybus - Automated Vulnerability Deployment
+Author: Spencer
+------
+
+--cve -c          Select the CVE to deploy
+
+--list-roles      Display a list of available roles to deploy
+
+--destroy         Destroys any Kybus environment previously deployed
+                  By default running a new role will destroy any prior
+
+--help -h         Displays this message
+
+EOF
+}
+
 function initKybus {
   StatusEcho "Cleaning up old Environment"
   rm -f .kybusenv >/dev/null
@@ -69,7 +88,7 @@ function ArgParse {
         ;;
       --help | -h)
         shift
-        WarningEcho "Not implemented"
+        helpKybus
         exit 0
         ;;
       --list-roles)

roles/CVE-2011-2523/tasks/main.yml

@@ -1,4 +1,8 @@
 ---
+- name: Update package cache
+  apt:
+    update_cache: yes
+
 - name: Install build deps
   ansible.builtin.package:
     name: