Getting PTLsim
Download
The PTLsim source code is distributed as several versions:- Latest Stable Version (2009-03-14 svn rev 229)
This is the most up to date version of PTLsim that has passed all our test suites. - Development Snapshots
Development snapshots are made every few days as updates and bug fixes are made to PTLsim. Typically these updates will either be minor in nature or experimental and hence not appropriate for all users unless you have a specific bug that's only fixed in the Subversion version.
NOTE: These files are compressed using bzip2, not gzip. Please use tar jxvf filename.tar.bz2 to extract them on any Linux system.
The same PTLsim code base builds on both standard 32-bit x86 and 64-bit x86-64 (the Makefile will automatically configure its features for your platform).
Full system PTLsim/X is also built from the same source base, by specifying PTLSIM_HYPERVISOR=1 in the Makefile. The complete changelog for PTLsim is stored in Subversion; use the svn log command to list it.
NOTE: Users are strongly advised to read the Getting Started section of the PTLsim User's Guide and Reference to avoid confusion about how to build and run PTLsim.
Subversion Access
PTLsim is also available via Subversion, the well known version control system and successor to CVS. This is the recommended way to get PTLsim, since it lets you stay up to date automatically.To check out the latest PTLsim source code, use the following:
svn co https://ptlsim.org/repository/trunk/ptlsim
Even if you download the stable or development tar.gz packages above, you can always just run svn update to turn the downloaded version into the latest development version.
IMPORTANT: We may update the simulation parameter files (ooohwdef.cpp and ooohwdef.h) via Subversion. Make sure you keep a backup of any changes you made, or they may be lost when svn update is used!
Documentation and tutorials on Subversion can be found here.
Full System PTLsim Files
These files and disk images are only required for full system PTLsim. Please see the manual for more information.
-
xen-3.1-ptlsim.tar.bz2: Xen hypervisor source code (version 3.1), pre-patched with all PTLsim extensions.
-
linux-2.6.22.6-mtyrel-64bit-xen.tar.bz2: Linux 2.6.22.6 compiled kernel with Xen extensions and patches (see below), suitable for use in both domain 0 and any user domains under simulation. This kernel can be used alone for domU since all the required modules (xennet, xenblk, ext2) are compiled in. However, you may need to use mkinitrd to collect the required drivers for use on the real hardware in dom0.
-
linux-2.6.22-mtyrel-source.tar.bz2: source code for the customized Linux kernel we use for testing.
-
ptlsim-disk-image-example.tar.bz2: Example disk image and scripts for rebuilding the image and making checkpoints.
You can found out how to set up disk images and checkpoints on our page describing our SPEC cpu 2006 benchmark suite toolkit for PTLsim. Since we cannot distribute some of the SPEC benchmarks themselves, we're just including an example disk image, ptlsim-disk-image-example.tar.bz2 from above, with similar filenames and scripts.