aboutsummaryrefslogtreecommitdiffstats
path: root/docs/system/quickstart.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/system/quickstart.rst')
-rw-r--r--docs/system/quickstart.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/system/quickstart.rst b/docs/system/quickstart.rst
new file mode 100644
index 000000000..681678c86
--- /dev/null
+++ b/docs/system/quickstart.rst
@@ -0,0 +1,21 @@
+.. _pcsys_005fquickstart:
+
+Quick Start
+-----------
+
+Download and uncompress a PC hard disk image with Linux installed (e.g.
+``linux.img``) and type:
+
+.. parsed-literal::
+
+ |qemu_system| linux.img
+
+Linux should boot and give you a prompt.
+
+Users should be aware the above example elides a lot of the complexity
+of setting up a VM with x86_64 specific defaults and assumes the
+first non switch argument is a PC compatible disk image with a boot
+sector. For a non-x86 system where we emulate a broad range of machine
+types, the command lines are generally more explicit in defining the
+machine and boot behaviour. You will find more example command lines
+in the :ref:`system-targets-ref` section of the manual.