Go to file
Stanislav Shwartsman 6481d24e06 Another cleaner way to implemented fix by rei141
from Fixes in VM Entry Checks for Guest Segment Registers #51

Correction in checks for Code Segment (CS):
Previously, the DPL of CS was incorrectly compared with its own RPL.
According to Intel SDM, Vol. 3C, Chapter 27.3.1.2, for non-conforming code segments (type 9 or 11), the DPL of CS should be equal to the DPL of SS.
And for conforming code segments (type 13 or 15), the DPL of CS cannot be greater than the DPL of SS.

This way VMCS is not accessed multiple times which is important for some usages
2023-08-20 19:33:37 +03:00
.github/workflows cpu/vmx definitions (#20) 2022-07-27 20:51:25 +03:00
bochs Another cleaner way to implemented fix by rei141 2023-08-20 19:33:37 +03:00
bochs-performance
bochs-testing
.gitattributes Add .gitattributes force eol to LF (no CR+LF) (#18) 2022-07-24 18:27:33 +03:00
.gitignore Ignore .vscode and bochs-msvc-src.zip 2022-08-26 19:46:11 -07:00
LICENSE
README.md Github README WIP 2022-07-13 09:44:25 -04:00

Welcome to the Bochs IA-32 Emulator Project

Bochs is a portable 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.

Bochs can be compiled to emulate many different x86 CPUs, from early 386 to the most recent (sometimes even pre-market) x86-64 Intel and AMD processors.

Bochs is capable of running most Operating Systems inside the emulation including Linux, DOS or Microsoft Windows.

Bochs provides many different modes of operation, in support of a wide variety of use cases. 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. For instance, let's say your workstation is a Unix/X11 workstation, but you want to run Win'95 applications. Bochs will allow you to run Win 95 and associated software on your Unix/X11 workstation, displaying a window on your workstation, simulating a monitor on a PC.

Bochs Approach

Bochs is an emulator - not virtualization software. It is portable across many architectures: x86, ARM, MIPS, etc. This means it must be able to emulate every CPU instruction.

This distinguishes Bochs from virtualization solutions like e.g. VirtualBox, VMWare, etc. Those projects provide a nice user experience and fast performance, at the cost of hardware constraints, some non-determinism and some necessary hacks to get programs working.

Bochs' emulation provides a controlled, accurate execution environment, at the cost of speed/performance. This can be advantageous in some situations, for example:

  • When developing an operating system or bootloader
  • When dealing with very old, mission-critical software
  • When reverse-engineering system-level code

For more information, see the intro section in the user guide.

Installing

You can download Bochs from the project page on SourceForge. See the CHANGES file for details on the most recent releases.

Usage

See the documentation.

Contributing

To get started, see Bochs Developer Guide.

We currently need help with the below tasks. To help with one of these tasks, please contact Volker Ruppert or Stanislav Shwartsman.

Bug Reports

Mouse, interrupt controller, timer, IDE controller, network card, keyboard, VGA... Most of our bug reports and feature requests are due to incomplete C++ models of the various PC devices. To improve this, we need PC Hardware Gurus who know where to find the specs for this stuff and improve the hardware models for Bochs. Working on models is a fun way to learn how things work, and unlike designing a real hard disk, you can test out your changes on a real operating system immediately!

Disk Images

Our collection of disk images is getting out of date. It would be great to have small or large images of a variety of free operating systems.

Documentation

Adding installation help and other useful information into the docs.

Papers/Presentations

  • Bochs was presented at ISCA-35 in Beijing, China at "The 1st Workshop on Architectural and Microarchitectural Support for Binary Translation" by a paper "Virtualization without direct execution - designing a portable VM".

Authors

Bochs was originally written by Kevin Lawton and is currently maintained by this project.