|
|
@@ -27,12 +27,12 @@ This repository has three important branches:
|
|
|
- [main](https://git-crysp.uwaterloo.ca/vvecna/lox-troll-patrol-extension), which contains our modified code.
|
|
|
- [lox-original](https://git-crysp.uwaterloo.ca/vvecna/lox-troll-patrol-extension/src/lox-original), which contains the Lox code from the original Lox paper, with only minimal changes of ours, to allow us to collect the necessary benchmarks.
|
|
|
|
|
|
-The [generate-lox-results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/scripts/generate-lox-results.sh) script runs various testing functions for each branch. These functions' names all begin with **stats_test**, and they can be found in the following files:
|
|
|
+The [generate-lox-results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/scripts/generate-lox-results.sh) script runs various testing functions for each branch. These functions' names all begin with **stats_test**, and the functions' definitions can be found in the following files:
|
|
|
- On branch "lox-extension": [src/main/crates/lox-extensions/src/stats_tests.rs](https://git-crysp.uwaterloo.ca/vvecna/lox-troll-patrol-extension/src/lox-extension/crates/lox-extensions/src/stats_tests.rs)
|
|
|
- On branch "main": [src/main/crates/lox-extensions/src/stats_tests.rs](https://git-crysp.uwaterloo.ca/vvecna/lox-troll-patrol-extension/src/main/crates/lox-extensions/src/stats_tests.rs)
|
|
|
- On branch "lox-original": [src/tests.rs](https://git-crysp.uwaterloo.ca/vvecna/lox-troll-patrol-extension/src/lox-original/src/tests.rs)
|
|
|
|
|
|
-The results are parsed by the [profess-lox-results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/scripts/process-lox-results.sh) script, which runs the [get_results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/parsing-results/get_results.sh) script and produces a .tex file and a corresponding .pdf file for each branch:
|
|
|
+The results are parsed by the [process-lox-results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/scripts/process-lox-results.sh) script, which runs the [get_results.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/parsing-results/get_results.sh) script and produces a .tex file and a corresponding .pdf file for each branch:
|
|
|
- Branch "lox-extension": **table-2-results.tex** and **table-2-results.pdf** (containing Table 2 from our paper)
|
|
|
- Branch "main": **table-3-results.tex** and **table-3-results.pdf** (containing Table 3 from our paper)
|
|
|
- Branch "lox-original": **appendix-c-results.tex** and **appendix-c-results.pdf** (containing Table 5 from Appendix C of our paper)
|
|
|
@@ -48,7 +48,7 @@ The main analysis orchestration script (which is run after downloading the Tor M
|
|
|
2. Run [get-stats.py](https://git-crysp.uwaterloo.ca/vvecna/belarus-2020-2021/src/main/scripts/get-stats.py) to create Table 4 (contained in the file **appendix-a-results.tex**) from the results of step 1. This script also computes the mean and standard deviation of each email-distributed obfs4 bridge's daily connection counts, as well as these measurements for each pair of these bridges.
|
|
|
3. Compile **appendix-a-results.tex** to get **appendix-a-results.pdf**.
|
|
|
4. Parse the relevant data (number of bridges/pairs of bridges that received a certain number of connections on a single day, number of bridges/pairs of bridges with connection count mean more than 1 standard deviation from 0, maximum number of standard deviations from 0) from the data produced in step 2.
|
|
|
-5. Run [get-stats-non-obfs4-email.py](https://git-crysp.uwaterloo.ca/vvecna/belarus-2020-2021/src/main/scripts/get-stats-non-obfs4-email.py), which computes and outputs the number of bridges that either were not distributed via email or did not report supporting obfs4, which received at least *n* connections from Belarus on some day for a range of *n* values. (This demonstrates a point that there *were* bridges that were popular in Belarus, but the email-distributed obfs4 bridges that were blocked were not the popular bridges.)
|
|
|
+5. Run [get-stats-non-obfs4-email.py](https://git-crysp.uwaterloo.ca/vvecna/belarus-2020-2021/src/main/scripts/get-stats-non-obfs4-email.py), which computes and outputs the number of bridges that either were not distributed via email or did not report supporting obfs4, which received at least *n* connections from Belarus on some day for a range of *n* values. (This demonstrates that there *were* bridges that were popular in Belarus, but the email-distributed obfs4 bridges that were blocked were not the popular bridges.)
|
|
|
|
|
|
This repository is used to produce the following files:
|
|
|
- **appendix-a-results** (which contains the output of the **get-stats.sh** script; see [belarus.sh](https://git-crysp.uwaterloo.ca/vvecna/troll-patrol-artifact/src/main/scripts/belarus.sh#L45))
|
