Getting PTLsim

Download

The PTLsim source code is distributed as several versions:

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.

git Access

PTLsim is also available via git, the version control system used for the Linux kernel and many other projects. This is the recommended way to get PTLsim, since it lets you stay up to date automatically.

You can browse the available PTLsim git repositories at http://www.ptlsim.org/git.

To check out the latest stable PTLsim source code, just run:

git clone git://git.ptlsim.org/ptlsim-stable.git
NOTE: Some firewalls may interfere with git downloads. If you encounter problems, run git clone http://git.ptlsim.org/git/ptlsim-stable.git instead.

Even if you download the stable or development tar.gz packages above, you can always just run git pull to turn the downloaded version into the latest development version.

PTLsim developers may directly access the repo via ssh using git clone git.ptlsim.org:/project/git/ptlsim-stable.git.

PTLsim 3.0 KVM/QEMU Development Version

We have released the first preliminary version of PTLsim 3.0, based on KVM/QEMU and offering an array of groundbreaking new features.

This is an early development release only! It is not yet usable for mainstream simulation work by PTLsim end users, and it is not officially supported yet. Instead, we hope it will give advanced PTLsim developers and contributors an opportunity to see what's planned, and will provide a foundation for collaborative development of PTLsim 3.0.

Unless you're prepared to help develop this highly experimental code and are already a PTLsim expert, please download the Xen-based production ready release of PTLsim above!

Make sure you read the PTLsim 3.0 KVM/QEMU Introduction and Preliminary Documentation (PTLsim-KVM-Intro.pdf) for instructions on how to get started.

Download the PTLsim 3.0 KVM/QEMU prerelease via git:

git clone git://git.ptlsim.org/ptlsim-kvm.git
git clone git://git.ptlsim.org/qemu-kvm-ptlsim.git

PTLsim 3.0 KVM/QEMU Mailing List

We have a new ptlsim-kvm@ptlsim.org list for discussions related to the KVM release. Click here to subscribe to this list. Only subscribers may post to the list.

Please do not post PTLsim/KVM related messages to ptlsim-devel@ptlsim.org (that list is for the production Xen-based release only).

Full System PTLsim Files

These files and disk images are only required for full system PTLsim. Please see the manual for more information.

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.

License

PTLsim is licensed under the GNU General Public License, version 2..

Subversion Access (deprecated)

PTLsim previously used Subversion (SVN) as its version control system. Please use the git repository (see above) from now on, since we no longer update our deprecated SVN repository.

If you run svn update on your existing PTLsim repository after August 14, 2009, it will not check out any new changes made after this date. The SVN server will be turned off in the near future.