docs/system/quickstart.rst

   1 .. _pcsys_005fquickstart:
   2
   3 Quick Start
   4 -----------
   5
   6 Download and uncompress a PC hard disk image with Linux installed (e.g.
   7 ``linux.img``) and type:
   8
   9 .. parsed-literal::
  10
  11    |qemu_system| linux.img
  12
  13 Linux should boot and give you a prompt.
  14
  15 Users should be aware the above example elides a lot of the complexity
  16 of setting up a VM with x86_64 specific defaults and assumes the
  17 first non switch argument is a PC compatible disk image with a boot
  18 sector. For a non-x86 system where we emulate a broad range of machine
  19 types, the command lines are generally more explicit in defining the
  20 machine and boot behaviour. You will find more example command lines
  21 in the :ref:`system-targets-ref` section of the manual.