Updated changelogs and readme's.

This commit is contained in:
Cas Cremers 2012-12-17 11:26:04 +01:00
parent 091ce01f60
commit 408a88807f
4 changed files with 163 additions and 79 deletions

View File

@ -55,7 +55,7 @@ Manual
We are currently rewriting the manual. The current (incomplete) snapshot
of the manual can be found here:
* `./doc/scyther-manual.pdf
* `./doc/manual/scyther-manual.pdf`
Protocol Models

View File

@ -1,67 +1,120 @@
---------------------
- Scyther changelog -
---------------------
Scyther changelog
===============================
Next release:
Scyther 1.1
-------------------------------
Bugfixes:
Major new features:
* Python 2.5 has integrated (c)elementtree into the core.
Unfortunaly, this broke our previous import attempts.
* [Language] Added support for `macro Term1 = Term2;` definitions, which greatly
simplifies many specifications.
* [Language] Added support for `match(T1,T2);` events in roles, which
can be used for e.g. a straightforward modeling of delayed decryption.
* [Language] Added support for `not match(T1,T2);` events in roles.
This can be useful for, e.g., modeling protocol restrictions (such as
`A != B`).
* [Language] Added support for `option "COMMANDLINE_OPTIONS";` in
specifications. This provides full access to the command-line options
of the Scyther backend to the protocol specifications. An example of
its use is `option "--one-role-per-agent";`.
* [Mac OS X] Dropped support for PPC in Scyther distributions, only
supporting Intel for now. Note that installing from source may still
work fine with a minor tweak to the build script.
Additional protocol models:
See <http://people.inf.ethz.ch/cremersc/tools/protocols.html> for a
more high-level overview of selected protocol models.
* IEEE 802.16e/WIMAX: PKMv2rsa and variants
* IKEv1 and IKEv2 protocol suites
Other new features:
* `SCYTHERCACHEDIR` environment variable can be set to override the
internal cache path.
* [Backend] The command-line tool now supports the option
`--one-role-per-agent`. This disallows agents from performing more than
one role in a single trace. This effectively partitions the agents into
role sets, i.e., each role can only be performed by agents from one of
these sets.
* [Documentation] Added the first incomplete version of the new manual.
There are also various minor bugfixes and installation improvements.
Scyther 1.0
-------------------------------
Major new features:
* [Language] Support for weak agreement
* [Language] Support for non-injective data agreement through `Commit`
and `Running` signals.
Bugfixes:
* Python 2.5 has integrated (c)elementtree into the core.
Unfortunaly, this broke our previous import attempts. This has now
been fixed.
Scyther 1.0-beta7.1
-------------------------------
Bugfixes:
Bugfixes:
* Windows Vista fix broke Windows XP support.
* Windows Vista fix broke Windows XP support.
Scyther 1.0-beta7
-------------------------------
Bugfixes:
Bugfixes:
* Windows Vista causes a number of problems. The biggest problem
is now fixed, which is the bad implementation of the tmpfile() C
function, causing no attack output, for which there is a
workaround now.
* Windows Vista causes a number of problems. The biggest problem
is now fixed, which is the bad implementation of the tmpfile() C
function, causing no attack output, for which there is a
workaround now.
Scyther 1.0-beta6
Big new features:
-------------------------------
Major new features:
* [Gui] Added Mac support (added universal binary)
* [Gui] Switched to Scintilla editor component, providing undo
and line numbering, and highlighting of error lines.
* [Gui] Added Mac support (added universal binary)
* [Gui] Switched to Scintilla editor component, providing undo
and line numbering, and highlighting of error lines.
Other new features:
Other new features:
* [Backend] Scyther now detects when a recv event cannot match
with a send event. This significantly helps in reducing errors
in the protocol descriptions.
* [Language] Added claim parameter for Reachable claim;
Reachable,R means that role R should be trusted (as well as the
actor), but not any other role. This can be useful for showing
stronger authentication properties of protocols with more than
two parties.
* [Backend] Added '--max-of-role=N' switch (to narrow scenarios)
* [Backend] Added '--scan-claims' switch (allows for retrieving
a list of claims)
* [Scripting] Added 'verifyOne' and 'scanClaims' methods to
Scyther object, to help with singular claim testing.
* [Backend] Scyther now detects when a recv event cannot match
with a send event. This significantly helps in reducing errors
in the protocol descriptions.
* [Language] Added claim parameter for Reachable claim;
Reachable,R means that role R should be trusted (as well as the
actor), but not any other role. This can be useful for showing
stronger authentication properties of protocols with more than
two parties.
* [Backend] Added '--max-of-role=N' switch (to narrow scenarios)
* [Backend] Added '--scan-claims' switch (allows for retrieving
a list of claims)
* [Scripting] Added 'verifyOne' and 'scanClaims' methods to
Scyther object, to help with singular claim testing.
Bugfixes:
Bugfixes:
* [Scripting] Fixed bug in python interface backend (e.g. with mpa.py)
* [Scripting] Fixed bug in python interface backend (e.g. with mpa.py)
Scyther 1.0-beta5
-------------------------------
* Change of switch semantics. '--max-attacks=N' now defines the
maximum number of attacks per claim. Previously this was a
global maximum for all claims combined.
* Improved attack graph output.
* added switch '--errors=FILE' to redirect standard error output
to a file.
* Rewrote parts of the gui code for improved stability.
* Change of switch semantics. '--max-attacks=N' now defines the
maximum number of attacks per claim. Previously this was a
global maximum for all claims combined.
* Improved attack graph output.
* added switch '--errors=FILE' to redirect standard error output
to a file.
* Rewrote parts of the gui code for improved stability.
Scyther 1.0-beta4
-------------------------------
* (Changelog starts after the release of Scyther 1.0-beta4)
* (Changelog starts after the release of Scyther 1.0-beta4)

66
gui/README.md Normal file
View File

@ -0,0 +1,66 @@
The Scyther tool
================
Scyther is a tool for the symbolic analysis of security protocols. It is
developed by Cas Cremers, and is available from
<http://people.inf.ethz.ch/cremersc/scyther/index.html>.
The below instructions apply only to the *distribution version* of
the Scyther tool. If you are working from the source files, some paths may be
slightly different, and it is recommended to follow the instructions in '../README.md'.
Running the scyther tool
------------------------
### Graphical user interface ###
The graphical user interface can be started by running `scyther-gui.py`,
e.g., enter the following in a terminal and press return
python ./scyther-gui.py
### Command-line usage ###
In the directory `./Scyther` there should be an executable for the
Scyther backend. Its name depends on the platform:
* `scyther-linux` (Linux)
* `scyther-w32` (Windows)
* `scyther-mac` (Mac OS X)
If this executable does not exist, you probably downloaded the source
files, and will need to compile it first. See `../README.md` for further
details.
There are also various test scripts (for usage in Linux) in this
directory.
Obtaining the sources
----------------------
Scyther is being developed on *Github*, and its complete source files are
availabe from
<https://github.com/cascremers/scyther>.
Manual
------
We are currently rewriting the manual. The current (incomplete)
distribution version of the manual can be found here:
* `./scyther-manual.pdf`
Protocol Models
---------------
The protocol models have the extension `.spdl` and can be found in the following directories:
* `./Protocols` and its subdirectories.
License
-------
Currently the Scyther tool is licensed under the GPL 2, as indicated in
the source code. Contact Cas Cremers if you have any questions.

View File

@ -1,35 +0,0 @@
------------------------------------------------------------------------
Scyther
an automatic verification tool for security protocols
by Cas Cremers
------------------------------------------------------------------------
Note: This is a BETA release, and therefore the usual warnings apply.
1. More information
========================================================================
For more information, see:
http://people.inf.ethz.ch/cremersc/scyther/index.html
2. Starting out
========================================================================
Start the graphical user interface by starting
scyther-gui.py
Some protocol description files (with extension .spdl) can be found in
the base directory. Many other protocol input files can be found in the
'Protocols' directory.