README.md

bochscpu

install

Download the prebuilt artifacts from bochscpu-build. Install the lib and bochs folders into the bochscpu checkout. For example:

bochscpu$ ls -l
total 20
drwxrwxrwx 1 x x 4096 Jan  3 00:09 bochs      # bochs directory from pre-built artifacts
-rwxrwxrwx 1 x x 8318 Jan  2 23:28 build.rs
drwxrwxrwx 1 x x 4096 Jan  2 23:28 cabi
-rwxrwxrwx 1 x x 4772 Jan  3 00:16 Cargo.lock
-rwxrwxrwx 1 x x  427 Jan  2 23:28 Cargo.toml
drwxrwxrwx 1 x x 4096 Jan  3 00:09 lib        # lib directory from pre-built artifacts
-rwxrwxrwx 1 x x  502 Jan  2 23:28 README.md
drwxrwxrwx 1 x x 4096 Jan  3 00:20 src
drwxrwxrwx 1 x x 4096 Jan  3 00:16 target
-rwxrwxrwx 1 x x  276 Jan  2 23:28 TODO.md

usage

bochscpu exposes all the instrumentation points that bochs does. These are documented here.

For an example of initalizing and using the emulator, see the source code for the benchmark example.