Initial commit

.gitignore

@@ -0,0 +1,18 @@
+Makefile
+/config.status
+/libmastik.a
+/src/config.h
+/demo/config.h
+/tools/Doubloon/doubloon
+/tools/Doubloon/src/__pycache__
+/tools/Doubloon/src/config.py
+install_manifest.txt
+tools/tools/
+/config.log
+*.pdf
+*.html
+*.o
+*.a
+.en.utf-8.add
+.en.utf-8.add.spl
+

CREDITS

@@ -0,0 +1,13 @@
+Ben Amos <[email protected]>
+Craig Disselkoen <[email protected]>
+Dallas McNeil <[email protected]>
+Daniel Genkin <[email protected]>
+Diego Aranha <[email protected]>
+Feichi Hu <[email protected]>
+Madura A. Shelton <[email protected]>
+Pierre Ayoub <[email protected]>
+Rui Qi Sim <[email protected]>
+Sioli O'Connell <[email protected]>
+William Kosasih <[email protected]>
+Yuval Yarom <[email protected]>
+Zhiyuan Zhang <[email protected]>

Makefile.in

@@ -0,0 +1,28 @@
+SUBDIRS=mastik src bin tools demo tests
+
+all:
+	for f in ${SUBDIRS}; do   ${MAKE} -C $$f || break ;  done
+
+install: all
+	for f in ${SUBDIRS}; do   ${MAKE} -C $$f install || break ;  done
+
+clean: cleansubdirs localclean
+
+cleansubdirs:
+	for f in ${SUBDIRS}; do   ${MAKE} -C $$f clean;  done
+
+localclean:
+
+distclean: localclean
+	for f in ${SUBDIRS}; do   ${MAKE} -C $$f distclean;  done
+	rm Makefile
+	rm config.status config.log
+
+maintainerclean: versionclean
+	rm configure
+
+versionclean: distclean
+	rm -rf autom4te.cache
+
+
+

README.md

@@ -0,0 +1,113 @@
+# Mastik: A Micro-Architectural Side-Channel Toolkit
+
+## About
+
+Micro-architectural side-channel attacks exploit contention on internal components
+of the processor to leak information between processes. 
+While in theory such attacks are straightforward, 
+practical implementations tend to be finicky and 
+require significant understanding of poorly documented processor features 
+and other domain-specific arcane knowledge. 
+Consequently, there is a barrier to entry into work on 
+micro-architectural side-channel attacks, 
+which hinders the development of the area and the analysis of the 
+resilience of existing software against such attacks.
+
+This repository contains Mastik, a toolkit for experimenting with micro-architectural side-channel attacks. Mastik aims to provide implementations of published attack and analysis techniques. 
+Currently, Mastik supports six side-channel attack techniques on the Intel x86-64 architecture:
+
+- [Prime+Probe](https://www.cs.tau.ac.il/~tromer/papers/cache-joc-official.pdf) on several caches, including
+    - [L1 data cache](https://www.cs.tau.ac.il/~tromer/papers/cache-joc-official.pdf)
+    - [L1 instruction](https://www.iacr.org/archive/ches2010/62250105/62250105.pdf)
+    - L2 (only with huge pages)
+    - [Last Level Cache+Probe](http://palms.ee.princeton.edu/system/files/SP_vfinal.pdf)
+- [Prime+Abort](https://www.usenix.org/system/files/conference/usenixsecurity17/sec17-disselkoen.pdf)
+- [Flush+Reload](https://www.usenix.org/system/files/conference/usenixsecurity14/sec14-paper-yarom.pdf)
+- [Flush+Flush](https://arxiv.org/pdf/1511.04594.pdf)
+- Two variants of [CacheBleed](https://trustworthy.systems/publications/nicta_full_text/9535.pdf)
+- [Performance-degradation attack](https://trustworthy.systems/publications/nicta_full_text/9427.pdf)
+
+
+
+## Installation
+
+Mastik follows the de-facto standard Linux installation process.
+If the system has all of the required software and 
+you want the default configuration, use:  
+`$ ./configure && make && sudo make install`  
+
+See below for more information.
+
+#### Required packages
+For the core operation, Mastik does not require any packages.
+However, the ability to resolve symbols in binaries is extremely useful,
+and requires the build packages `binutils` and `libdwarf` on Linux.  
+On Mac OS X there is no support for debugging symbols yet.
+
+The Mastik GUI interface `doubloon`
+requires Python 3 with the following packages:
+`wx`, `numpy`, `paramiko`, `matplotlib`, and `tqdm`.
+
+Installation depends on the flavour of the Operating System.
+
+**Fedora**:
+`$ sudo dnf install binutils-devel libdwarf-devel`  
+
+**Ubuntu**:
+`$ sudo apt-get install binutils-dev libdwarf-dev libelf-dev`
+
+**CentOS**:  
+Enable the PowerTools repository:  
+`$ sudo dnf config-manager --set-enabled PowerTools`  
+Then install the packages:  
+`$ sudo dnf install libdwarf binutils-devel elfutils-libelf-devel libdwarf-devel python3`
+
+
+#### Configuring the build directory
+
+To set up the build environment, use the `configure` script.
+To use the default options, use:
+
+`$ ./configure`  
+
+The script accepts several flags to modify its behaviour.
+Some of these are listed below.
+Use `./configure --help` for a complete list.
+
+|Flag|Description|
+|----|-----------|
+| `--help`          | Help message                         |
+| `--prefix=PREFIX` | Install files in PREFIX [/usr/local] |
+| `--disable-symbols` | Disables handling of symbol tables in binaries.  Also, removes requirement for `binutils` and `libdwarf` |
+| `--disable-debug-symbols` | Disable handling of debug symbols in binaries.  Removes requirement for `libdwarf`                |
+| `--disable-doubloon`      | Do not install `doubloon`. Removes requirement for Python3 |
+
+
+#### Building Mastik
+
+After configuring the build environment, build Mastik using:
+
+`$ make`
+
+#### Installing Mastik
+To install Mastik, use:
+
+`$ make install`
+
+To change the install directory use:
+
+`$ make prefix=DIR install`
+
+## Usage
+
+For example of usage look at the demo folder.
+
+
+
+## 
+
+
+## Thanks
+
+Mastik is supported by a generous gift from Intel.
+

VERSION

@@ -0,0 +1 @@
+0.1

bin/.gitignore

@@ -0,0 +1,10 @@
+FR-*
+L1-*
+L3-*
+FF-*
+CB-*
+ST-*
+!*.c
+
+gpg-1.4.13
+out