cvs commit: BLFS/BOOK/x/installing/xfree86 xfree86-exp.xml xfree86-inst.xml xfree86-intro.xml

tushar at linuxfromscratch.org tushar at linuxfromscratch.org
Thu Feb 19 21:16:24 PST 2004


tushar      04/02/19 22:16:24

  Modified:    BOOK/introduction/important unpacking.xml
               BOOK/x/installing/xfree86 xfree86-exp.xml xfree86-inst.xml
                        xfree86-intro.xml
  Log:
  Moved md5sum verification and log creation from xfree86 section to the introduction
  
  Revision  Changes    Path
  1.8       +37 -1     BLFS/BOOK/introduction/important/unpacking.xml
  
  Index: unpacking.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/introduction/important/unpacking.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -u -r1.7 -r1.8
  --- unpacking.xml	4 Oct 2003 14:23:38 -0000	1.7
  +++ unpacking.xml	20 Feb 2004 05:16:24 -0000	1.8
  @@ -1,6 +1,6 @@
   <sect1 id="intro-important-unpacking">
   <?dbhtml filename="unpacking.html" dir="introduction"?>
  -<title>Getting and unpacking the software</title>
  +<title>Notes on downloading, unpacking and compiling software</title>
   
   <para>Those people who have built a <acronym>LFS</acronym> system will be aware 
   of the general principles of downloading and unpacking software.  We will
  @@ -49,6 +49,42 @@
   
   <screen><command>gunzip patchname.gz
   bunzip2 patchname.bz2</command></screen>
  +
  +</sect2>
  +
  +<sect2>
  +<title>Verifying file integrity using md5sum</title>
  +
  +<para>Generally, to verify that the downloaded file is genuine and complete,
  +most package maintainers also distribute md5sums of the files.
  +To verify the md5sum of the downloaded files, download both the file and the
  +corresponding md5sum file to the same directory (preferably from different
  +on-line locations), and (assuming file.md5sum is the md5sum file downloaded)
  +run the following command:</para>
  +
  +<screen><command>md5sum -c file.md5sum</command></screen>
  +
  +<para>If there are any errors, they will be reported.</para>
  +
  +</sect2>
  +
  +<sect2>
  +<title>Creating Log files during installation</title>
  +
  +<para>For larger packages, it is convenient to create log files instead of
  +staring at the screen hoping to catch a particular error or warning. Log files
  +are also useful for debugging and keeping records. The following command
  +allows you to create a installation log. Replace <command> with the
  +command you intend to execute.</para>
  +
  +<screen><command>( <command> 2>&1 | tee compile.log && exit $PIPESTATUS )</command></screen>
  +
  +<para><parameter>2>&1</parameter> redirects error messages
  +to the same location as normal output. The <command>tee</command> command
  +allows viewing of the output while logging the results to a file. The parentheses
  +around the command run the entire command in a subshell and finally the
  +<command>exit $PIPESTATUS</command> ensures the result of the <command>
  +is returned as the result and not the result of the <command>tee</command> command.</para>
   
   </sect2>
   
  
  
  
  1.10      +6 -0      BLFS/BOOK/x/installing/xfree86/xfree86-exp.xml
  
  Index: xfree86-exp.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/x/installing/xfree86/xfree86-exp.xml,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -u -r1.9 -r1.10
  --- xfree86-exp.xml	14 Feb 2004 21:01:53 -0000	1.9
  +++ xfree86-exp.xml	20 Feb 2004 05:16:24 -0000	1.10
  @@ -1,6 +1,7 @@
   <sect2>
   <title>Command explanations</title>
   
  +<!--
   <para><command>( WORLDOPTS="" make World 2>&1 | tee xfree-compile.log 
      && exit $PIPESTATUS )</command>: 
   This command runs multiple makefiles to completely rebuild the system. 
  @@ -11,6 +12,11 @@
   around the command run the entire comand in a subshell and finally the 
   <command>exit $PIPESTATUS</command> ensures the result of the <command>make</command>
   is returned as the result and not the result of the <command>tee</command> command.</para>
  +-->
  +<para><command>WORLDOPTS="" make World</command>: 
  +This command runs multiple makefiles to completely rebuild the system. 
  +<envar>WORLDOPTS</envar>="" disables the default setting to continue after 
  +encountering an error.</para>
   
   <note><para>When rebuilding <application>XFree86</application>, a separate command that may be used if only minor 
   changes are made to the sources is <command>make 
  
  
  
  1.25      +1 -1      BLFS/BOOK/x/installing/xfree86/xfree86-inst.xml
  
  Index: xfree86-inst.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/x/installing/xfree86/xfree86-inst.xml,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -u -r1.24 -r1.25
  --- xfree86-inst.xml	14 Feb 2004 21:01:53 -0000	1.24
  +++ xfree86-inst.xml	20 Feb 2004 05:16:24 -0000	1.25
  @@ -205,7 +205,7 @@
   <para>Install <application>XFree86</application> by running the following commands:</para>
   
   
  -<screen><userinput><command>( WORLDOPTS="" make World 2>&1 | tee xfree-compile.log && exit $PIPESTATUS ) &&
  +<screen><userinput><command>WORLDOPTS="" make World &&
   make install &&
   make install.man &&
   ln -sf /usr/X11R6/bin /usr/bin/X11 &&
  
  
  
  1.21      +2 -0      BLFS/BOOK/x/installing/xfree86/xfree86-intro.xml
  
  Index: xfree86-intro.xml
  ===================================================================
  RCS file: /home/cvsroot/BLFS/BOOK/x/installing/xfree86/xfree86-intro.xml,v
  retrieving revision 1.20
  retrieving revision 1.21
  diff -u -u -r1.20 -r1.21
  --- xfree86-intro.xml	14 Feb 2004 21:01:53 -0000	1.20
  +++ xfree86-intro.xml	20 Feb 2004 05:16:24 -0000	1.21
  @@ -71,6 +71,7 @@
   and <application>zlib</application> which are already installed on an
   <acronym>LFS</acronym> system.</para>
   
  +<!--
   <para>To check your downloads for integrity, download the <filename>SUMS.md5sum</filename>
   file.  Then:</para>
   
  @@ -86,6 +87,7 @@
   check against the patch files:</para>
   <screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
   <userinput><command>md5sum fontfile.diff</command></userinput></screen>
  +-->
   
   <para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the 
   diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
  
  
  



More information about the blfs-book mailing list