andr3/scyther
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Scyther with my modifications
1,525 Commits 1 Branch 0 Tags 21 MiB
C 42.9%
Python 28.8%
TeX 14.1%
C++ 9.8%
Shell 1.2%
Other 3.1%
c9b1d08f4f
Go to file
Cas Cremers c9b1d08f4f Hack for Windows users to compensate for Graphviz "feature". 
Recent versions of Graphviz no longer set the PATH variable on Windows.
Hence Scyther can fail to find dot.exe even though Graphviz was appropriately
installed.

This patch is a hack to try and locate dot.exe in the more common locations.
We currently have a hardcoded search through:

  C:\Program Files\Graphviz*
  C:\Program Files (x86)\Graphviz*

This is clearly fragile. Obviously, nobody should be solving Graphviz' problem
in such an ugly way. Change drives or languages and it stops working.

Until Graphviz provides at least an alternative environment variable (GVPATH?)
this hack will help the bulk of our users to get things up and running smoothly.
2013-12-09 14:24:57 +00:00
dist Fixed release scripts to work with new git conventions. 2008-09-10 11:20:50 +02:00
gui Hack for Windows users to compensate for Graphviz "feature". 2013-12-09 14:24:57 +00:00
scripts Added loop script which I had always wanted before. 2008-08-21 21:55:55 +02:00
src Updating time stamps for next release. 2013-10-05 23:56:12 +01:00
testing Updating the protocol generator for the ffgg family. 2013-11-18 16:59:11 +00:00
commit-template Added template for commits. 2011-04-06 10:50:43 +02:00
Makefile Minor synchronisation updates. 2012-12-17 10:14:31 +01:00
protocols Added softlink to protocols directory. 2012-11-15 13:41:02 +01:00
README.md Fixing path. 2012-12-17 11:33:48 +01:00

README.md

The Scyther tool repository

This README describes the organization of the repository of the Scyther tool for security protocol analysis. Its intended audience are interested users and future developers of the Scyther tool, as well as protocol modelers. For installation and usage instructions of the Scyther tool see: http://people.inf.ethz.ch/cremersc/scyther/index.html.

Installing from source

We use Linux during the development of Scyther, but development on Windows and MAC OS X should be equally feasible. Note that the below instructions are written from a Linux/Ubuntu perspective, and probably need modifications for other platforms.

Scyther is written partly in Python (for the GUI, using wxPython) and partly in C (for the backend).

In order to run the tool from a repository checkout, it is required to compile the C sources into a working binary for the backend. The simplest way to achieve this is to run the build.sh script in the ./src directory. This script compiles a binary version of the tool on the native platform. Thus, in the Linux case, it should produce ./src/scyther-linux. This file is automatically copied to the related directory under ./gui, and if successful you can attempt to run ./gui/scyther-gui.py to use the graphical user interface.

The build process depends on the following (Debian/Ubuntu) packages:

  • cmake
  • build-essential
  • flex
  • bison

If you are using Ubuntu, installing these may be as simple as running

sudo apt-get install cmake build-essential flex bison

In case you also want to be able to compile Windows binaries from Linux, you also need:

  • mingw32

Note that welcome all contributions, e.g., further protocol models. Just send us a pull request.

Manual

We are currently rewriting the manual. The current (incomplete) snapshot of the manual can be found here:

  • ./gui/scyther-manual.pdf

Protocol Models

The protocol models have the extension .spdl and can be found in the following directories:

  • ./gui/Protocols, containing the officially released models, and
  • ./testing, containing models currently under development.

License

Currently these Scyther sources are licensed under the GPL 2, as indicated in the source code. Contact Cas Cremers if you have any questions.