Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 441104 - Handbook: Digest handling is confusing
Summary: Handbook: Digest handling is confusing
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-11-03 05:54 UTC by Jason Bucata
Modified: 2012-11-05 05:37 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jason Bucata 2012-11-03 05:54:49 UTC
So I go and download the stage3 from:
http://distfiles.gentoo.org/releases/amd64/autobuilds/current-stage3/

I manage to do the GPG validation.  Then the Handbook says in Code Listing 3.2:

(Verify the checksum)
$ sha1sum -c <downloaded iso.DIGESTS.asc>

I used this command and got the message: "no properly formatted SHA1 checksum lines found"

Somebody on IRC said that I probably need to use sha512sum instead.  So I tried that, and it worked, sort of:
stage3-amd64-20121013.tar.bz2: OK
stage3-amd64-20121013.tar.bz2: FAILED
[omitting remaining output]

Apparently it verified the file against the SHA512 hash then did it again against the Whirlpool hash, which failed.

So the command currently printed in the Handbook doesn't work at all.  The obvious replacement is a little better, but someone who's not sophisticated enough to guess what's going on might panic at the "FAILED" line.
Comment 1 Jason Bucata 2012-11-03 07:39:15 UTC
After going through some more I see that the section where it talks about stage3 tarballs does in fact mention the new command sha512sum.  And it mentions that you have to compare to the digest file yourself.

I do find it a bit confusing that different options are used whether it's an ISO vs. a tarball, but nevertheless this is probably tolerable.

I do have a small request, though, that maybe a shell script could be provided to do something equivalent to the -c option that used to work.

But beyond that, sorry for the bother. :-|
Comment 2 nm (RETIRED) gentoo-dev 2012-11-05 05:37:53 UTC
they use different hash schemes last i checked, which is why the instructions differ. glad you found 'em, though. :)