Change to the main Bochs distribution directory (../ in this case)

  cd bochs-YYMMDD/

Set the CFLAGS environment variable to some sensible, with plenty
of optimization characteristics turned on:

  # Ex: (for CSH on Linux x86)
  setenv CFLAGS "-Wall -O3 -m486 -fomit-frame-pointer -pipe"
    -or
  # to use position independent code for shared libaries:
  setenv CFLAGS "-fpic -Wall -O3 -m486 -fomit-frame-pointer -pipe"

Run the configuration script.  Read through the

  ./configure --enable-80386 --enable-external-cpu-memory --enable-vga

Compile Bochs into two archives (libbochs.a & iodev/libiodev.a).

  # One 'make' will now create both libs.
  make

Change back to this directory.

  cd bochs-YYMMDD/external

Compile the sample test program.

  make

You need a ".bochsrc" file.  You can either keep one global one in
your home directory, or keep a local one.  A sample one comes in this
directory.  You may want to refer to the sample one in the main
Bochs distribution also. (up one directory)

Edit the ".bocshrc" file.  Comments in the sample file explain the
use of supported directives.  The bochs-YYMMDD/INSTALL program outlines
how to create hard disk image files, floppy images and such.

Run the sample test program.

  main

Read through the output and see if it makes sense.  A "bochs.out" file
will be generated (unless you opt send output to a different file).
An "all tests passed" message should show up in your terminal window,
along with some test dialog, and the Bochs window should pop up
with only one line on the top.  You should type <Enter> in your terminal
window when asked to do so.  This will end the test.

Also, look at "bochs-YYMMDD/external_environment.h".  It describes the
interface between the external simulation environment and Bochs.


If you'd like to compile Bochs as a standalone:

  # For example,
  
  cd bochs-YYMMDD
  make dist-clean     # if you have configure'd before.
  # look in .conf.win95 script file for commands
