commit 508d3bccedc56af6559bcb5e367172dffec73a05
Author: Ana Custura <a...@netstat.org.uk>
Date: Thu Jul 2 10:02:47 2020 +0100
Minor spelling, adds TOC
---
README.md | 26 ++++++++++++++++++++++----
1 file changed, 22 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index 9f0faf4..b66d6bc 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,30 @@
# OnionPerf
-
-[TOC]
+ * [Overview](#overview)
+ + [What does OnionPerf do?](#what-does-onionperf-do-)
+ + [What does OnionPerf *not* do?](#what-does-onionperf--not--do-)
+ * [Installation](#installation)
+ + [Tor](#tor)
+ + [TGen](#tgen)
+ + [OnionPerf](#onionperf-1)
+ * [Measurement](#measurement)
+ + [Starting and stopping measurements](#starting-and-stopping-measurements)
+ + [Output directories and files](#output-directories-and-files)
+ + [Changing Tor configurations](#changing-tor-configurations)
+ + [Changing the TGen traffic model](#changing-the-tgen-traffic-model)
+ + [Sharing measurement results](#sharing-measurement-results)
+ + [Troubleshooting](#troubleshooting)
+ * [Analysis](#analysis)
+ + [Analyzing measurement results](#analyzing-measurement-results)
+ + [Visualizing measurement results](#visualizing-measurement-results)
+ + [Interpreting the PDF output format](#interpreting-the-pdf-output-format)
+ + [Interpreting the CSV output format](#interpreting-the-csv-output-format)
+ * [Contributing](#contributing)
## Overview
### What does OnionPerf do?
-OnionPerf measures performance of bulk file downloads over Tor. Together with
its predecessor, Torperf, Onionperf has been used to measure long-term
performance trends in the Tor network since 2009. It is also being used to
perform short-term performance experiments to compare different Tor
configurations or implementations.
+OnionPerf measures performance of bulk file downloads over Tor. Together with
its predecessor, Torperf, OnionPerf has been used to measure long-term
performance trends in the Tor network since 2009. It is also being used to
perform short-term performance experiments to compare different Tor
configurations or implementations.
OnionPerf uses multiple processes and threads to download random data through
Tor while tracking the performance of those downloads. The data is served and
fetched on localhost using two TGen (traffic generator) processes, and is
transferred through Tor using Tor client processes and an ephemeral Tor onion
service. Tor control information and TGen performance statistics are logged to
disk and analyzed once per day to produce a JSON analysis file that can later
be used to visualize changes in Tor client performance over time.
@@ -180,7 +198,7 @@ For example, the hard-coded traffic model generated by
OnionPerf and executed by
### Sharing measurement results
-Measurement results can be further analyzed and visualized on the measuring
host. But in many cases it's more conventient to do analysis and visualization
on another host, also to compare measurements from different hosts to each
other.
+Measurement results can be further analyzed and visualized on the measuring
host. But in many cases it's more convenient to do analysis and visualization
on another host, also to compare measurements from different hosts to each
other.
There are at least two common ways of sharing measurement results:
_______________________________________________
tor-commits mailing list
tor-commits@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits
