1224dd7cef253aea90c8705ca7e580c852452442
[pintos-anon] / src / misc / bochs-2.2.6.README
1 This version of Pintos is designed for use with Bochs 2.2.6.  A few
2 patches for this version of Bochs are included:
3
4     bochs-2.2.6-big-endian.patch
5
6         Makes the gdb stubs work on big-endian systems such as
7         Solaris/Sparc, by doing proper byteswapping.  It should be
8         harmless elsewhere.
9
10     bochs-2.2.6-jitter.patch
11
12         Adds the `jitter' feature described in the project documentation,
13         in which timer interrupts are delivered at random intervals.
14
15     bochs-2.2.6-triple-fault.patch
16
17         Causes Bochs to break to GDB when a triple fault occurs and
18         the GDB stub is active.
19
20     bochs-2.2.6-ms-extensions.patch
21
22         Needed for Bochs to compile with GCC on some hosts.  Probably
23         harmless elsewhere.
24
25     bochs-2.2.6-solaris.patch
26
27         Needed on Solaris hosts.  Do not apply it elsewhere.
28
29 To apply all the patches, cd into the Bochs directory, then type
30         patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-big-endian.patch
31         patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-jitter.patch
32         patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-triple-fault.patch
33         patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-ms-extensions.patch
34         patch -p1 < $PINTOSDIR/src/misc/bochs-2.2.6-solaris.patch
35 You will have to supply the proper $PINTOSDIR, of course.  You can use
36 patch's --dry-run option if you want to test whether the patches would
37 apply cleanly before trying to apply them.
38
39 Sample commands to build and install Bochs for Pintos are supplied in
40 bochs-2.2.6-build.sh.