Sample

Sample (Static Analyzer of Multiple Programming Languages) is a generic static analyzer based on the based on the abstract interpretation theory.

This readme is currently being updated and still incomplete.

Module Overview

sample_core: The core of sample containing the statements of the intermediate language and their semantics, some basic implementation of abstract states.
sample_numerical: Numerical analyses, both non-relational and relational.
sample_apron: Provides an interface to the numerical domains provided by the Apron library.
sample_silver: The part of sample that is specific to Viper, which includes translations form and to the intermediate language used by Viper and some implementations of Viper specific analyses.
sample_qp: The implementation of the Permission Inference for Array Programs.

Follow the instructions to install Silver, Silicon, and Carbon. It is recommended to install the Viper tools as project-named subfolders under a common Viper directory. The instructsions below assume that you have chosen such a top-level Viper folder; if you do not, you need to adapt the relative paths when you create the symbolic links as described in the following.
Clone the Sample repository (this repository) and switch to the newly created Sample directory.
```
git clone https://github.com/viperproject/sample.git
cd sample
```
From within the directory where you installed Sample, create symbolic links to the directories where you installed Silver, Silicon, and Carbon.

Linux or Mac:
```
ln -s ../silver silver
ln -s ../silicon silicon
ln -s ../carbon carbon.
```
Windows:
```
mklink /D silver ../silver
mklink /D silicon ../silicon
mklink /D carbon ../carbon
```
Compile Sample using SBT.
```
sbt compile
```

Libraries must be installed in a location that is accessible by ld. To separate these libraries from the package manager libraries, the default choice is usr/local/lib which is usually not scanned. It is therefore necessary to set the LD_LIBRARY_PATH environment variable before running Sample.