Merge remote-tracking branch 'origin/github/pr/45'
[grml.org.git] / qemu / index.html.tt2
1 <!DOCTYPE html>
2 <html>
3 <head>
4 <title>grml.org - QEMU</title>
5 <meta name="Title" content="grml.org - QEMU" />
6 <meta name="Author" content="the grml team [www.grml.org/team/]" />
7 <meta name="Keywords" content="grml.org, grml" />
8 <meta name="Description" content="QEMU of grml.org" />
9 <meta name="Abstract" content="grml, just another linux-distribution" />
10 <meta name="Robots" content="index,follow" />
11 <meta name="Language" content="english" />
12 <meta name="identifier-url" content="https://grml.org/" />
13 <meta name="MSSmartTagsPreventParsing" content="true" />
14 <meta http-equiv="imagetoolbar" content="no" />
15 <link rel="home" href="/" title="grml.org" />
16 <link rel="help" href="/features/" title="About" />
17 <link rel="author" href="/team/" title="Team" />
18 <link rel="icon" href="/favicon.png" type="image/png" />
19 <link rel="stylesheet" href="/style.css" type="text/css" />
20 </head>
21
22 <body>
23 [% INCLUDE static.inc %]
24
25       <div class="content">
26
27         <p><img style="float: right" src="/img/clanbomber.png" alt="*" /></p>
28
29         <h1>QEMU</h1>
30
31         <p><a href="http://fabrice.bellard.free.fr/qemu/">QEMU</a> is an emulator for
32         various CPUs. It works on Linux, Windows, FreeBSD and Mac OS X. It's possible
33         to run grml with QEMU. Notice that it's much slower than running it native
34         due to the emulation mode.</p>
35
36         <h2>Using QEMU with acceleration</h2>
37
38         <p>grml &gt;=0.5 provides the <a
39         href="http://fabrice.bellard.free.fr/qemu/">accelerator
40         module</a> for QEMU namend 'kqemu'. Just run the following
41         commands to use it:</p>
42
43 <pre class="rahmen">
44 apt-get update ; apt-get install qemu # install qemu
45 modprobe kqemu                        # load the kernel module
46 mknod /dev/kqemu c 250 0              # create the device
47 chmod 666 /dev/kqemu /dev/net/tun     # adjust permissions</pre>
48
49         <p>To see if kqemu is enabled and working correctly, use the QEMU monitor
50         command (press ctrl-alt-2): 'info kqemu'</p>
51
52         <h2>Problems with Qemu</h2>
53
54         <h3>Black / blank screen</h3>
55
56         <p>You get a black/blank screen when booting grml in qemu? Try booting with &quot;grml vga=normal&quot;.</p>
57
58         <h2>Running QEMU with grml on Linux</h2>
59
60         <p>Install qemu (apt-get install qemu) and start it e.g. via:</p>
61
62 <pre class="rahmen">
63 qemu -m 256 -cdrom /dev/hdc          # if running from CD-ROM
64 qemu -m 256 -cdrom /path/to/grml.iso # if running from harddisk
65 </pre>
66
67         <h2>Running QEMU with grml on Windows</h2>
68
69         <p><a href="qemu-1.png"><img style="border: 0" src="qemu-1.jpg"
70         alt="screenshot 1" /></a> </p>
71
72         <p>First of all download <a href="http://www.h7.dion.ne.jp/~qemu-win/">QEMU
73         for Windows</a>. <a href="/download/">Download
74         the grml-iso</a> and put the QEMU files in the same directory as the
75         grml-iso.</p>
76
77         <p>Now create a startup file, call it for example <a
78         href="grml-qemu.bat">grml-qemu.bat</a>:</p>
79
80 <pre class="rahmen">
81 REM Start qemu on windows.
82 @ECHO OFF
83 START qemu.exe -L . -m 256 -hdc harddisk -cdrom grml_0.6.iso
84 CLS
85 EXIT</pre>
86
87       <p>Adjust the values if necessary and now run the grml-qemu.bat-file. Have fun
88       :-)</p>
89
90       <p><a href="/screenshots/qemu.jpg"><img style="border: 0" src="/screenshots/qemu_small.jpg" alt="screenshot 3" /></a></p>
91
92       </div>
93
94 [% INCLUDE static_bottom.inc %]