Difference between revisions of "Getting Started"
Jump to navigation
Jump to search
| (15 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
* Get the Sniper source code from our [[Download]] page | * Get the Sniper source code from our [[Download]] page | ||
| − | * Download | + | * Download a [https://software.intel.com/en-us/articles/pin-a-dynamic-binary-instrumentation-tool Pin] or [https://software.intel.com/en-us/articles/program-recordreplay-toolkit Pinplay] kit from their respective sites. |
| − | ** Extract Pin | + | ** The master branch of Sniper works with modern Pin versions (Pin 3.0+), while the pin2 branch works with older versions (Pin 2.14-71313). We recommend using a modern Pin 3 version if possible. |
| − | ** | + | ** Sniper 7.2 has been tested with versions of Pin up to Pin-3.7 and Pinplay-3.5. |
| + | ** Extract Pin and symlink or rename to the pin_kit directory in Sniper's subdirectory: <code>sniper/pin_kit</code> | ||
| + | ** Set PIN_HOME to the location of Pin if you use a different directory or shared Pin location | ||
| + | |||
| + | * Install Option 1 - Docker Install | ||
| + | ** <code>cd sniper/docker</code> | ||
| + | ** <code>make # build the Docker image</code> | ||
| + | ** <code>make run # starts running the Docker image</code> | ||
| + | ** <code>cd .. # return to the base Sniper directory (while running inside of Docker)</code> | ||
| + | |||
| + | * Install Option 2 - Native install | ||
| + | ** <code>sudo dpkg --add-architecture i386</code> | ||
| + | ** <code>sudo apt-get install binutils build-essential curl git libboost-dev libbz2-dev libc6:i386 libncurses5:i386 libsqlite3-dev libstdc++6:i386 python wget zlib1g-dev</code> | ||
* Compile Sniper. Some extra dependencies (a pre-compiled copy of the Python interpreter environment) will be downloaded automatically, so make sure you have a working internet connection when you make Sniper for the first time | * Compile Sniper. Some extra dependencies (a pre-compiled copy of the Python interpreter environment) will be downloaded automatically, so make sure you have a working internet connection when you make Sniper for the first time | ||
| − | ** <code>make</code> | + | ** <code>make # or use 'make -j N' where N is the number of cores in your machine to use parallel make</code> |
* Running an application | * Running an application | ||
| − | |||
** <code>cd test/fft; make run</code> | ** <code>cd test/fft; make run</code> | ||
| Line 19: | Line 30: | ||
* [[Download Benchmarks|Obtaining more benchmarks]] | * [[Download Benchmarks|Obtaining more benchmarks]] | ||
| + | |||
| + | * [[Multi-programmed workloads|Run multi-programmed workloads]] | ||
* [[Simulator hooks|Accessing simulator hooks from inside an application]] | * [[Simulator hooks|Accessing simulator hooks from inside an application]] | ||
| Line 26: | Line 39: | ||
=== Prerequisites === | === Prerequisites === | ||
| − | * | + | * Modern Ubuntu version (16.04, 18.04, etc.) |
| − | * A recent Pin version (for example, [ | + | * A recent Pin version (for example, [https://software.intel.com/en-us/articles/pin-a-dynamic-binary-instrumentation-tool Pin 3.5] or newer recommended) |
| − | |||
Latest revision as of 04:15, 17 February 2019
- Get the Sniper source code from our Download page
- Download a Pin or Pinplay kit from their respective sites.
- The master branch of Sniper works with modern Pin versions (Pin 3.0+), while the pin2 branch works with older versions (Pin 2.14-71313). We recommend using a modern Pin 3 version if possible.
- Sniper 7.2 has been tested with versions of Pin up to Pin-3.7 and Pinplay-3.5.
- Extract Pin and symlink or rename to the pin_kit directory in Sniper's subdirectory:
sniper/pin_kit - Set PIN_HOME to the location of Pin if you use a different directory or shared Pin location
- Install Option 1 - Docker Install
cd sniper/dockermake # build the Docker imagemake run # starts running the Docker imagecd .. # return to the base Sniper directory (while running inside of Docker)
- Install Option 2 - Native install
sudo dpkg --add-architecture i386sudo apt-get install binutils build-essential curl git libboost-dev libbz2-dev libc6:i386 libncurses5:i386 libsqlite3-dev libstdc++6:i386 python wget zlib1g-dev
- Compile Sniper. Some extra dependencies (a pre-compiled copy of the Python interpreter environment) will be downloaded automatically, so make sure you have a working internet connection when you make Sniper for the first time
make # or use 'make -j N' where N is the number of cores in your machine to use parallel make
- Running an application
cd test/fft; make run
Next steps
Prerequisites
- Modern Ubuntu version (16.04, 18.04, etc.)
- A recent Pin version (for example, Pin 3.5 or newer recommended)
