Bochs/bochs
Kevin Lawton 80dd7a07ec Removed references to building libextdb.a. It doesn't seem to
be used at all, and Peter didn't want it.  "extdb.o" is compiled
into libcpu.a, if configured for it.

Removed a few #warnings for x86-64 compile, based on Peter's
line-item comments regarding the warnings I inserted during
the port/merge.
2002-09-15 15:10:21 +00:00
..
bios - updated from rombios-new-ata.c rev 1.5 2002-09-13 14:31:53 +00:00
build - add --clean option to make it easy to clean up afterward 2002-09-15 14:35:38 +00:00
cpu Removed references to building libextdb.a. It doesn't seem to 2002-09-15 15:10:21 +00:00
debug - rename debug_fputs to debug_puts. Since it doesn't take a file handle, 2002-09-15 12:08:40 +00:00
disasm - update Makefile dependencies on nearly everything 2002-08-27 22:43:57 +00:00
doc - added description for the option "#include" 2002-09-09 17:41:36 +00:00
docs-html - add instructions for installing Gnu Hurd, from 2002-09-01 13:04:59 +00:00
dynamic
font - font char 0x00 is a blank, not a "@" 2002-05-25 14:22:53 +00:00
fpu - check in Stanislav Shwartsman's patch "bochs-mmx.patch-endian-support". 2002-09-09 16:11:25 +00:00
gui - rename debug_fputs to debug_puts. Since it doesn't take a file handle, 2002-09-15 12:08:40 +00:00
instrument
iodev - in debugger, all output must now be printed with dbg_printf, instead 2002-09-15 11:20:11 +00:00
memory Now, when you compile with --enable-guest2host-tlb, non-paged 2002-09-05 02:31:24 +00:00
misc - fix unused variable warning 2002-09-05 16:50:03 +00:00
patches - Initial revision of the 4 ata channels patch. 2002-09-14 07:34:41 +00:00
.bochsrc - renamed serial and parallel options "Opresent" to "Oenabled" and "*_PRESENT" 2002-08-24 17:11:33 +00:00
.conf.AIX.4.3.1
.conf.amigaos
.conf.beos-x86-R4
.conf.beos-x86-preR4
.conf.linux - clean up .conf files. now all have cdrom, sound, ne2k, and vbe. 2002-03-21 02:50:06 +00:00
.conf.macos
.conf.macosx
.conf.sparc
.conf.win32
.conf.win32-cygwin - clean up .conf files. now all have cdrom, sound, ne2k, and vbe. 2002-03-21 02:50:06 +00:00
.conf.win32-vcpp - clean up .conf files. now all have cdrom, sound, ne2k, and vbe. 2002-03-21 02:50:06 +00:00
Bochs.proj.hqx
CHANGES - added tha 1.4.1 release informations 2002-06-25 22:55:58 +00:00
COPYING
Makefile.in Removed references to building libextdb.a. It doesn't seem to 2002-09-15 15:10:21 +00:00
README - I can't believe it! I've been spelling "updated" wrong since last June!!! 2002-03-28 07:52:26 +00:00
README-wxWindows - clean up wx compile instructions for win32 2002-09-03 15:23:14 +00:00
TESTFORM.txt
bochs.h I merged the cpu/cpu.h and cpu64/cpu.h files as well as the 2002-09-13 00:15:23 +00:00
bochs.rsrc.hqx
bxversion.h.in
config.guess
config.h.in Added big/little-endian specific declarations for the Bit128{u,s} 2002-09-15 05:29:06 +00:00
config.sub
configure Removed references to building libextdb.a. It doesn't seem to 2002-09-15 15:10:21 +00:00
configure.in Removed references to building libextdb.a. It doesn't seem to 2002-09-15 15:10:21 +00:00
install-sh
install-x11-fonts.in - modified paths to make this file work with the FHS compatible directories 2002-06-26 17:10:36 +00:00
load32bitOShack.cc I merged the cpu/cpu.h and cpu64/cpu.h files as well as the 2002-09-13 00:15:23 +00:00
logio.cc - move divider (a bunch of equals signs) down to where it's used, so that 2002-09-15 11:02:22 +00:00
macintosh.txt
main.cc - set default action to REPORT for panics. I think that's only used when reading 2002-09-09 07:19:23 +00:00
osdep.cc
osdep.h
pc_system.cc Now, when you compile with --enable-guest2host-tlb, non-paged 2002-09-05 02:31:24 +00:00
pc_system.h Integrated patches for: 2002-09-01 20:12:09 +00:00
state_file.cc
state_file.h
test-x11-fonts
win32.txt
wxbochs.rc - commit patch.wxwindows.gz in the main branch. Now you can try out 2002-04-18 00:22:20 +00:00

README

Bochs x86 Pentium Emulator
Updated: Wed Mar 27 20:02:41  2002
Version: 1.4

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. 

WHERE ARE THE DOCS?

The Bochs documentation has been overhauled, and it is now
distributed in a separate package called bochsdoc-VERSION.tar.gz.
A copy is also online at 
  http://bochs.sf.net/doc/docbook/alldocs.html
For now, the old documentation can still be found at
  http://bochs.sf.net/docs-html

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

Both the documentation 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.  For example:
  - improving win32 binary releases
  - building up a set of useful tools to include in those releases
  - writing/cleaning up documentation
  - testing out Bochs on every imaginable operating system and 
    reporting how it goes.