Bochs/bochs
Bryce Denney cdb5f1de68 - port of macintosh code to Carbon API for MacOS X, contributed by
Emmanuel Maillard <e.rsz@libertysurf.fr>
2001-09-26 00:32:34 +00:00
..
bios - apply patch from patches/patch.lba. This is taken from plex86 cvs 2001-09-19 15:30:44 +00:00
build - workspace files for VC++ 6, contributed by Stephan van Eeden 2001-09-24 03:42:15 +00:00
cpu - apply patch [ #455014 ] CR0 bug in 80486, described as: 2001-09-19 17:36:54 +00:00
debug - change "long long" to Bit64u, several times 2001-09-24 00:42:00 +00:00
disasm - apply VPATH patch from Edouard G. Parmelan, posted to list on September 1 2001-09-14 04:19:08 +00:00
doc Added listing of Debian packages. 2001-09-25 22:36:51 +00:00
docs-html - fix incorrect title 2001-09-17 15:12:55 +00:00
dynamic - apply VPATH patch from Edouard G. Parmelan, posted to list on September 1 2001-09-14 04:19:08 +00:00
font - update copyright dates to 2001 for all mandrake headers 2001-04-10 02:20:02 +00:00
fpu - added debugger command "info fpu" which prints all FPU registers 2001-09-15 06:55:14 +00:00
gui - port of macintosh code to Carbon API for MacOS X, contributed by 2001-09-26 00:32:34 +00:00
instrument - apply VPATH patch from Edouard G. Parmelan, posted to list on September 1 2001-09-14 04:19:08 +00:00
iodev - use #if BX_WITH_MACOS around the special fd_read and fd_write code, since 2001-09-26 00:19:44 +00:00
memory Added support for I/O Interface to the debugger and the memory range monitoring 2001-09-14 23:02:56 +00:00
misc - I guess strcasecmp is specific to glib or something, it didn't work in 2001-06-01 05:45:55 +00:00
patches - freshen the patch so that it applies cleanly 2001-09-19 15:29:07 +00:00
.bochsrc - add string parameter called screenmode 2001-08-16 02:00:31 +00:00
.conf.AIX.4.3.1 Added a config file for AIX 4.3.1. 2001-04-11 09:07:55 +00:00
.conf.beos-x86-R4 - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.beos-x86-preR4 - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.linux - add NE2000 support for linux by default 2001-08-14 06:09:28 +00:00
.conf.macos - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.sparc - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.win32 - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.win32-cygwin - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
.conf.win32-vcpp - add "--enable-cpp" to change the file extensions into cpp. I hope this 2001-09-24 03:55:40 +00:00
.conf.x86 - with egcs-2.91.66, bochs did not compile if CXX=egcs. It works fine 2001-05-12 05:14:13 +00:00
Bochs.proj.hqx - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
CHANGES - copy CHANGES and README from the 1.2.1 final version 2001-06-12 21:56:59 +00:00
COPYING - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
Makefile.in - add ZIP target. Now "make win32_snap" creates a zip instead of a tar. 2001-09-24 04:21:29 +00:00
README - copy CHANGES and README from the 1.2.1 final version 2001-06-12 21:56:59 +00:00
TESTFORM.txt - add keyboard 2001-06-04 23:06:33 +00:00
bochs.h - add section for BX_WITH_CARBON for macosx 2001-09-26 00:11:23 +00:00
bochs.rsrc.hqx - entered original Bochs snapshot bochs-2000_0325a.tar.gz from 2001-04-10 01:04:59 +00:00
bxversion.h - leave version number unspecified until we are really building a particular 2001-05-23 08:22:23 +00:00
config.h.in - add configure option "--with-carbon" which is used for MacOS X compiles 2001-09-26 00:13:16 +00:00
configure - add configure option "--with-carbon" which is used for MacOS X compiles 2001-09-26 00:13:16 +00:00
configure.in - add configure option "--with-carbon" which is used for MacOS X compiles 2001-09-26 00:13:16 +00:00
install-x11-fonts - apply VPATH patch from Edouard G. Parmelan, posted to list on September 1 2001-09-14 04:19:08 +00:00
load32bitOShack.cc - convert nearly all bx_options to parameter form. All options that have 2001-06-20 14:01:39 +00:00
logio.cc some INFO->DEBUG/ERROR cleanups 2001-08-31 16:06:32 +00:00
macintosh.txt - added strdup replacement function to osdep 2001-04-10 02:02:05 +00:00
main.cc - add code for MacOS X, contributed by emmanuel maillard <e.rsz@libertysurf.fr> 2001-09-26 00:12:12 +00:00
osdep.cc - Patch from Mike Lerwill <mike@homemjl.freeserve.co.uk> 2001-06-28 13:51:41 +00:00
osdep.h - moved win32 hacks into osdep.h so that gui/control.cc (which doesn't 2001-06-22 13:35:48 +00:00
pc_system.cc - replace "long long" with Bit64 2001-09-24 00:35:42 +00:00
pc_system.h Minor updates to the mouse code that may help with enable/disable problems. 2001-09-21 02:46:17 +00:00
state_file.cc setprefix -> put 2001-06-27 19:16:01 +00:00
state_file.h merge in BRANCH-io-cleanup. 2001-05-15 14:49:57 +00:00
win32.txt - updated instructions for compiling under win32 2001-05-30 18:24:48 +00:00

README

Bochs x86 Pentium Emulator
Upated: Tue Jun 12 13:54:43 EDT 2001
Version: 1.2.1

WHAT IS BOCHS?

Bochs is a highly portable open source IA-32 (x86) PC emulator
written in C++, that runs on most popular platforms.  It includes
emulation of the Intel x86 CPU, common I/O devices, and a custom
BIOS.  Currently, bochs can be compiled to emulate a 386, 486 or
Pentium CPU.  Bochs is capable of running most Operating Systems
inside the emulation including Linux, Windows 95, DOS, and 
Windows NT 4.  Bochs was written by Kevin Lawton and is currently 
maintained by the Bochs project at "http://bochs.sourceforge.net".

Bochs can be compiled and used in a variety of modes, some which are
still in development.  The 'typical' use of bochs is to provide
complete x86 PC emulation, including the x86 processor, hardware
devices, and memory.  This allows you to run OS's and software within
the emulator on your workstation, much like you have a machine
inside of a machine.  Bochs will allow you to run Win '95
applications on a Solaris machine with X11, for example.

Bochs is distributed under the GNU LGPL.  See COPYING for details.

GETTING CURRENT SOURCE CODE 

Source code for Bochs is available from the Bochs home page at
http://bochs.sourceforge.net.  You can download the most recent
release, use CVS to get the latest sources, or grab a CVS
snapshot which is updated nightly.  The releases contain the most
stable code, but if you want the very newest features try the
CVS version instead. 

COMPILING BOCHS FROM SOURCES

All releases are gzip'd tar files.  That means the whole Bochs source
code directory has been consolidated into one file using the Unix
command 'tar', then compressed to save space with GNU 'gzip'.  To
extract the source code, you'll need both 'tar' and 'gzip/gunzip'.
All files are contained within one subdirectory named 'bochs-[VERSION]'. 

cd /path/parent-directory
gzip -dc bochs-[VERSION].tar.gz | tar -xvf -
cd bochs-[VERSION]

Before compiling, you'll need to run the configure script, which
will configure source code to run on your system, and with your
chosen options.  There are many options to 'configure', and you
probably don't need any of them.  If you run BeOS, specify
'--with-beos' to configure.  To see a complete list: 

unix-> ./configure --help

For more complete documentation of options available to configure,
look at docs-html/configure.html in your browser.

If configure cannot guess your compiler and compiler arguments,
you will also need to set environment variables to tell configure
what compiler and options to use.  The relevant environment variables 
are CC and CXX (C and C++ compiler), CFLAGS and CXXFLAGS (options
for the C and C++ compiler).

Now run configure, be it manually or by way of a script file. 

unix-> ./configure
-or-
unix-> ./.conf.x86

If the configure script bombs, check 'config.log'. Specifically,
look for errors returned by the compiler.  You may have options
incompatible with your compiler.  See the link on setting the
environment variables above. 

Assuming at this point all went well with the configure command,
edit the file 'config.h', which was generated by ./configure.  Look
for the USER CONFIGURABLE OPTIONS section.  Each parameter available
for editing is documented.  Generally the defaults are fine for
typical users.  Please read about each parameter and edit carefully.
NOTE: This file is generated, and will be deleted if you run 'make
dist-clean'. 

You may now compile the source. 

unix-> make

WHERE ARE THE DOCS?

You have a local copy of the Bochs documentation in docs-html that
came out of the TAR file.  (Point your browser to
docs-html/index.html.)  These same docs are also on the web at
http://bochs.sourceforge.net/docs-html.  If you followed the compile
directions above, the next step is "Setting up the environment
before running" under Compile/Install.

WHERE CAN I GET MORE INFORMATION?  HOW DO I REPORT PROBLEMS?

Both the docs-html and the Bochs website have instructions on how 
to join the bochs-developers mailing list, which is the primary
forum for discussion of Bochs.  The main page of the website also
has links to bug reports and feature requests.  You can browse and
add to the content in these areas even if you do not have a (free)
SourceForge account.  We need your feedback so that we know what
parts of Bochs to improve.  

There is a patches section on the web site too, if you have made
some changes to Bochs that you want to share.

HOW CAN I HELP?

If you would like contribute to the Bochs project, a good first step
is to join the bochs-developers mailing list, and read the archive
of recent messages to see what's going on.  

If you are a technical person (can follow hardware specs, can write
C/C++) take a look at the list of open bug reports and feature
requests to see if you are interested in working on any of the
problems that are mentioned in them.  If you check out the CVS
sources, make some changes, and create a patch, one of the
developers will be very happy to apply it for you.  Developers who
frequently submit patches, or who embark on major changes in the
source can get write access to CVS.  Be sure to communicate with the
bochs-developers list to avoid several people working on the same
thing without realizing it.

If you are a Bochs user, not a hardware/C++ guru, there are still
many ways you could help out.  We have a group of people working on
making win32 binary releases, and building up a set of useful tools
to include in those releases.  Others are writing documentation or
cleaning up the existing documentation.  Others are testing out
Bochs on every imaginable operating system and writing about how
they did it.