If you use a Zoo machine that runs Linux,
then most of the software needed will be installed locally.
To set the correct paths run
If you're using a personal machine running Debian/Ubuntu, you can install the necessary tools by running:
sudo apt-get install -y build-essential gcc-multilib gdb
We highly recommend using Linux or Zoo machines. However, if you have a Mac OS X machine, you can compile the toolchain, which should allow you to do the labs. Do not attempt to work on the labs while using Windows.
For an overview of useful commands in the tools used in CPSC422/522, see the lab tools guide.
Note: The course staff have not verified that these instructions still work. They are reproduced from MIT's 6.828.
Most modern Linuxes and BSDs have
an ELF toolchain compatible with the labs.
That is, the system-standard
objdump should just work.
The lab makefile should automatically detect this.
However, if your machine is in this camp
and the makefile fails to detect this,
you can override it by adding the following line to
If you are using something other than standard x86 Linux or BSD,
you will need the GNU C compiler toolchain,
configured and built as a cross-compiler
for the target
as well as the GNU debugger,
configured for the
You can download the specific versions we used via these links,
although any recent versions of gcc, binutils, and GDB should work:
Once you've unpacked these archives, run the following commands as root:
$ cd binutils-2.21.1 $ ./configure --target=i386-jos-elf --disable-werror --disable-nls $ make $ make install $ cd ../gcc-4.5.1 $ ./configure --target=i386-jos-elf --disable-nls --without-headers \ --with-newlib --disable-threads --disable-shared \ --disable-libmudflap --disable-libssp $ make $ make install $ cd ../gdb-6.8 $ ./configure --target=i386-jos-elf --program-prefix=i386-jos-elf- \ --disable-werror $ make $ make install
Then you'll have in /usr/local/bin binaries with names like i386-jos-elf-gcc. The lab makefile should detect this toolchain and use it in preference to your machine's default toolchain. If this doesn't work, there are instructions on how to override the toolchain inside the GNUmakefile in the labs.
QEMU is a modern and fast PC emulator.
A special version of QEMU version 1.7.0,
as described below,
is set up on the Zoo. Add it to your path by executing
Unfortunately, QEMU's debugging facilities, while powerful, are somewhat immature, so we highly recommend you use our patched version of QEMU instead of the stock version that may come with your distribution. The version installed on the Zoo is already patched. To build your own patched version of QEMU:
git clone https://github.com/davidiw/qemu.git -b 6.828-1.7.0
./configure --disable-kvm [--prefix=PFX] [--target-list="i386-softmmu x86_64-softmmu"]
./configure --disable-kvm --disable-sdl [--prefix=PFX] [--target-list="i386-softmmu x86_64-softmmu"]The
prefixargument specifies where to install QEMU; without it QEMU will install to
/usr/localby default. For example, a useful prefix that will not require root access is
target-listargument slims down the architectures QEMU will build support for.
make && make install