Commit 6f2f2b2489c89f37ac6db64bc15eefc7c30a9637
1 parent
1d6e34fd
removed all references to KQEMU to comply with the Savannah rules
git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@1302 c046a42c-6fe2-441c-8c8c-71466251a162
Showing
1 changed file
with
1 additions
and
97 deletions
qemu-doc.texi
| @@ -35,11 +35,7 @@ to ease cross-compilation and cross-debugging. | @@ -35,11 +35,7 @@ to ease cross-compilation and cross-debugging. | ||
| 35 | @end itemize | 35 | @end itemize |
| 36 | 36 | ||
| 37 | QEMU can run without an host kernel driver and yet gives acceptable | 37 | QEMU can run without an host kernel driver and yet gives acceptable |
| 38 | -performance. On an x86 host, if you want the highest performance for | ||
| 39 | -the x86 target, the @emph{QEMU Accelerator Module} (KQEMU) allows QEMU | ||
| 40 | -to reach near native performances. KQEMU is currently only supported | ||
| 41 | -for an x86 Linux 2.4 or 2.6 host system, but more host OSes will be | ||
| 42 | -supported in the future. | 38 | +performance. |
| 43 | 39 | ||
| 44 | For system emulation, the following hardware targets are supported: | 40 | For system emulation, the following hardware targets are supported: |
| 45 | @itemize | 41 | @itemize |
| @@ -343,11 +339,6 @@ translation mode (@var{t}=none, lba or auto). Usually QEMU can guess | @@ -343,11 +339,6 @@ translation mode (@var{t}=none, lba or auto). Usually QEMU can guess | ||
| 343 | all thoses parameters. This option is useful for old MS-DOS disk | 339 | all thoses parameters. This option is useful for old MS-DOS disk |
| 344 | images. | 340 | images. |
| 345 | 341 | ||
| 346 | -@item -no-kqemu | ||
| 347 | -Disable the usage of the QEMU Accelerator module (KQEMU). QEMU will work as | ||
| 348 | -usual but will be slower. This option can be useful to determine if | ||
| 349 | -emulation problems are coming from KQEMU. | ||
| 350 | - | ||
| 351 | @item -isa | 342 | @item -isa |
| 352 | Simulate an ISA-only system (default is PCI system). | 343 | Simulate an ISA-only system (default is PCI system). |
| 353 | @item -std-vga | 344 | @item -std-vga |
| @@ -423,30 +414,6 @@ Fabrice Bellard | @@ -423,30 +414,6 @@ Fabrice Bellard | ||
| 423 | 414 | ||
| 424 | @end ignore | 415 | @end ignore |
| 425 | 416 | ||
| 426 | -@section QEMU Accelerator Module | ||
| 427 | - | ||
| 428 | -The QEMU Accelerator Module (KQEMU) is an optional part of QEMU currently only | ||
| 429 | -available for Linux 2.4 or 2.6 x86 hosts. It enables QEMU to run x86 | ||
| 430 | -code much faster. Provided it is installed on your PC (see | ||
| 431 | -@ref{kqemu_install}), QEMU will automatically use it. | ||
| 432 | - | ||
| 433 | -WARNING: as with any alpha stage kernel driver, KQEMU may cause | ||
| 434 | -arbitrary data loss on your PC, so you'd better backup your sensitive | ||
| 435 | -data before using it. | ||
| 436 | - | ||
| 437 | -When using KQEMU, QEMU will create a big hidden file containing the | ||
| 438 | -RAM of the virtual machine. For best performance, it is important that | ||
| 439 | -this file is kept in RAM and not on the hard disk. QEMU uses the | ||
| 440 | -@file{/dev/shm} directory to create this file because @code{tmpfs} is | ||
| 441 | -usually mounted on it (check with the shell command | ||
| 442 | -@code{df}). Otherwise @file{/tmp} is used as fallback. You can use the | ||
| 443 | -@var{QEMU_TMPDIR} shell variable to set a new directory for the QEMU | ||
| 444 | -RAM file. | ||
| 445 | - | ||
| 446 | -KQEMU has only been tested with Linux 2.4, Linux 2.6 and Windows 2000 | ||
| 447 | -as guest OSes. If your guest OS do not work with KQEMU, you can | ||
| 448 | -dynamically disable KQEMU with the @option{-no-kqemu} option. | ||
| 449 | - | ||
| 450 | @section QEMU Monitor | 417 | @section QEMU Monitor |
| 451 | 418 | ||
| 452 | The QEMU monitor is used to give complex commands to the QEMU | 419 | The QEMU monitor is used to give complex commands to the QEMU |
| @@ -1165,12 +1132,6 @@ tar zxvf qemu-x.y.z.tar.gz | @@ -1165,12 +1132,6 @@ tar zxvf qemu-x.y.z.tar.gz | ||
| 1165 | cd qemu-x.y.z | 1132 | cd qemu-x.y.z |
| 1166 | @end example | 1133 | @end example |
| 1167 | 1134 | ||
| 1168 | -If you want to use the optional QEMU Accelerator Module, then download | ||
| 1169 | -it and install it in qemu-x.y.z/: | ||
| 1170 | -@example | ||
| 1171 | -tar zxvf /tmp/kqemu-x.y.z.tar.gz | ||
| 1172 | -@end example | ||
| 1173 | - | ||
| 1174 | Then you configure QEMU and build it (usually no options are needed): | 1135 | Then you configure QEMU and build it (usually no options are needed): |
| 1175 | @example | 1136 | @example |
| 1176 | ./configure | 1137 | ./configure |
| @@ -1183,63 +1144,6 @@ make install | @@ -1183,63 +1144,6 @@ make install | ||
| 1183 | @end example | 1144 | @end example |
| 1184 | to install QEMU in @file{/usr/local}. | 1145 | to install QEMU in @file{/usr/local}. |
| 1185 | 1146 | ||
| 1186 | -@node kqemu_install | ||
| 1187 | -@subsection QEMU Accelerator Installation | ||
| 1188 | - | ||
| 1189 | -If you use x86 Linux, the compilation of the QEMU Accelerator Kernel | ||
| 1190 | -Module (KQEMU) is automatically activated provided you have the | ||
| 1191 | -necessary kernel headers. If nonetheless the compilation fails, you | ||
| 1192 | -can disable its compilation with the @option{--disable-kqemu} option. | ||
| 1193 | - | ||
| 1194 | -If you are using a 2.6 host kernel, then all the necessary kernel | ||
| 1195 | -headers should be already installed. If you are using a 2.4 kernel, | ||
| 1196 | -then you should verify that properly configured kernel sources are | ||
| 1197 | -installed and compiled. On a Redhat 9 distribution for example, the | ||
| 1198 | -following must be done: | ||
| 1199 | -@example | ||
| 1200 | -1) Install the kernel-source-xxx package | ||
| 1201 | -2) cd /usr/src/linux-xxx | ||
| 1202 | -3) make distclean | ||
| 1203 | -4) Copy /boot/config-vvv in .config (use uname -r to know your configuration name 'vvv') | ||
| 1204 | -5) Edit the Makefile to change the EXTRAVERSION line to match your | ||
| 1205 | - current configuration name: | ||
| 1206 | - EXTRAVERSION = -custom | ||
| 1207 | -to | ||
| 1208 | - EXTRAVERSION = -8 # This is an example, it can be -8smp too | ||
| 1209 | -5) make menuconfig # Just save the configuration | ||
| 1210 | -6) make dep bzImage | ||
| 1211 | -@end example | ||
| 1212 | - | ||
| 1213 | -The installation of KQEMU is not fully automatic because it is highly | ||
| 1214 | -distribution dependent. When launching | ||
| 1215 | -@example | ||
| 1216 | -make install | ||
| 1217 | -@end example | ||
| 1218 | - | ||
| 1219 | -KQEMU is installed in /lib/modules/@var{kernel_version}/misc. The | ||
| 1220 | -device @file{/dev/kqemu} is created with read/write access rights for | ||
| 1221 | -everyone. If you fear security issues, you can restrict the access | ||
| 1222 | -rights of @file{/dev/kqemu}. | ||
| 1223 | - | ||
| 1224 | -If you want that KQEMU is installed automatically at boot time, you can add | ||
| 1225 | - | ||
| 1226 | -@example | ||
| 1227 | -# Load the KQEMU kernel module | ||
| 1228 | -/sbin/modprobe kqemu | ||
| 1229 | -@end example | ||
| 1230 | - | ||
| 1231 | -in @file{/etc/rc.d/rc.local}. | ||
| 1232 | - | ||
| 1233 | -If your distribution uses udev (like Fedora), the @file{/dev/kqemu} is | ||
| 1234 | -not created automatically (yet) at every reboot. You can add the | ||
| 1235 | -following in @file{/etc/rc.d/rc.local}: | ||
| 1236 | - | ||
| 1237 | -@example | ||
| 1238 | -# Create the KQEMU device | ||
| 1239 | -mknod /dev/kqemu c 250 0 | ||
| 1240 | -chmod 666 /dev/kqemu | ||
| 1241 | -@end example | ||
| 1242 | - | ||
| 1243 | @subsection Tested tool versions | 1147 | @subsection Tested tool versions |
| 1244 | 1148 | ||
| 1245 | In order to compile QEMU succesfully, it is very important that you | 1149 | In order to compile QEMU succesfully, it is very important that you |