diff --git a/bochs/doc/docbook/user/user.dbk b/bochs/doc/docbook/user/user.dbk index 66ffb2b32..6cbc148c3 100644 --- a/bochs/doc/docbook/user/user.dbk +++ b/bochs/doc/docbook/user/user.dbk @@ -1,7 +1,7 @@ 386, 486, Pentium, or Pentium Pro. +can be configured to act like a 386, 486, Pentium, Pentium Pro, or +AMD64 CPU, including optional MMX, SSE, SSE2 and 3DNow! instructions. Bochs interprets every instruction from power-up to reboot, and has device models for all of the standard PC peripherals: keyboard, mouse, VGA card/monitor, disks, timer chips, network card, etc. Because Bochs simulates the whole PC environment, the software running in the simulation "believes" it is running on a real machine. This approach allows Bochs to run a wide variety of software with no modification, include most popular -x86 operating systems: Windows 95/98/NT, all Linux flavors, all BSD flavors, +x86 operating systems: Windows 95/98/NT/2000, all Linux flavors, all BSD flavors, and more. @@ -135,7 +136,7 @@ active project of the week at Source Forge. regular basis, but a few statistics give an indication. The bochs-developers mailing list, which is the primary source of news on bugs and releases, has over 400 subscribers. The -latest version has been downloaded over 50,000 times from SourceForge, not +latest version has been downloaded over 150,000 times from SourceForge, not counting any mirror website or CVS users. @@ -340,14 +341,19 @@ currently work with. 386,486,Pentium Emulation Yes - Bochs can be configured to emulate on of several families of Intel hardware. Some Pentium features are unsupported, such as the Time Stamp Counter. + Bochs can be configured to emulate one of several families of Intel hardware. Some Pentium features are unsupported, such as the Time Stamp Counter. Pentium Pro Emulation Incomplete - A few Pentium Pro features is incomplete, such as an on-chip APIC for SMP simulation. + A few Pentium Pro features are incomplete, such as an on-chip APIC for SMP simulation. + + AMD x86-64 Emulation + Incomplete + The AMD x86-64 support is about 90% complete and is still experimental. + Command Line Debugger Yes @@ -358,7 +364,7 @@ currently work with. Floating Point Yes - Uses software floating point engine based on SoftFloat floating point emulation library (http://www.jhauser.us/arithmetic/SoftFloat.html) + Uses software floating point engine based on SoftFloat floating point emulation library. @@ -426,7 +432,7 @@ currently work with. Mouse Yes - Emulates a PS/2 mouse with 3 buttons. + Emulates a serial, PS/2 or USB mouse with 3 buttons (mouse wheel). @@ -550,7 +556,7 @@ currently work with. - +
Supported Platforms @@ -2856,6 +2862,11 @@ at least one bootable media, either as disk image (floppy, hard disk or CD-ROM) + + +Both VGA BIOS versions as well as the ROM BIOS are part of Bochs. No separate download is necessary. + + In that case you have to pass the configuration options on the command line or to use the configuration interface to set up Bochs for the simulation. @@ -2973,16 +2984,21 @@ Put this on top of your config file if the global configuration is stored in /et The section below lists all the supported bochsrc options. -
megs +
megs Examples: megs: 32 megs: 128 -Set this to the default number of megabytes of memory you want to emulate. The -default is 32, since most operating systems won't need more than that. +Set the number of megabytes of physical memory you want to emulate. The default +is 32MB; most OS's won't need more than that. The maximum amount of memory +supported is 2048MB. + + +Due to limitations in the host OS, Bochs fails to allocated even 1024MB on most systems. +
romimage @@ -3147,7 +3163,8 @@ This defines the type and characteristics of all attached ata devices: -You have to tell the type of the attached device. For Bochs version2.0, it can by disk or cdrom + You have to tell the type of the attached device. For Bochs 2.0 or later, it can be + disk or cdrom . @@ -3236,8 +3253,13 @@ Default values are: -The biosdetect option has currently no effect on the bios + The biosdetect option has currently no effect on the BIOS. + + + Make sure the proper ata option is enabled when + using a device on that ata channel. +
boot @@ -4764,6 +4786,21 @@ file yet. &FIXME; Mouse behavior
+ +
+ Text-mode is broken in some ancient DOS program + + + If you are using a program written for DOS which seems to use the text-mode but + doesn't display the text properly, you can try the other VGA BIOS, either + VGABIOS-lgpl-latest or VGABIOS-elpin-2.40, + see the vgaromimage option. + + + + &NEEDHELP; Maybe it is a bug in the LGPL VGA BIOS, but for now, it seems to work. + +
@@ -6697,23 +6734,34 @@ the cursor back in the Bochs window and press delete. This should work for any key combination. -You can also define one user key combination +If you need one key combination frequently, set it up as user key combination in your configuration file. This key combination is sent to the guest OS when you press the user button in the headerbar.
-
Notes about VESA usage +
+ Notes about VESA usage - -Since Bochs version 1.4 it's possible to use VESA graphics. There are some limitations in the current implementation, -but in general it should work ok (we have run several test programs, the XFree86 VESA display driver, etc) - + + Since Bochs 1.4 it is possible to use VESA graphics. There are some limitations in + the current implementation, but in general it should work ok (we have run several test + programs, the XFree86 VESA display driver, etc.) + - -You will need to use the LGPL'd VGABIOS -in order for application to correctly detect VESA support. - + + In order to use VESA VBE, you need to compile Bochs using the + option and enable it in your bochsrc by setting the + vga option to vbe. + Finally, you need to use the + LGPL'd VGABIOS + as vgaromimage option for + applications to correctly detect VESA support. + + + + The VGABIOS is already included in the Bochs release, so no separate download is necessary. + Current limitations: @@ -7579,6 +7627,51 @@ Known problems
+
+ Knoppix + + + Contributed by Alexander Schuch. + + +
+ Getting Knoppix + + + Knoppix is a live CD (700M) based on Debian GNU/Linux, with lots of ready-to-run programs + (web browser, office suite, a few games, and more). It can be booted directly from CD, without + any installation needed. You can download it from + knoppix.org. + +
+ +
+ Preparing Bochs + + + As Knoppix runs completely from CD, you don't need to setup a hard disk. You just need to set up + the location of the downloaded ISO image in your bochsrc, and make Bochs boot + from it. Because Knoppix contains a graphical user interface, and has no other storage space but + the emulated RAM, it needs at least 128MB of it, see + megs option. Furthermore, you need to enable VBE support in + Bochs (see ). + +
+ +
+ Using Knoppix + + + There is nothing more to do! Just start Bochs and wait for Knoppix to load... + + + + You are logged in as normal user, if you want to become super user, just su. + There is no password needed (empty password). + +
+
+
Minix Please see the Minix on Bochs on Windows How-To by Al Woodhull. @@ -7680,7 +7773,7 @@ Please see the Minix - Now, while FreeBSD installs, it is a very good time to have a look at the + Now, while FreeBSD installs, it is a very good time to take a look at the FreeBSD documentation, especially the FreeBSD handbook and the FreeBSD FAQ.