doc: converting org mode to markdown

examples/README.md

@@ -1,18 +1,18 @@
-#+TITLE: Examples and proofs of concept
+# Examples and proofs of concept
 
 This directory is used to highlight proofs of concept and help ease the understanding and development of the sparse framework
 
 Each example/proof of concept listed is listed in the order it was added, and highlights the feature being developed that was supplemented by such a proof of concept.
-To learn more about the project, it is recommended to follow along in the same order when reviewing source code.
+To learn more about the project, it is recommended to follow along the proofs of concept in the following order.
 
-* bind-shell
+## bind-shell
 
-[[./bind-shell/README.org][README]]
+[bind-shell README](./bind-shell/README.md)
 
 This example was used to set up the dev containers workspace, to verify that the static linking against libpcap was actually possible and feasible, and to see how small binaries could get when statically linked
 
-* reverse-shell
+## reverse-shell
 
-[[./reverse-shell/README.org][README]]
+[reverse-shell README](./reverse-shell/README.md)
 
-Used to set up nl-sys to allow for better interfacing with the routing tables of the host operating system
+Used to set up nl-sys to allow for better interfacing with the routing tables of the host operating system in order to gather all the information necessary to send out packets knowing only the destination IP address

examples/bind-shell/README.md

@@ -1,13 +1,13 @@
-#+TITLE: Example bind shell proof of concept
+# Example bind shell proof of concept
 
 This bind shell works through local host firewalls on Linux systems using UDP to receive messages, verify them against a public key, run the commands specified, and return the results and display it over the network.
 
-* Running the code
+## Running the code
 In a dev containers terminal, run:
 
-#+BEGIN_SRC shell
+```sh
 cargo make examples-bindshell-run
-#+END_SRC
+```
 
 This will build the code, generate the keys, create the environment, and run the service and the client in parallel.
-To verify the execution of the environment, try running ~iptables -nL~ and see that the firweall tries to block all packets.
+To verify the execution of the environment, try running `iptables -nL` and see that the firweall tries to block all packets.

examples/reverse-shell/README.md

@@ -0,0 +1,10 @@
+# Example reverse shell proof of concept
+
+This bind shell works through local host firewalls on Linux systems using UDP to send and receive messages
+
+## Running the code
+In a dev containers terminal, run:
+
+```sh
+cargo make examples-revshell-run
+```

examples/reverse-shell/README.org

@@ -1,13 +0,0 @@
-#+TITLE: Example reverse shell proof of concept
-
-This bind shell works through local host firewalls on Linux systems using UDP to send and receive messages
-
-* Setup
-** libpcap
-Follow the directions in the main README in order to pull in the libpcap dependency
-
-** Build the code
-Once the previous step is completed, run ~cargo build --release~ in a terminal.
-
-* Running the code
-First, open two shells. In one, run ~docker-compose up examples_reverseshell_target~, and in the other run ~docker-compose run examples_reverseshell_server~. It will be possible to type in commands to examples_bindshell_server and run them in the target container