Bochs User Manual
<<< Previous |  | Next >>>

# Setup

# What does Bochs need?

These are the minimum requirements for running an OS inside of Bochs:

- the Bochs executable

- the BIOS image (usually called `BIOS-bochs-latest`)

- the VGA BIOS image (e.g. `VGABIOS-lgpl-latest` or `VGABIOS-elpin-2.40`)

- at least one bootable media, either as disk image (floppy, hard disk or CD-ROM) or physical disk (floppy or CD-ROM)

| Both VGA BIOS versions as well as the ROM BIOS are part of Bochs. No separate download is necessary.

| If you want to use the Cirrus SVGA adapter instead of VGA + Bochs VBE, you should have a look at the Section called Notes about Cirrus SVGA usage in the Chapter called Tips and Techniques.

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. Running Bochs is easier if you use a configuration file (we call it `bochsrc`). See the Section called bochsrc for all supported options.

The easiest way to setup Bochs for the first time is to use the example configuration file called `bochsrc-sample.txt`. Locate that file (location depends on the (host) OS and on the installation facility used) and copy it to a location where Bochs looks for that file, see the Section called Search order for the configuration file in the Chapter called Using Bochs.

The next step is to change the configuration so that it fits your needs: You most likely want to setup a hard disk (see the Section called Using the bximage tool in the Chapter called Tips and Techniques and the Section called ata0-master, ata0-slave, ata1-*, ata2-*, ata3-*), and install some OS on it using either a set of floppy disks (see the Section called floppya/floppyb) or a CD-ROM (see the Section called ata0-master, ata0-slave, ata1-*, ata2-*, ata3-* again) as installation media. Make sure you boot the emulation from the media you want, using the right setting as boot option.

If your keyboard output inside of Bochs is wrong, you may also need a keymap file to remap your keyboard layout to the U.S. layout. A set of keymap files for the X window system and SDL (Linux port) is distributed with Bochs. If your keyboard layout is not supported yet, you can create your own one by following the instructions given in the Section called How to write your own keymap table.

A collection of disk images of different operating systems can be found at http://bochs.sourceforge.net/diskimages.html. Some disk images are the size of a floppy disk (1 meg compressed) and others are gigantic (160 meg compressed). If you want to create a disk image yourself, please see the Section called How to make a simple disk image in the Chapter called Tips and Techniques.

This should be completed

      - (DONE )bochsrc, BIOS, VGABIOS, disk images.
      - BIOS/VGABIOS, what do they do?
      - disk images
        - (DONE) where to find one pre-made
        - grab one from a real hard disk

<<< Previous | Home | Next >>>
Compiling Bochs |  | bochsrc