Changes between Version 13 and Version 14 of UsersGuide/RunningInQEMU


Ignore:
Timestamp:
2016-04-19T16:28:08Z (9 years ago)
Author:
Jakub Jermář
Comment:

Update, mention building QEMU from scratch, KVM, QEMU versions

Legend:

Unmodified
Added
Removed
Modified

  • UsersGuide/RunningInQEMU

    v13 v14  
    22[[PageOutline]]
    33
    4 This page describes how to use [http://qemu.org QEMU] to run various HelenOS images you either [http://www.helenos.org/download downloaded] or [wiki:UsersGuide/CompilingFromSource built yourself].
     4This page describes how to use [http://qemu.org QEMU] to run various HelenOS images you either [wiki:Download downloaded] or [wiki:UsersGuide/CompilingFromSource built yourself].
    55
    6 The following text describes how to run the emulator manually. That is necessary if you download the image, but if you build the image by yourself, you may use our wrapper script instead. The script is started using following command:
     6The following text describes how to run the emulator manually. That is necessary if you download the image, but if you build the image by yourself, you may use our wrapper script instead. The script is started using the following command:
     7
    78{{{
    89./tools/ew.py
    910}}}
    10 It detects used configuration (e.g. whether you built for `ia32` or `mips`) and start the appropriate emulator (for some architectures, it would also set-up networking in the emulator). Please note that this ''does not work'' for [http://www.helenos.org/download downloaded images].
     11
     12It detects emulator options to use from the used HelenOS configuration (e.g. whether you built for `ia32` or `mips`) and starts the appropriate emulator. For some architectures, it also sets-up networking, sound, USB and disk options. See `./tools/ew.py -h` for more information. Please note that this ''does not work'' for the prebuilt [wiki:Download images].
    1113
    1214== Basics ==
    1315
     16We are assuming a sufficiently recent version of QEMU, such as 2.5.0 and newer. Older version may or may not work. You should be able to install a prepackaged version of QEMU from your distribution or you can build QEMU from scratch using a simple [browser:mainline/contrib/qemu/build-from-scratch.sh script] which comes with HelenOS sources:
     17
     18{{{
     19./contrib/qemu/build-from-scratch.sh
     20}}}
     21
    1422=== ia32 ===
    15 
    16 For QEMU 1.0.1 and newer:
    1723
    1824{{{
    1925qemu-system-i386 -cdrom image.iso
    20 }}}
    21 
    22 For QEMU 1.0.0 and older:
    23 
    24 {{{
    25 qemu -cdrom image.iso
    2626}}}
    2727
    … …  
    6565}}}
    6666
     67== KVM ==
     68
     69QEMU supports two modes of operation: binary translation and hardware virtualization. It uses [http://www.linux-kvm.org/page/Main_Page KVM] for the latter. If circumstances are right, it is possible to choose the second mode and benefit from better performance by appending the `-enable-kvm` option to the QEMU command line.
     70
     71In general, KVM can only be used, if the following criteria are met:
     72
     73  * KVM is supported by the host operating system, e.g. Linux
     74  * the host CPU supports hardware virtualization and this support is enabled in it
     75  * hardware virtualization is not already in use, i.e. there is no running instance of !VirtualBox or Xen
     76  * the guest and host CPUs are compatible (ia32 vs. amd64 is okay)
    6777
    6878== Serial ports ==
    … …  
    7282== Networking ==
    7383
    74 For general information about networking in HelenOS, please see UsersGuide/Networking
     84For general information about networking in HelenOS, please see [wiki:UsersGuide/Networking].
    7585
    7686To use networking, a network interface card must be presented to the guest system.
    … …  
    140150
    141151
    142 === Working with USB devices in the control console
     152=== Working with USB devices in the control console ===
    143153
    144154TODO