Commit 508d3bcc authored by Ana Custura's avatar Ana Custura
Browse files

Minor spelling, adds TOC

parent 145c9d1c
# 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:
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment