[gentoo-commits] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-stage.xml

["Sven Vermeulen (swift)" <swift@gentoo.org>]

swift       12/10/06 19:49:19

  Modified:             hb-install-stage.xml
  Log:
  Fix bug #386475 - Use SHA512 and Whirlpool checksums for all arches except mips

Revision  Changes    Path
1.125                xml/htdocs/doc/en/handbook/hb-install-stage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.125&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.125&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml?r1=1.124&r2=1.125

Index: hb-install-stage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v
retrieving revision 1.124
retrieving revision 1.125
diff -u -r1.124 -r1.125
--- hb-install-stage.xml	24 Jul 2012 12:12:52 -0000	1.124
+++ hb-install-stage.xml	6 Oct 2012 19:49:18 -0000	1.125
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.124 2012/07/24 12:12:52 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.125 2012/10/06 19:49:18 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 describe how you extract the stage3 archive and configure Portage.
 </abstract>
 
-<version>12</version>
-<date>2012-07-24</date>
+<version>13</version>
+<date>2012-10-06</date>
 
 <section>
 <title>Installing a Stage Tarball</title>
@@ -146,15 +146,27 @@
 
 <p>
 If you want to check the integrity of the downloaded stage tarball, use
-<c>md5sum</c> and compare the output with the MD5 checksum provided on the
-mirror.
+<c>openssl</c> and compare the output with the checksums provided on the
+mirror. The digests files provide several checksums, each taken with a different
+algorithm. The recommended ones are SHA512 and Whirlpool.
 </p>
 
-<pre caption="Checking integrity of a stage tarball">
-# <i>md5sum -c <keyval id="stage3"/>.DIGESTS</i>
-<keyval id="stage3"/>: OK
+<pre caption="Calculating the integrity checksum of a stage tarball">
+<comment>## Calculating the SHA512 checksum</comment>
+# <i>openssl dgst -r -sha512 <keyval id="stage3" /></i>
+<comment>or</comment>
+# <i>sha512sum <keyval id="stage3" /></i>
+
+<comment>## Calculating the Whirlpool checksum</comment>
+# <i>openssl dgst -r -whirlpool <keyval id="stage3" /></i>
 </pre>
 
+<p>
+Then compare the output of these commands with the value registered in the
+.DIGESTS files that can be found on the mirrors as well. The values need to
+match, otherwise the downloaded file might be corrupt (or the digests file is).
+</p>
+
 </body>
 </subsection>
 <subsection>