aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/explanations.html
diff options
context:
space:
mode:
authoronefang2019-12-26 17:34:48 +1000
committeronefang2019-12-26 17:34:48 +1000
commit91dc5f5bfec4cf8ab15c57026019475693eb2fda (patch)
treed5a036fd9b92705363e462af4241d4e0403b6fe3 /explanations.html
parentHopefully properly link out of explanations.html. (diff)
downloadapt-panopticon-91dc5f5bfec4cf8ab15c57026019475693eb2fda.zip
apt-panopticon-91dc5f5bfec4cf8ab15c57026019475693eb2fda.tar.gz
apt-panopticon-91dc5f5bfec4cf8ab15c57026019475693eb2fda.tar.bz2
apt-panopticon-91dc5f5bfec4cf8ab15c57026019475693eb2fda.tar.xz
Complete the explanations.html text.
Diffstat (limited to 'explanations.html')
-rw-r--r--explanations.html28
1 files changed, 23 insertions, 5 deletions
diff --git a/explanations.html b/explanations.html
index f48acc1..a101a08 100644
--- a/explanations.html
+++ b/explanations.html
@@ -13,11 +13,24 @@ so that the results page can link to the various parts for the curious.<p>
13<p>The FTP tests have not been written yet.</p> 13<p>The FTP tests have not been written yet.</p>
14 14
15<hr><h1 id="HTTP">HTTP tests</h1> 15<hr><h1 id="HTTP">HTTP tests</h1>
16<p> 16<p>There are two styles of HTTP tests - actual HTTP downloads and HTTP HEAD tests. &nbsp;
17Actual downloads happen when other tests need the files to be downloaded. &nbsp;
18HEAD tests are where apt-panopticon probes things in detail. &nbsp;
19For each mirror (including the DNS round robin domain), and for each IP of that mirror -
17</p> 20</p>
21<ul>
22<li>Chose a small collection of package files to test, and the Release files for each release.</li>
23<li>Send a HTTP HEAD request for each of those files.</li>
24<li>Carefully inspect and log the response.</li>
25<li>Retry the request if needed, and log that.</li>
26<li>If a redirect loop is detected, log that and give up.</li>
27<li>If the mirror replies with a redirect to the same mirror, then try that and keep checking.</li>
28<li>If the mirror replies with a redirect to a different server, then probe that mirror the same way.</li>
29</ul>
18 30
19<hr><h1 id="HTTPS">HTTPS tests</h1> 31<hr><h1 id="HTTPS">HTTPS tests</h1>
20<p> 32<p>The HTTPS tests are very similar to the HTTP tests detailed above, though obviously they are tried with HTTPS requests intead of HTTP requests. &nbsp;
33The validity of the HTTPS certificate for each server is tested as well.
21</p> 34</p>
22 35
23<hr><h1 id="RSYNC">rsync tests</h1> 36<hr><h1 id="RSYNC">rsync tests</h1>
@@ -38,15 +51,20 @@ Servers in the DNS round robin will not have the HTTPS certificate for the round
38 51
39<hr><h1 id="URL-Sanity">URL sanity tests</h1> 52<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; 53<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; 54This might happen due to a minor 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. 55The result for a mirror that does not cope is a failed download for that use, so this is an error.
43</p> 56</p>
44 57
45<hr><h1 id="Integrity">Integrity tests</h1> 58<hr><h1 id="Integrity">Integrity tests</h1>
46<p></p> 59<p>Actually download files, then check things like PGP keys, SHA256 check sums, and file size. &nbsp;
60For actual packages, pick the smallest one that has been recently updated.
61</p>
47 62
48<hr><h1 id="Updated">Updated tests</h1> 63<hr><h1 id="Updated">Updated tests</h1>
49<p></p> 64<p>Make sure the Release files are up to date by checking their internal "Date" field. &nbsp;
65If they are up to date, download and check updated Packages.xz files, and actual packages. &nbsp;
66For actual packages, pick the smallest one that has been recently updated.
67</p>
50 68
51<hr><h1 id="Speed">Speed test</h1> 69<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; 70<p>The speed test tries to guess at a minimum and maximum speed range for each mirror. &nbsp;