Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
wangvsa authored Nov 29, 2021
1 parent f316c79 commit 495ef1c
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions tools/verifyio/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,22 @@ Dependencies: `recorder-viz` and `networkx`. Both can be installed using pip.
Steps:
1. Run program with Recorder to generate traces.
2. Run the conflict detector to report **potential** conflicting I/O accesses.
Those acesses are only potentially conflicting as here we do not take MPI communication into consideration yet.
Those acesses are only potentially conflicting as here we do not take happens-before order into consideration yet.

`$RECORDER_DIR/bin/conflict_detector /path/to/traces --semantics=posix`

This command will write all conflicts found to the file `/path/to/traces/conflicts.txt`
The `semantics` option needs to match the one provided by the underlying file system. For example, if the traces were collected on UnifyFS, set it to "commit".

3. Finally run the verification code, which checks if those conflicting operations are properly synchronzied.
This command will write all potential conflicts found to the file `/path/to/traces/conflicts.txt`

`python ./verifyio.py /path/to/traces /path/to/traces/conflicts.txt`
3. Finally run the verification code, which checks if those potential conflicting operations are properly synchronzied.

```python
python ./verifyio.py -h # print out usage

#Example:
python ./verifyio.py /path/to/traces /path/to/traces/conflicts.txt --semantics=mpi
```



Expand Down

0 comments on commit 495ef1c

Please sign in to comment.