Changes between Version 18 and Version 19 of UsersGuide/RunningInQEMU


Ignore:
Timestamp:
2016-04-20T19:06:37Z (8 years ago)
Author:
Jakub Jermář
Comment:

Fix command line option to correspond to the current HelenOS and QEMU, wording.

Legend:

Unmodified
Added
Removed
Modified

  • UsersGuide/RunningInQEMU

    v18 v19  
    44This 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 the following command:
     6Here you will learn how to start the emulator manually, which is necessary if you download the image. But if you build the image by yourself, you may use our emulator wrapper script instead. The script is started using the following command:
    77
    88{{{
    … …  
    2929  * the guest and host CPUs are compatible (ia32 vs. amd64 is okay)
    3030
    31 == Basics ==
     31== Basic usage ==
    3232
    33 The following subsections show the minimum QEMU command lines needed to run HelenOS on the respective QEMU machine. When spawned like this, the simulated QEMU machine may be missing some simulated hardware which in turn limits what you can do with the system. The next sections will show you how to configure additional hardware.
     33The following subsections show the minimum QEMU command lines needed to run HelenOS on the respective QEMU machine. When spawned like this, the simulated QEMU machine may be missing some hardware which limits what hardware HelenOS can detect on it and in turn what you can do with it. The later sections will show you how to configure additional hardware.
    3434
    3535=== amd64 ===
     36
     37QEMU can emulate a generic PC equipped with a 64-bit processor. For an `image.iso` built for the '''amd64''' or '''ia32''' profile, simply run:
    3638
    3739{{{
    … …  
    4143=== arm32 ===
    4244
    43 QEMU can emulate [http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0159b/Cegeadbj.html ARM Integrator/CP]. For an `image.boot` built for '''arm32/integratorcp''' profile, do:
     45QEMU can emulate [http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0159b/Cegeadbj.html ARM Integrator/CP]. For an `image.boot` built for the '''arm32/integratorcp''' profile, do:
    4446
    4547{{{
    46 qemu-system-arm -kernel image.boot
     48qemu-system-arm -M integratorcp -kernel image.boot
    4749}}}
    4850
    4951=== ia32 ===
     52
     53QEMU can emulate a generic PC. For an `image.iso` built for the '''ia32''' profile, just run:
    5054
    5155{{{
    … …  
    7276=== ppc32 ===
    7377
     78QEMU can emulate [https://support.apple.com/kb/SP130 Power Macintosh G3]. For an `image.iso` built for the '''ppc32''' profile, do:
     79
    7480{{{
    75 qemu-system-ppc -cdrom image.iso -boot d
     81qemu-system-ppc -cdrom image.iso -boot d -m 256
    7682}}}
    7783
    7884=== sparc64 ===
    7985
    80 QEMU can emulate a custom sun4u [http://qemu.weilnetz.de/qemu-doc.html#Sparc64-System-emulator machine]. For an `image.iso` built for the '''sparc64/ultra''' profile, do:
     86QEMU can emulate a custom sun4u [http://qemu.weilnetz.de/qemu-doc.html#Sparc64-System-emulator machine] and HelenOS partially supports it. For an `image.iso` built for the '''sparc64/ultra''' profile, do:
    8187
    8288{{{
    8389qemu-system-sparc64 -cdrom image.iso -boot d
    8490}}}
     91
     92Note that the system will boot into a GUI, but it will not be possible to control it using mouse or keyboard.
    8593
    8694== Serial ports ==
    … …  
    95103
    96104To add a virtual network card, add one of the following command-line options:
     105
    97106||= Device        =||= Option =||
    98107|| Intel PRO/1000  || `-device e1000,vlan=0` ||
    … …  
    110119-redir udp:8080::8080 -redir tcp:8181::8181
    111120}}}
    112 
    113 A script to run QEMU this way is present in source:mainline/contrib/conf/net-qe.sh
    114121
    115122=== Bridging virtual network device with host's network interface ===
    … …  
    140147QEMU will grab the device from your OS and you will no longer be able to use it in the host system (rather do not try it). When QEMU terminates, it releases the control. Depending on your OS and QEMU version you are using, it might be needed to physically reattach the device, before the host OS can work with it again.
    141148
    142 
    143149=== Emulated devices ===
    144150