aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/explanations.html
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--explanations.html60
1 files changed, 60 insertions, 0 deletions
diff --git a/explanations.html b/explanations.html
new file mode 100644
index 0000000..5ce0376
--- /dev/null
+++ b/explanations.html
@@ -0,0 +1,60 @@
1<html><head><title>apt-panopticon explanations</title>
2</head><body bgcolor="black" text="white"><h1>Welcome to the apt-panopticon explanations page.</h1>
3<p>The purpose of this page is to try to explain everything shown on <a href="results/Report-web.html">the results page</a>,
4so that the results page can link to the various parts for the curious.<p>
5
6<hr><h1 id="IPv4">IPV4 tests</h1>
7<p>Tests are tested over IPv4 if the mirror has IPv4 addresses.</p>
8
9<hr><h1 id="IPv6">IPv6</h1>
10<p>Tests are tested over IPv6 if the mirror has IPv6 addresses.</p>
11
12<hr><h1 id="FTP">FTP tests</h1>
13<p>The FTP tests have not been written yet.</p>
14
15<hr><h1 id="HTTP">HTTP tests</h1>
16<p>
17</p>
18
19<hr><h1 id="HTTPS">HTTPS tests</h1>
20<p>
21</p>
22
23<hr><h1 id="RSYNC">rsync tests</h1>
24<p>The RSYNC tests have not been written yet.</p>
25
26<hr><h1 id="DNS-RR">DNS round robin tests</h1>
27<p>The "DNS round robin" column lists the IP addresses for each mirror that is part of the DNS round robin, or DNS-RR. &nbsp;
28The IPs are linked to the log for that specific IP when used via the DNS round robin, and is followed by the number of errors, warnings, or timeouts of any.
29</p>
30
31<hr><h1 id="Protocol">Protocol tests</h1>
32<p>The Protocol test will give a warning if the protocol is changed during a redirect, HTTP -> HTTPS for example. &nbsp;
33While apt HTTPS transport is now the default in Beowulf / Buster, not everyone with an older release will have that installed,
34so redirecting HTTP to HTTPS will break apt for those people. &nbsp;
35An error is given instead if that happens for mirrors in the DNS round robin. &nbsp;
36Servers in the DNS round robin will not have the HTTPS certificate for the round robin domain, so redirecting to HTTPS for that is a mistake.
37</p>
38
39<hr><h1 id="URL-Sanity">URL sanity tests</h1>
40<p>The URL sanity test replaces "/" in URLS with "///", to see if the mirror can cope with that. &nbsp;
41This might happen due to a mis configuration by the apt user, but decent web servers should cope with that. &nbsp;
42The result for a mirror that does not cope is a failed download for that use, so this is an error.
43</p>
44
45<hr><h1 id="Integrity">Integrity tests</h1>
46<p></p>
47
48<hr><h1 id="Updated">Updated tests</h1>
49<p></p>
50
51<hr><h1 id="Speed">Speed test</h1>
52<p>The speed test tries to guess at a minimum and maximum speed range for each mirror. &nbsp;
53It does this by measuring the reported speeds from the curl commands that actually download files. &nbsp;
54Since apt-panopticon is trying hard to download everything from all mirrors all at the same time, this guess will be low. &nbsp;
55Also, the computer running the apt-panopticon might have a network connection that is busy with other things. &nbsp;
56Finally, the tested mirror may have a bigger network connection than the computer running the test, so wont show it's true maximum. &nbsp;
57So take this speed measurement with a grain of salt, it's more of an indication, the <a href="apt-panopticon_cgp/index.php">full graphs</a> might be useful.
58</p>
59
60</body></html>