Bochs User Manual

Kevin Lawton

Bryce Denney

N. David Guarneri

Volker Ruppert

Christophe Bothamy

Edited by

Michael Calabrese

Table of Contents

1. Introduction to Bochs

What is Bochs?
Who uses Bochs?
Is Bochs right for me?
Will it work for me?
Bochs License
Third Party Software Licensing and Temporary Files
Features
Supported Platforms
FAQ

2. Release Notes

3. Installation

Downloading Bochs

Tracking the source code with CVS

Checking out Bochs
Getting the Latest Version
Getting a Release Version
More about CVS

Installing a Binary

Windows
Linux RPM
MacOS X DMG

Compiling Bochs

Standard Compile
Configure Options
Transcript of Successful Compilation
Compiling on Win32 with Microsoft VC++
Compiling on Win32 with Cygwin
Compiling on MacOS 9 with CodeWarrior
Compiling on MacOS X
Compiling on BeOS
Compiling on Amiga/MorphOS
Compiling with the RFB interface
Compiling with the SDL interface
Building an RPM on Linux
Compile Problems

Installing the VGA font (X windows only)

Option 1: Installing VGA font in global font directory
Option 2: Installing VGA font in local font directory

What does Bochs need?

Sound Blaster 16 Emulation

Configuring From Source
How well does it work?
Output to a sound card
Installation on Linux
Configuring bochs
Runtime configuration
Features planned for the future
Description of the sound output classes

How to write your own keymap table

5. Using Bochs

Command line arguments

Search order for the configuration file

The configuration interface 'textconfig'

The start menu
The Bochs headerbar
The runtime configuration

6. Common problems and what to do about them (Troubleshooting)

7. Mailing Lists

bochs-developers mailing list
bochs-announce mailing list
bochs-cvs mailing list
Mailing List Etiquette

8. Tips and Techniques

How to make a simple disk image

Create a flat image
Partition and format your image file.

Use mtools to manipulate disk images

Bochs GNU/Linux DiskTools

Win32 only: Tools to manipulate disk images

Winimage
DiskExplorer

X Windows: Color allocation problems

Screen saver turns on too quickly

Linux: Mounting a disk image using the loop device

Simulating a Symmetric Multiprocessor (SMP) Machine

Setting Up Networking in DLX Linux

Configuring and using a tuntap network interface

Tuntap description
Set up the linux Kernel [1]
Configure Bochs to use the tuntap interface
Set up the private network between the host and the guest
Set up the host to masquerade the guest network accesses

Using Bochs internal debugger

Execution Control
BreakPoints
Manipulating Memory
Info commands
Manipulating CPU Registers
Disassembly commands
Instrumentation
Instrumentation commands
New Commands
Related links

Using Bochs and the remote GDB stub

Configurating Bochs
Running Bochs
Running GDB

Using the serial port

Logging serial port output to a file
Interactivity : connecting to a virtual terminal
Interactivity : connecting to a pseudo terminal

Booting from cdroms
Disk translation

How to enter special key combination

Notes about VESA usage

Disk Image Modes

flat
concat
external/dll
sparse
vmware3
undoable
growing
volatile

Using the bximage tool

Using the bxcommit tool

9. Guest operating systems

FreeDOS Beta 8

GNU (Also known as GNU/Hurd)

Installing GNU

Accessing your CDROM

How to Install Windows 95 with floppies
Installing a Japanese version of Windows 95
VLB-IDE support

Windows NT 4.0

Windows 98 Method 1: mcopy Windows 98 into Hard Disk Image (Linux Host)
Locating Your Partitions
Cleaning Up Your MS Windows Partition
Mounting Your Windows Partition
Choosing the Size of Your Disk Image
Setting Up the Disk Image
Create the .bochsrc Configuration File
Make Hard Disk Image Acessible by Mtools
Format Partition and Copy Files
The Fun Begins
Windows 98 Method 2: Classic Install (Linux Host)
Saving Your Windows 98 CD as a Disk Image
Making the Windows 98 Hard Disk Image
Create the .bochsrc Configuration File
Create the Primary DOS Partition and set it Active
Formatting the Disk Image
Starting the Installation

Installing Windows ME

Windows 2000

Windows 2000 Server

SCO OpenServer 5.0.5

List of Tables
1-1. Bochs Features
1-2. Supported platforms
3-1. Status letters in a CVS update
3-2. CVS Release Tags
3-3. Files in Bochs directory (Windows version)
3-4. Files in RPM package
3-5. Defaults by Platform
3-6. Configure Options to Select the Display Library (optional)
3-7. Configure Options
4-1. ata devices configuration options
4-2. display_library values
4-3. Example IPS Settings
4-4. BX_KEY constants
5-1. command line arguments
8-1. CD Boot error codes
8-2. Disk translation algorithms
8-3. Supported Disk Modes

List of Figures
3-1. Checking out Bochs in CVS
3-2. Installing an RPM in Linux
3-3. Screenshot of Bochs running DLX Linux

		Next
		Introduction to Bochs