Kevin Lawton
Bryce Denney
N. David Guarneri
Volker Ruppert
Christophe Bothamy
Edited by
Michael Calabrese
Stanislav Shwartsman
- Table of Contents
- 1. Introduction to Bochs
- 1.1. What is Bochs?
- 1.2. Who uses Bochs?
- 1.3. Is Bochs right for me?
- 1.4. Will it work for me?
- 1.5. Bochs License
- 1.6. Third Party Software Licensing and Temporary Files
- 1.7. Features
- 1.8. Supported Platforms
- 1.9. FAQ
- 2. Release Notes
- 3. Installation
- 3.1. Downloading Bochs
- 3.2. Tracking the source code with SVN
- 3.2.1. Checking out Bochs
- 3.2.2. Getting the Latest Version
- 3.2.3. Getting a Release Version
- 3.2.4. More about SVN
- 3.3. Installing a Binary
- 3.3.1. Windows
- 3.3.2. Linux RPM
- 3.3.3. MacOS X DMG
- 3.4. Compiling Bochs
- 3.4.1. Standard Compile
- 3.4.2. Configure Options
- 3.4.3. Transcript of Successful Compilation
- 3.4.4. Compiling on Win32 with Microsoft VC++
- 3.4.5. Compiling on Win32 with Cygwin
- 3.4.6. Compiling on MacOS 9 with CodeWarrior
- 3.4.7. Compiling on MacOS X
- 3.4.8. Compiling on Amiga/MorphOS
- 3.4.9. Compiling with the RFB interface
- 3.4.10. Compiling with the SDL interface
- 3.4.11. Compiling with the wxWidgets interface
- 3.4.12. Building an RPM on Linux
- 3.4.13. Compile Problems
- 4. Setup
- 4.1. What does Bochs need?
- 4.2. bochsrc
- 4.2.1. plugin_ctrl
- 4.2.2. megs
- 4.2.3. cpu
- 4.2.4. cpuid
- 4.2.5. romimage
- 4.2.6. optromimage1, optromimage2, optromimage3 or optromimage4
- 4.2.7. vgaromimage
- 4.2.8. vga
- 4.2.9. floppya/floppyb
- 4.2.10. ata0, ata1, ata2, ata3
- 4.2.11. ata0-master, ata0-slave, ata1-*, ata2-*, ata3-*
- 4.2.12. boot
- 4.2.13. floppy_bootsig_check
- 4.2.14. config_interface
- 4.2.15. display_library
- 4.2.16. log
- 4.2.17. logprefix
- 4.2.18. debug/info/error/panic
- 4.2.19. debugger_log
- 4.2.20. com[1-4]
- 4.2.21. parport[1-2]
- 4.2.22. sb16
- 4.2.23. es1370
- 4.2.24. keyboard
- 4.2.25. clock
- 4.2.26. mouse
- 4.2.27. private_colormap
- 4.2.28. pci
- 4.2.29. pcidev
- 4.2.30. usb_uhci
- 4.2.31. usb_ohci
- 4.2.32. usb_xhci
- 4.2.33. gdbstub
- 4.2.34. ne2k
- 4.2.35. pcipnic
- 4.2.36. e1000
- 4.2.37. user_shortcut
- 4.2.38. cmosimage
- 4.2.39. user_plugin
- 4.2.40. magic_break
- 4.2.41. port_e9_hack
- 4.2.42. debug_symbols
- 4.3. Sound Blaster 16 Emulation
- 4.3.1. How well does it work?
- 4.3.2. Output to a sound card
- 4.3.3. Installation on Linux
- 4.3.4. Features planned for the future
- 4.3.5. Description of the sound output classes
- 4.4. How to write your own keymap table
- 5. Using Bochs
- 5.1. Command line arguments
- 5.2. Search order for the configuration file
- 5.3. The configuration interface 'textconfig'
- 5.3.1. The start menu
- 5.3.2. The Bochs headerbar
- 5.3.3. The runtime configuration
- 5.4. Save and restore simulation
- 6. Common problems and what to do about them (Troubleshooting)
- 6.1. Bochs panics! What can I do?
- 6.2. Mouse behavior, enabling and disabling
- 6.3. Text-mode is broken in some ancient DOS program
- 7. Mailing Lists
- 7.1. bochs-developers mailing list
- 7.2. bochs-announce mailing list
- 7.3. bochs-cvs mailing list
- 7.4. Mailing List Etiquette
- 8. Tips and Techniques
- 8.1. Specify log options by device
- 8.2. How to make a simple disk image
- 8.2.1. Create a flat image
- 8.2.2. Partition and format your image file
- 8.3. Use mtools to manipulate disk images
- 8.4. Bochs GNU/Linux DiskTools
- 8.5. Win32 only: Tools to manipulate disk images
- 8.5.1. Winimage
- 8.5.2. DiskExplorer
- 8.5.3. Ben Lunt's MTOOLs for Bochs and Win32 and/or DOS
- 8.6. X Windows: Color allocation problems
- 8.7. Screen saver turns on too quickly
- 8.8. Mounting a disk image using the loop device
- 8.8.1. ...on Linux
- 8.8.2. ...on FreeBSD
- 8.9. Simulating a Symmetric Multiprocessor (SMP) Machine
- 8.10. Setting Up Networking in DLX Linux
- 8.11. Configuring and using a tuntap network interface
- 8.11.1. Tuntap description
- 8.11.2. Set up the linux Kernel
- 8.11.3. Configure Bochs to use the tuntap interface
- 8.11.4. Set up the private network between the host and the guest
- 8.11.5. Set up the host to masquerade the guest network accesses
- 8.12. Using Bochs internal debugger
- 8.12.1. Execution Control
- 8.12.2. BreakPoints
- 8.12.3. Memory WatchPoints
- 8.12.4. Manipulating Memory
- 8.12.5. Info commands
- 8.12.6. Manipulating CPU Registers
- 8.12.7. Disassembly commands
- 8.12.8. Instruction tracing
- 8.12.9. Instrumentation
- 8.12.10. Instrumentation commands
- 8.12.11. Other Commands
- 8.12.12. Related links
- 8.13. Using Bochs and the remote GDB stub
- 8.13.1. Configuring Bochs
- 8.13.2. Running Bochs
- 8.13.3. Running GDB
- 8.14. Using the serial port
- 8.14.1. Logging serial port output to a file
- 8.14.2. Interactivity : connecting to a virtual terminal
- 8.14.3. Interactivity : connecting to a pseudo terminal
- 8.15. BIOS Tips
- 8.15.1. Booting from CD-ROMs
- 8.15.2. Disk translation
- 8.16. How to enter special key combination
- 8.17. Notes about VESA usage
- 8.17.1. Instructions to setup Bochs VBE in Windows Guest OS
- 8.18. Notes about Cirrus SVGA usage
- 8.19. Disk Image Modes
- 8.19.1. flat
- 8.19.2. concat
- 8.19.3. external/dll
- 8.19.4. sparse
- 8.19.5. vmware3/vmware4
- 8.19.6. undoable
- 8.19.7. growing
- 8.19.8. volatile
- 8.19.9. vpc
- 8.19.10. vvfat
- 8.20. Using the bximage tool
- 8.21. Using the bxcommit tool
- 9. Guest operating systems
- 9.1. Knoppix
- 9.1.1. Getting Knoppix
- 9.1.2. Preparing Bochs
- 9.1.3. Using Knoppix
- 9.2. FreeBSD 5.2.1
- 9.2.1. Getting FreeBSD
- 9.2.2. Preparing Bochs
- 9.2.3. Installing FreeBSD
- 9.2.4. Post-installation configuration
- 9.2.5. Using FreeBSD
- 9.3. DOS
- 9.3.1. Accessing your CDROM
- 9.3.2. SB16 driver for DOS
- 9.3.3. Bootdisks of early DOS versions
- 9.4. Windows NT 4.0
- 9.5. Windows 2000 / Windows 2000 Server
- 9.6. Windows XP
- 9.7. Windows 7
- 9.8. SCO OpenServer 5.0.5