summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBrandon <brandonjordan124@gmail.com>2022-01-01 13:35:16 -0500
committerLinus Groh <mail@linusgroh.de>2022-01-10 10:31:54 +0100
commitf43b69f8e29c5691a064027f3f6cadb314c29b24 (patch)
tree069b2238b43afaaa5c94c0268ebffbe1be2bcc0b
parent79cdb5e3c80a2f94b4a49bec3fcbe46c0ec56dc8 (diff)
downloadserenity-f43b69f8e29c5691a064027f3f6cadb314c29b24.zip
Documentation: Document how to transfer files from QEMU to the host
Document how to transfer files from QEMU to the host
-rw-r--r--Documentation/TransferringFiles.md26
-rw-r--r--Documentation/WebServer_localhost.pngbin0 -> 285333 bytes
2 files changed, 26 insertions, 0 deletions
diff --git a/Documentation/TransferringFiles.md b/Documentation/TransferringFiles.md
new file mode 100644
index 0000000000..99a755f9ea
--- /dev/null
+++ b/Documentation/TransferringFiles.md
@@ -0,0 +1,26 @@
+# Transferring files from QEMU to your host machine
+
+## Method 1: WebServer
+Serenity has a built-in web server which extends to your host machine.
+
+Open a new terminal and use the following command to start a WebServer instance for the current working directory:
+
+```console
+ws .
+```
+
+Then we just open `localhost:8000` on our host machine :^)
+
+![](WebServer_localhost.png)
+
+**NOTE:** Due to the fact that same browsers download unrecognized files as plain text, you may want to use something like `wget` to download the file **as is** instead. Otherwise the file may appear corrupted when the system tries to load it.
+
+## Method 2: Mount disk_image
+
+Another way is to mount Serenity's disk_image to your host machine by using the following command on *nix systems:
+
+```console
+cd "Build/${SERENITY_ARCH}"
+mkdir mnt
+sudo mount -t ext2 _disk_image mnt
+```
diff --git a/Documentation/WebServer_localhost.png b/Documentation/WebServer_localhost.png
new file mode 100644
index 0000000000..a7541da00f
--- /dev/null
+++ b/Documentation/WebServer_localhost.png
Binary files differ