From 72b659cb728b1f549c49b40d37f59b870f006fac Mon Sep 17 00:00:00 2001 From: Simon Tatham Date: Sun, 9 Aug 2015 21:18:27 +0100 Subject: [PATCH] Add a FAQ for 'checksum mismatch' reports. The aim is to try to reduce the incidence of the two least helpful classes of those reports: the ones which have just got mismatched checksum files, and the ones which don't tell us the information that would help. (cherry picked from commit 8ff3b222430cea48500cabdf402efe1f459f9ae4) --- doc/faq.but | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/faq.but b/doc/faq.but index 72d03b92..e2e23742 100644 --- a/doc/faq.but +++ b/doc/faq.but @@ -1490,6 +1490,38 @@ suppliers so that it clearly distinguishes paid vendors who know about you from free software developers who don't have any idea who you are. Then, only send out these mass mailings to the former. +\S{faq-checksums}{Question} The \c{sha1sums} / \c{sha256sums} / etc +files on your download page don't match the binaries. + +People report this every so often, and usually the reason turns out to +be that they've matched up the wrong checksums file with the wrong +binaries. + +The PuTTY download page contains more than one version of the +software. There's a \e{latest release} version; there are the +\e{development snapshots}; and when we're in the run-up to making a +release, there are also \e{pre-release} builds of the upcoming new +version. Each one has its own collection of binaries, and its own +collection of checksums files to go with them. + +So if you've downloaded the release version of the actual program, you +need the release version of the checksums too, otherwise you will see +a mismatch. Similarly, the development snapshot binaries go with the +development snapshot checksums, and so on. (We've colour-coded the +download page in an effort to reduce this confusion a bit.) + +If you have double-checked that, and you still think there's a real +mismatch, then please send us a report carefully quoting everything +relevant: + +\b the exact URL you got your binary from + +\b the checksum of the binary after you downloaded + +\b the exact URL you got your checksums file from + +\b the checksum that file says the binary should have. + \H{faq-misc} Miscellaneous questions \S{faq-openssh}{Question} Is PuTTY a port of \i{OpenSSH}, or based on -- 2.45.2