Skip to content
This repository has been archived by the owner on Dec 13, 2021. It is now read-only.

Commit

Permalink
Release v0.1.1
Browse files Browse the repository at this point in the history
 * rewrite orchestrator in golang
 * netfilter-based inspector
 * MongoDB event history storage
  • Loading branch information
AkihiroSuda committed Aug 20, 2015
1 parent 0d48986 commit fa63aa1
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 5 deletions.
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,17 @@ Earthquake is a dynamic model checker (DMCK) for real implementations of distrib
[http://osrg.github.io/earthquake/](http://osrg.github.io/earthquake/)

Earthquakes permutes C/Java function calls, Ethernet packets, and injected fault events in various orders so as to find implementation-level bugs of the distributed system.
When Earthquake finds a bug, Earthquake automatically records [the event history](example/zk-found-bug.ryu_pyeq/example-output/3.REPRODUCED/json) and helps you to analyze which permutation of events triggers the bug.
When Earthquake finds a bug, Earthquake automatically records [the event history](example/zk-found-2212.ryu) and helps you to analyze which permutation of events triggers the bug.

Basically, Earthquake permutes events in a random order, but you can write your [own state exploration policy](doc/arch.md) (in Go or Python) for finding deep bugs efficiently.

## News
We have successfully found a distributed race condition bug of ZooKeeper using Earthquake.
* Earthquake will be presented at the poster session of [ACM Symposium on Cloud Computing (SoCC)](http://acmsocc.github.io/2015/). (August 27-29, 2015, Hawaii)
* We have successfully found a distributed race condition bug of ZooKeeper using Earthquake.
Please refer to [example/zk-found-2212.ryu](example/zk-found-2212.ryu) for further information.

## Quick Start
NOTE: [v0.1](https://github.com/osrg/earthquake/releases/tag/v0.1) might be stabler than the master branch.
NOTE: [v0.1.1](https://github.com/osrg/earthquake/releases/tag/v0.1.1) might be stabler than the master branch.

* How to set up the environment: [doc/how-to-setup-env.md](doc/how-to-setup-env.md)
* Example: Finding a distributed race condition bug of ZooKeeper([ZOOKEEPER-2212](https://issues.apache.org/jira/browse/ZOOKEEPER-2212)): [example/zk-found-2212.ryu](example/zk-found-2212.ryu)
Expand Down
2 changes: 1 addition & 1 deletion inspector/java/base/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<groupId>net.osrg</groupId>
<artifactId>earthquake</artifactId>
<version>0.0.1</version>
<version>0.1.1</version>
<packaging>jar</packaging>

<name>Earthquake Inspector (Java)</name>
Expand Down
2 changes: 1 addition & 1 deletion libearthquake/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ import (
)

func main() {
c := cli.NewCLI("earthquake", "0.0.0")
c := cli.NewCLI("earthquake", "0.1.1")
c.Args = os.Args[1:]
c.Commands = map[string]cli.CommandFactory{
"tools": toolsCommandFactory,
Expand Down

0 comments on commit fa63aa1

Please sign in to comment.