[blfs-book] r11837 - in tags/7.4: . archive book general/sysutils introduction/welcome postlfs/security x/installing

bdubbs at higgs.linuxfromscratch.org bdubbs at higgs.linuxfromscratch.org
Fri Sep 13 12:50:40 PDT 2013


Author: bdubbs
Date: Fri Sep 13 12:50:39 2013
New Revision: 11837

Log:
BLFS-7.4

Added:
   tags/7.4/
      - copied from r11834, trunk/BOOK/
Replaced:
   tags/7.4/general.ent
      - copied, changed from r11836, trunk/BOOK/general.ent
   tags/7.4/general/sysutils/sysstat.xml
      - copied unchanged from r11835, trunk/BOOK/general/sysutils/sysstat.xml
   tags/7.4/introduction/welcome/changelog.xml
      - copied, changed from r11836, trunk/BOOK/introduction/welcome/changelog.xml
   tags/7.4/postlfs/security/openssh.xml
      - copied unchanged from r11835, trunk/BOOK/postlfs/security/openssh.xml
   tags/7.4/x/installing/xorg-server.xml
      - copied unchanged from r11836, trunk/BOOK/x/installing/xorg-server.xml
Deleted:
   tags/7.4/archive/
Modified:
   tags/7.4/book/bookinfo.xml
   tags/7.4/book/dedication.xml
   tags/7.4/book/errata.xml
   tags/7.4/book/foreword.xml
   tags/7.4/book/preface.xml
   tags/7.4/index.xml

Modified: tags/7.4/book/bookinfo.xml
==============================================================================
--- trunk/BOOK/book/bookinfo.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/book/bookinfo.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -44,7 +44,7 @@
     <revision>
       <revnumber>&version;</revnumber>
       <date>&pubdate;</date>
-      <revremark>Ongoing Release</revremark>
+      <revremark>Eighth Release</revremark>
     </revision>
 
     <revision>

Modified: tags/7.4/book/dedication.xml
==============================================================================
--- trunk/BOOK/book/dedication.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/book/dedication.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -13,6 +13,6 @@
 <dedication>
   <title>Dedication</title>
 
-  <para>This book is dedicated to the LFS community</para>
+  <para>This release is dedicated to Andy Benton.  May he rest in peace.</para>
 
 </dedication>

Modified: tags/7.4/book/errata.xml
==============================================================================
--- trunk/BOOK/book/errata.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/book/errata.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -24,4 +24,9 @@
   any changes shown and apply them to the relevant section of the book as you
   progress with building the applications in BLFS.</para>
 
+  <para>If you do run into a problem, a good place to look for solutions is the
+  <ulink url="http://www.linuxfromscratch.org/blfs/view/svn/">development
+  version of the book</ulink>.  This is where additions of new packages,  
+  updates of package versions, and corrections are made on a daily basis.</para>
+
 </sect1>

Modified: tags/7.4/book/foreword.xml
==============================================================================
--- trunk/BOOK/book/foreword.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/book/foreword.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -5,135 +5,51 @@
   %general-entities;
 ]>
 
-<sect1 id="foreword" xreflabel="Foreword">
+<preface id="foreword" xreflabel="Foreword">
   <?dbhtml filename="foreword.html"?>
 
-  <sect1info>
+  <prefaceinfo>
     <othername>$LastChangedBy$</othername>
     <date>$Date$</date>
-  </sect1info>
+  </prefaceinfo>
 
   <title>Foreword</title>
 
-  <!--
-  <para>Version 6.0 is a major milestone in the evolution of BLFS.  This
-  version provides installation instructions for 357 packages and an additional
-  21 sections covering configuration and customization of different aspects
-  of your system.</para>
-
-  <para>Changes and upgrades to the individual packages are detailed in the
-  <xref linkend="changelog"/>.  There you will see literally hundreds of
-  changes made since the last edition.  In this change log, one name that you
-  will see over and over is Randy McMurchy.  Without his efforts this
-  release would not have been possible.  I want to take this opportunity to thank
-  him for the hundreds of hours he has worked to produce this release.  I
-  also want to thank the other editors, both past and present, whose insight
-  and effort have made this current version possible.  Last, but certainly not least,
-  I want to thank our resident XSL wizard, Manuel Canales Esparcia, whose
-  ability to format a complicated document such as BLFS is truly amazing.</para>
-
-  <para>There are two other areas of change that are worthy of note.  First,
-  the license that BLFS is released under has changed significantly.  In
-  fact, it is now released under two licenses.  The first license, the
-  <xref linkend="CC"/>, covers the descriptive text in the book. The second, the
-  <xref linkend="AFL"/>, covers the instructions actually used to build and
-  install the packages.  These licenses, along with the book itself, represent
-  our ongoing commitment to open and free software.</para>
-
-  <para>The final area of change is the addition of an Index.  This section of
-  the book is still incomplete, but as the book continues to be developed,
-  will become an excellent resource for finding programs, libraries,
-  configuration files, and references to kernel configuration requirements.  I
-  hope you find it useful.</para>
+  <para>After five years, The BLFS Team is happy to present version 7.4 of
+  Beyond Linx From Scratch.  This version includes approximately 750 
+  packages beyond the base Linux From Scratch Version 7.4 book.</para>
+
+  <para>Keeping up to date with released packages that are useful to users is a
+  challenge.  On average, three new packages are released every day, seven days
+  a week.  As of this writing, BLFS is current.  The vast majority of packages
+  in the book have been verified ot work in an LFS-7.4 environment, however a
+  few (26) packages have only been built and not tested primarily due to
+  hardware constraints.</para>
+
+  <para>This release would not have been possible without the help of
+  a lot of people over the years.  Sepcific thanks for the many hours 
+  spent making BLFS what it is goes to the following:</para>
+
+  <itemizedlist>
+  <title> </title>
+  <listitem><para>Andy Benton</para></listitem>
+  <listitem><para>Wayne Blaszczyk</para></listitem>
+  <listitem><para>Guy Dalziel</para></listitem>
+  <listitem><para>Ag Hatzimanikas</para></listitem>
+  <listitem><para>Armin Krejzi</para></listitem>
+  <listitem><para>DJ Lucas</para></listitem>
+  <listitem><para>Randy McMurchy</para></listitem>
+  <listitem><para>Ken Moffat</para></listitem>
+  <listitem><para>Fernando de Oliveria</para></listitem>
+  <listitem><para>Chris Staub</para></listitem>
+  <listitem><para>Ragnar Thomsen</para></listitem>
+  <listitem><para>Thomas Trepl</para></listitem>
+  <listitem><para>Igor Zivkovic</para></listitem>
+  </itemizedlist>
 
   <blockquote>
 <literallayout>Bruce Dubbs
-March 17, 2005</literallayout>
+September 13, 2013</literallayout>
   </blockquote>
 
-  <para>Version 6.1 is an incremental update of BLFS.  This version
-  continues the tradition of providing an extensive set of instructions for
-  extending a basic Linux From Scratch system. The instructions in this
-  version of BLFS are based on the LFS 6.1 Book.  As usual, the list of
-  packages that have been upgraded or added are in the
-  <xref linkend="changelog"/>.</para>
-
-  <para>One major accomplishment in this
-  version of the book is the completion of the Index.  This section
-  is now a relatively complete (but not perfect) reference for the components
-  of the various packages in the book.</para>
-
-  <para>In any task as large and complex as this book, there are bound to
-  be errors.  The editors of the book are dedicated to keeping the book up
-  to date.  We appreciate any feedback in helping us to make the book as
-  accurate as possible.  The best place to provide comments is via the
-  mailing list at <ulink url="mailto:blfs-dev@&lfs-domainname;"/>.</para>
-
-  <para>Enjoy!</para>
-
-  <blockquote>
-<literallayout>Bruce Dubbs
-August 1, 2005</literallayout>
-  </blockquote>
-
-  <para>Version 6.2.0 is the complement to the LFS 6.2 book. More time has
-  elapsed between the release of the previous version (6.1) and this one than
-  in any other release cycle. Much of this is due to the fact that LFS 6.2
-  took much longer to be released than was originally anticipated. Many new
-  packages have been introduced in the 6.2.0 version, as well as many
-  updates, refinements and additions to the existing packages.</para>
-
-  <para>The BLFS book now provides build and configuration instructions for
-  almost 400 packages. Some of the new packages introduced in this version are:
-  autotooled XOrg, HAL, D-BUS, GStreamer (now broken out into separate plugin
-  packages), usbutils, libquicktime, GraphViz, K3b, dvd+rw-tools, NSS, Libidn,
-  GAIM, Poppler, SeaMonkey, XChat, Audacious, cairo and unixODBC. Major updates
-  include GNOME-2.14.3 (with several new GNOME packages such as Totem,
-  gnome-mount and gnome-volume-manager), KDE-3.5.6, Firefox-1.5.x,
-  Thunderbird-1.5.x, and most of the mainline server packages. As always, the
-  list of packages that have been upgraded or added as well as configuration
-  and build command changes are annotated in the
-  <xref linkend="changelog"/>.</para>
-
-  <para>Unfortunately, BLFS activity was semi-stagnant for several months
-  after (and shortly before) the LFS 6.2 release. Therefore, many of the
-  packages are somewhat dated (compared to previous BLFS versions). This
-  brings us to why the versioning scheme has changed. This release is 6.2.0
-  as we fully anticipate releasing another version (6.2.1) just as soon as
-  possible. The 6.2.1 release will also be based on the LFS-6.2 book, but
-  will include updated packages, and fixes for any errors which may be
-  discovered in 6.2.0.</para>
-
-  <para>As always, the main thrust of BLFS development will be to support
-  the changes in the current LFS development book, but any changes or
-  updates to the BLFS development book (that are compatible with LFS 6.2)
-  will also be merged into the BLFS 6.2 branch. This way, a 6.2.1 version
-  of BLFS should be released fairly soon, and should provide a very current
-  and stable Linux platform.</para>
-
-  <para>Enjoy!</para>
-  -->
-
-  <para>This is the development version of the BLFS book. This version of the
-  book is intended to be used when building on top of a system built using the
-  LFS development book as well as the current stable version of LFS. Though this
-  version of the book is development in nature, every effort has been made to
-  ensure accuracy and reliability of the instructions. Many people find that
-  using the instructions in this book after building the current stable or
-  development version of LFS provides a stable and very modern Linux system.</para>
-
-  <!--
-  <para>If you have built LFS using a released version (the most recent being
-  LFS-6.3), then you probably don't want to use this version of BLFS, as
-  there could be incompatibilities. Instead, use the matching BLFS version
-  which should be available on all the mirrors.</para>
-  -->
-
-  <para>Enjoy!</para>
-
-  <blockquote>
-<literallayout>Randy McMurchy
-August 24th, 2008</literallayout>
-  </blockquote>
-
-</sect1>
+</preface>

Modified: tags/7.4/book/preface.xml
==============================================================================
--- trunk/BOOK/book/preface.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/book/preface.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -11,6 +11,7 @@
 <preface id="preface" xreflabel="Preface">
   <?dbhtml filename="preface.html" dir="preface"?>
 
+
   <title>Preface</title>
 
   <para>Having helped out with Linux From Scratch for a short time, I
@@ -118,9 +119,9 @@
 BLFS Editor (December 2006–January 2011)</literallayout>
   </blockquote>
 
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="foreword.xml"/>
+  <!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="foreword.xml"/>-->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="whoread.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="organization.xml"/>
-  <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="errata.xml"/> -->
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="errata.xml"/> 
 
 </preface>

Copied and modified: tags/7.4/general.ent (from r11836, trunk/BOOK/general.ent)
==============================================================================
--- trunk/BOOK/general.ent	Fri Sep 13 10:49:52 2013	(r11836, copy source)
+++ tags/7.4/general.ent	Fri Sep 13 12:50:39 2013	(r11837)
@@ -5,11 +5,11 @@
 <!ENTITY year         "2013">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
-<!ENTITY version      "&year;-&month;-&day;">
+<!ENTITY version      "7.4">
 <!ENTITY releasedate  "September 13th, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
-<!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
-<!ENTITY lfs-version  "development">          <!-- version|testing|unstable|development] -->
+<!ENTITY blfs-version "7.4">                  <!-- svn|[release #] -->
+<!ENTITY lfs-version  "7.4">          <!-- version|testing|unstable|development] -->
 <!ENTITY last-commit  "$Date$"> <!-- Automatic update -->
 <!ENTITY lfs-domainname       "linuxfromscratch.org">
 

Copied: tags/7.4/general/sysutils/sysstat.xml (from r11835, trunk/BOOK/general/sysutils/sysstat.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ tags/7.4/general/sysutils/sysstat.xml	Fri Sep 13 12:50:39 2013	(r11837, copy of r11835, trunk/BOOK/general/sysutils/sysstat.xml)
@@ -0,0 +1,277 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY sysstat-download-http "http://perso.wanadoo.fr/sebastien.godard/sysstat-&sysstat-version;.tar.bz2">
+  <!ENTITY sysstat-download-ftp  " ">
+  <!ENTITY sysstat-md5sum        "72e9d84efcbb366a988de09e958636e2">
+  <!ENTITY sysstat-size          "304 KB">
+  <!ENTITY sysstat-buildsize     "8.6 MB">
+  <!ENTITY sysstat-time          "less than 0.1 SBU">
+]>
+
+<sect1 id="sysstat" xreflabel="Sysstat-&sysstat-version;">
+  <?dbhtml filename="sysstat.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Sysstat-&sysstat-version;</title>
+
+  <indexterm zone="sysstat">
+    <primary sortas="a-Sysstat">Sysstat</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Sysstat</title>
+
+    <para>The <application>Sysstat</application> package contains utilities
+    to monitor system performance and usage activity.
+    <application>Sysstat</application> contains the <command>sar</command>
+    utility, common to many commercial Unixes, and tools you can schedule via
+    cron to collect and historize performance and activity data.</para>
+
+    &lfs74_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&sysstat-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&sysstat-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &sysstat-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &sysstat-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &sysstat-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &sysstat-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Sysstat Dependencies</bridgehead>
+
+    <para>There are no build-time requirements for this package; however,
+    it is designed to be controlled by a cron daemon such as
+    <xref linkend="fcron"/>.</para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/sysstat"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Sysstat</title>
+
+    <para>Install <application>Sysstat</application> by running the
+    following commands:</para>
+
+<screen><userinput>sa_lib_dir=/usr/lib/sa    \
+sa_dir=/var/log/sa        \
+conf_dir=/etc/sysconfig   \
+./configure --prefix=/usr \
+            --disable-man-group &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><envar>sa_lib_dir</envar>: This environment variable specifies the
+    location of the package-specific library directory.</para>
+
+    <para><envar>sa_dir</envar>: This environment variable specifies the
+    location of the directory containing the data files.</para>
+
+    <para><envar>conf_dir</envar>: This environment variable specifies the
+    location of the system configuration directory.</para>
+
+    <para><parameter>--disable-man-group</parameter>: This parameter causes
+    the installation to ignore the man group variable resulting in the man
+    files having
+    <systemitem class="username">root</systemitem>:<systemitem class="groupname">root</systemitem>
+    ownership.</para>
+
+    <para>Run <command>./configure --help</command> to see other influential
+    environment variables you can pass to <command>configure</command>. You may
+    want to use the <envar>history</envar> and <envar>compressafter</envar>
+    variables to customize the amount of data files kept on the system.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Sysstat</title>
+
+    <sect3>
+     <title>Cron Information</title>
+
+      <para>To begin gathering <application>Sysstat</application> history
+      information, you must add to, or create a privileged user's crontab. The
+      history data location is
+      <filename class="directory">/var/log/sa</filename>. The user running
+      <application>Sysstat</application> utilities via cron must have write
+      access to this location.</para>
+
+      <para>Below is an example of what to install in the crontab. Adjust the
+      parameters to suit your needs. Use <command>man sa1</command> and
+      <command>man sa2</command> for information about the commands.</para>
+
+<screen><literal># 8am-7pm activity reports every 10 minutes during weekdays
+0 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 &
+
+# 7pm-8am activity reports every hour during weekdays
+0 19-7 * * 1-5 /usr/lib/sa/sa1 &
+
+# Activity reports every hour on Saturday and Sunday
+0 * * * 0,6 /usr/lib/sa/sa1 &
+
+# Daily summary prepared at 19:05
+5 19 * * * /usr/lib/sa/sa2 -A &</literal></screen>
+
+    <para>Ensure you submit the revised crontab to the cron daemon.</para>
+
+    </sect3>
+
+    <sect3 id="sysstat-init">
+      <title>System Startup Information</title>
+
+      <indexterm zone="sysstat sysstat-init">
+        <primary sortas="f-sysstat">sysstat</primary>
+      </indexterm>
+
+      <para>At system startup, a LINUX RESTART message must be inserted in the
+      daily data file to reinitialize the kernel counters. This can be
+      automated by installing the <filename>/etc/rc.d/init.d/sysstat</filename>
+      init script included in the <xref linkend="bootscripts"/>
+      package using the following command as the
+      <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install-sysstat</userinput></screen>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>cifsiostat, iostat, mpstat, nsfiostat, pidstat, sadf, and sar</seg>
+        <seg>None</seg>
+        <seg>/usr/lib/sa, 
+             /usr/share/doc/sysstat-&sysstat-version; and,
+             /var/log/sa
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="cifsiostat">
+        <term><command>cifsiostat</command></term>
+        <listitem>
+          <para>displays statistics about read and write operations on CIFS
+          filesystems.</para>
+          <indexterm zone="sysstat cifsiostat">
+            <primary sortas="b-cifsiostat">cifsiostat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="iostat">
+        <term><command>iostat</command></term>
+        <listitem>
+          <para>reports CPU statistics and input/output
+          statistics for devices and partitions.</para>
+          <indexterm zone="sysstat iostat">
+            <primary sortas="b-iostat">iostat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="mpstat">
+        <term><command>mpstat</command></term>
+        <listitem>
+          <para>writes activities for each available processor.</para>
+          <indexterm zone="sysstat mpstat">
+            <primary sortas="b-mpstat">mpstat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="nfsiostat">
+        <term><command>nfsiostat</command></term>
+        <listitem>
+          <para>displays statistics about read and write operations on NFS
+          filesystems.</para>
+          <indexterm zone="sysstat nfsiostat">
+            <primary sortas="b-nfsiostat">nfsiostat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="pidstat">
+        <term><command>pidstat</command></term>
+        <listitem>
+          <para>is used for monitoring individual tasks currently being managed
+          by the Linux kernel.</para>
+          <indexterm zone="sysstat pidstat">
+            <primary sortas="b-pidstat">pidstat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sadf">
+        <term><command>sadf</command></term>
+        <listitem>
+          <para>is used for displaying the contents of data files created by
+          the <command>sar</command> command. But unlike
+          <command>sar</command>, <command>sadf</command> can write its data
+          in many different formats.</para>
+          <indexterm zone="sysstat sadf">
+            <primary sortas="b-sadf">sadf</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sar">
+        <term><command>sar</command></term>
+        <listitem>
+          <para>is used for displaying the contents of elected cumulative activity
+          counters in the operating system.</para>
+          <indexterm zone="sysstat sar">
+            <primary sortas="b-sar">sar</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Modified: tags/7.4/index.xml
==============================================================================
--- trunk/BOOK/index.xml	Fri Sep 13 07:20:27 2013	(r11834)
+++ tags/7.4/index.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -12,6 +12,7 @@
   <!-- Front Matter -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book/bookinfo.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book/dedication.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book/foreword.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book/preface.xml"/>
 
   <!-- Parts -->

Copied and modified: tags/7.4/introduction/welcome/changelog.xml (from r11836, trunk/BOOK/introduction/welcome/changelog.xml)
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Fri Sep 13 10:49:52 2013	(r11836, copy source)
+++ tags/7.4/introduction/welcome/changelog.xml	Fri Sep 13 12:50:39 2013	(r11837)
@@ -47,6 +47,9 @@
       <para>September 13th, 2013</para>
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Release of BLFS-7.4.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Update to xorg-server-1.14.3. Fixes
           <ulink url="&blfs-ticket-root;4056">#4056</ulink>.</para>
         </listitem>

Copied: tags/7.4/postlfs/security/openssh.xml (from r11835, trunk/BOOK/postlfs/security/openssh.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ tags/7.4/postlfs/security/openssh.xml	Fri Sep 13 12:50:39 2013	(r11837, copy of r11835, trunk/BOOK/postlfs/security/openssh.xml)
@@ -0,0 +1,522 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY openssh-download-http
+    "http://ftp.openbsd.org/pub/OpenBSD/OpenSSH/portable/openssh-&openssh-version;.tar.gz">
+  <!ENTITY openssh-download-ftp
+    "ftp://ftp.openbsd.org/pub/OpenBSD/OpenSSH/portable/openssh-&openssh-version;.tar.gz">
+  <!ENTITY openssh-md5sum        "225e75c9856f76011966013163784038">
+  <!ENTITY openssh-size          "1.2 MB">
+  <!ENTITY openssh-buildsize     "35 MB (additional 10 MB if running the tests)">
+  <!ENTITY openssh-time          "0.4 SBU (running the tests takes at least 10 minutes, irrespective of processor speed)">
+]>
+
+<sect1 id="openssh" xreflabel="OpenSSH-&openssh-version;">
+  <?dbhtml filename="openssh.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>OpenSSH-&openssh-version;</title>
+
+  <indexterm zone="openssh">
+    <primary sortas="a-OpenSSH">OpenSSH</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to OpenSSH</title>
+
+  <para>
+    The <application>OpenSSH</application> package contains
+    <command>ssh</command> clients and the <command>sshd</command> daemon. This
+    is useful for encrypting authentication and subsequent traffic over a
+    network. The <command>ssh</command> and <command>scp</command> commands are
+    secure implementions of <command>telnet</command> and <command>rcp</command>
+    respectively.
+  </para>
+
+  &lfs74_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&openssh-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&openssh-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &openssh-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &openssh-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &openssh-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &openssh-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">OpenSSH Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required"><xref linkend="openssl"/></para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="linux-pam"/>,
+      <xref linkend="x-window-system"/>,
+      <xref linkend="mitkrb"/>,
+      <ulink url="http://www.thrysoee.dk/editline/">libedit</ulink>,
+      <ulink url="http://www.opensc-project.org/">OpenSC</ulink>, and
+      <ulink url="http://www.citi.umich.edu/projects/smartcard/sectok.html">libsectok</ulink>
+    </para>
+
+    <bridgehead renderas="sect4">Optional Runtime (Used only to gather entropy)</bridgehead>
+    <para role="optional">
+      <xref linkend="openjdk"/>,
+      <xref linkend="net-tools"/>, and
+      <xref linkend="sysstat"/>.
+    </para>
+
+    <para condition="html" role="usernotes">
+        User Notes: <ulink url='&blfs-wiki;/OpenSSH'/>
+    </para>
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of OpenSSH</title>
+
+    <para>
+      <application>OpenSSH</application> runs as two processes when connecting
+      to other computers. The first process is a privileged process and controls
+      the issuance of privileges as necessary. The second process communicates
+      with the network. Additional installation steps are necessary to set up
+      the proper environment, which are performed by issuing the following
+      commands as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>install -v -m700 -d /var/lib/sshd &&
+chown   -v root:sys /var/lib/sshd &&
+
+groupadd -g 50 sshd &&
+useradd -c 'sshd PrivSep' -d /var/lib/sshd -g sshd -s /bin/false -u 50 sshd</userinput></screen>
+
+    <para>
+      Install <application>OpenSSH</application> by running the following
+      commands:
+    </para>
+
+<screen><userinput>./configure --prefix=/usr                     \
+            --libexecdir=/usr/lib/openssh     \
+            --sysconfdir=/etc/ssh             \
+            --datadir=/usr/share/sshd         \
+            --with-md5-passwords              \
+            --with-privsep-path=/var/lib/sshd &&
+make</userinput></screen>
+
+    <para>
+      The testsuite requires an installed copy of <command>scp</command> to
+      complete the multiplexing tests. To run the test suite, first copy the
+      <command>scp</command> program to
+      <filename class="directory">/usr/bin</filename>, making sure that you
+      back up any existing copy first.
+    </para>
+
+    <para>
+      To test the results, issue: <command>make tests</command>.
+    </para>
+
+<!-- commenting this, I get "all tests passed" [ ken ]
+ NB tests should be run as _user_ but the role in the comment is root
+
+ commenting [ bruce ]:  There are a couple of tests that want root.
+ The log mentions that SUDO is not set.  These skipped tests are 
+ ignored and the end says 'all tests passed' even when not root
+
+    <para>
+      To run the test suite, issue the following commands:
+    </para>
+
+<screen role="root"><userinput>make tests 2>&1 | tee check.log
+grep FATAL check.log</userinput></screen>
+
+    <para>
+      If the above command produces no 'FATAL' errors, then proceed with the
+      installation, as the <systemitem class="username">root</systemitem> user:
+    </para>-->
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make install                                  &&
+install -v -m755 contrib/ssh-copy-id /usr/bin &&
+install -v -m644 contrib/ssh-copy-id.1 /usr/share/man/man1 &&
+install -v -m755 -d /usr/share/doc/openssh-&openssh-version;           &&
+install -v -m644 INSTALL LICENCE OVERVIEW README* /usr/share/doc/openssh-&openssh-version;</userinput></screen>
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <parameter>--sysconfdir=/etc/ssh</parameter>: This prevents the
+      configuration files from being installed in
+      <filename class="directory">/usr/etc</filename>.
+    </para>
+
+    <para>
+      <parameter>--datadir=/usr/share/sshd</parameter>: This switch puts the
+      Ssh.bin file (used for SmartCard authentication) in
+      <filename class="directory">/usr/share/sshd</filename>.
+    </para>
+
+    <para>
+      <parameter>--with-md5-passwords</parameter>: This enables the use of MD5
+      passwords.
+    </para>
+
+    <para>
+      <parameter>--with-pam</parameter>: This parameter enables
+      <application>Linux-PAM</application> support in the build.
+    </para>
+
+    <para>
+      <parameter>--with-xauth=/usr/bin/xauth</parameter>: Set the default
+      location for the <command>xauth</command> binary for X authentication.
+      Change the location if <command>xauth</command> will be installed to a
+      different path. This can also be controlled from
+      <filename>sshd_config</filename> with the XAuthLocation keyword. You can
+      omit this switch if <application>Xorg</application> is already installed.
+    </para>
+
+    <para>
+      <parameter>--with-kerberos5=/usr</parameter>: This option is used to
+      include Kerberos 5 support in the build.
+    </para>
+
+    <para>
+      <parameter>--with-libedit</parameter>: This option enables line editing
+      and history features for <command>sftp</command>.
+    </para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring OpenSSH</title>
+
+    <sect3 id="openssh-config">
+      <title>Config Files</title>
+
+      <para>
+        <filename>~/.ssh/*</filename>,
+      <filename>/etc/ssh/ssh_config</filename>, and
+      <filename>/etc/ssh/sshd_config</filename>
+        </para>
+
+      <indexterm zone="openssh openssh-config">
+        <primary sortas="e-AA.ssh">~/.ssh/*</primary>
+      </indexterm>
+
+      <indexterm zone="openssh openssh-config">
+        <primary sortas="e-etc-ssh-ssh_config">/etc/ssh/ssh_config</primary>
+      </indexterm>
+
+      <indexterm zone="openssh openssh-config">
+        <primary sortas="e-etc-ssh-sshd_config">/etc/ssh/sshd_config</primary>
+      </indexterm>
+
+      <para>
+        There are no required changes to any of these files. However,
+        you may wish to view the
+        <filename class='directory'>/etc/ssh/</filename> files and make any
+        changes appropriate for the security of your system. One recommended
+        change is that you disable
+        <systemitem class='username'>root</systemitem> login via
+        <command>ssh</command>. Execute the following command as the
+        <systemitem class='username'>root</systemitem> user to disable
+        <systemitem class='username'>root</systemitem> login via
+        <command>ssh</command>:
+      </para>
+
+<screen role="root"><userinput>echo "PermitRootLogin no" >> /etc/ssh/sshd_config</userinput></screen>
+
+      <para>
+        If you want to be able to log in without typing in your password, first
+        create ~/.ssh/id_rsa and ~/.ssh/id_rsa.pub with
+        <command>ssh-keygen</command> and then copy ~/.ssh/id_rsa.pub to
+        ~/.ssh/authorized_keys on the remote computer that you want to log into.
+        You'll need to change REMOTE_HOSTNAME for the hostname of the remote
+        computer and you'll also need to enter you password for the ssh command
+        to succeed:
+      </para>
+
+<screen><userinput>ssh-keygen &&
+public_key="$(cat ~/.ssh/id_rsa.pub)" &&
+ssh REMOTE_HOSTNAME "echo ${public_key} >> ~/.ssh/authorized_keys" &&
+unset public_key</userinput></screen>
+
+      <para>
+        Once you've got passwordless logins working it's actually more secure
+        than logging in with a password (as the private key is much longer than
+        most people's passwords). If you would like to now disable password
+        logins, as the <systemitem class="username">root</systemitem> user:
+      </para>
+
+
+<screen role="root"><userinput>echo "PasswordAuthentication no" >> /etc/ssh/sshd_config &&
+echo "ChallengeResponseAuthentication no" >> /etc/ssh/sshd_config</userinput></screen>
+
+      <para>
+        If you added <application>LinuxPAM</application> support and you want
+        ssh to use it then you will need to add a configuration file for
+        <application>sshd</application> and enable use of
+        <application>LinuxPAM</application>. Note, ssh only uses PAM to check
+        passwords, if you've disabled password logins these commands are not
+        needed. If you want to use PAM issue the following commands as the
+        <systemitem class='username'>root</systemitem> user:
+      </para>
+
+<screen role="root"><userinput>sed 's at d/login at d/sshd at g' /etc/pam.d/login > /etc/pam.d/sshd &&
+chmod 644 /etc/pam.d/sshd &&
+echo "UsePAM yes" >> /etc/ssh/sshd_config</userinput></screen>
+
+      <para>
+        Additional configuration information can be found in the man
+        pages for <command>sshd</command>, <command>ssh</command> and
+        <command>ssh-agent</command>.
+      </para>
+    </sect3>
+
+    <sect3  id="openssh-init">
+      <title>Boot Script</title>
+
+      <para>
+        To start the SSH server at system boot, install the
+      <filename>/etc/rc.d/init.d/sshd</filename> init script included
+      in the <xref linkend="bootscripts"/> package.
+        </para>
+
+      <indexterm zone="openssh openssh-init">
+        <primary sortas="f-sshd">sshd</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-sshd</userinput></screen>
+    </sect3>
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>
+          scp, sftp, sftp-server, slogin, ssh, sshd, ssh-add, ssh-agent,
+          ssh-copy-id, ssh-keygen, ssh-keyscan, ssh-keysign, and
+          ssh-pkcs11-helper
+        </seg>
+        <seg>
+          None
+        </seg>
+        <seg>
+          /etc/ssh,
+          /var/lib/sshd,
+          /usr/lib/openssh, and
+          /usr/share/doc/openssh-&openssh-version;
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="scp">
+        <term><command>scp</command></term>
+        <listitem>
+          <para>
+            is a file copy program that acts like <command>rcp</command> except
+            it uses an encrypted protocol.
+          </para>
+          <indexterm zone="openssh scp">
+            <primary sortas="b-scp">scp</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sftp">
+        <term><command>sftp</command></term>
+        <listitem>
+          <para>
+            is an FTP-like program that works over the SSH1 and SSH2 protocols.
+          </para>
+          <indexterm zone="openssh sftp">
+            <primary sortas="b-sftp">sftp</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sftp-server">
+        <term><command>sftp-server</command></term>
+        <listitem>
+          <para>
+            is an SFTP server subsystem. This program is not normally called
+            directly by the user.
+          </para>
+          <indexterm zone="openssh sftp-server">
+            <primary sortas="b-sftp-server">sftp-server</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="slogin">
+        <term><command>slogin</command></term>
+        <listitem>
+          <para>
+            is a symlink to <command>ssh</command>.
+          </para>
+          <indexterm zone="openssh slogin">
+            <primary sortas="b-slogin">slogin</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh">
+        <term><command>ssh</command></term>
+        <listitem>
+          <para>
+            is an <command>rlogin</command>/<command>rsh</command>-like client
+            program except it uses an encrypted protocol.
+          </para>
+          <indexterm zone="openssh ssh">
+            <primary sortas="b-ssh">ssh</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sshd">
+        <term><command>sshd</command></term>
+        <listitem>
+          <para>
+            is a daemon that listens for <command>ssh</command> login requests.
+          </para>
+          <indexterm zone="openssh sshd">
+            <primary sortas="b-sshd">sshd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-add">
+        <term><command>ssh-add</command></term>
+        <listitem>
+          <para>
+            is a tool which adds keys to the <command>ssh-agent</command>.
+          </para>
+          <indexterm zone="openssh ssh-add">
+            <primary sortas="b-ssh-add">ssh-add</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-agent">
+        <term><command>ssh-agent</command></term>
+        <listitem>
+          <para>
+            is an authentication agent that can store private keys.
+          </para>
+          <indexterm zone="openssh ssh-agent">
+            <primary sortas="b-ssh-agent">ssh-agent</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-copy-id">
+        <term><command>ssh-copy-id</command></term>
+        <listitem>
+          <para>
+            is a script that enables logins on remote machine using local keys.
+          </para>
+          <indexterm zone="openssh ssh-copy-id">
+            <primary sortas="b-ssh-copy-id">ssh-copy-id</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-keygen">
+        <term><command>ssh-keygen</command></term>
+        <listitem>
+          <para>
+            is a key generation tool.
+          </para>
+          <indexterm zone="openssh ssh-keygen">
+            <primary sortas="b-ssh-keygen">ssh-keygen</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-keyscan">
+        <term><command>ssh-keyscan</command></term>
+        <listitem>
+          <para>
+            is a utility for gathering public host keys from a number of hosts.
+          </para>
+          <indexterm zone="openssh ssh-keyscan">
+            <primary sortas="b-ssh-keyscan">ssh-keyscan</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-keysign">
+        <term><command>ssh-keysign</command></term>
+        <listitem>
+          <para>
+            is used by <command>ssh</command> to access the local host keys and
+            generate the digital signature required during hostbased
+            authentication with SSH protocol version 2. This program is not
+            normally called directly by the user.
+          </para>
+          <indexterm zone="openssh ssh-keysign">
+            <primary sortas="b-ssh-keysign">ssh-keysign</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ssh-pkcs11-helper">
+        <term><command>ssh-pkcs11-helper</command></term>
+        <listitem>
+          <para>
+            is a <command>ssh-agent</command> helper program for PKCS#11 support.
+          </para>
+          <indexterm zone="openssh ssh-pkcs11-helper">
+            <primary sortas="b-ssh-pkcs11-helper">ssh-pkcs11-helper</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+  </sect2>
+</sect1>

Copied: tags/7.4/x/installing/xorg-server.xml (from r11836, trunk/BOOK/x/installing/xorg-server.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ tags/7.4/x/installing/xorg-server.xml	Fri Sep 13 12:50:39 2013	(r11837, copy of r11836, trunk/BOOK/x/installing/xorg-server.xml)
@@ -0,0 +1,307 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY xorg-server-download-http "&xorg-download-http;/xserver/xorg-server-&xorg-server-version;.tar.bz2">
+  <!ENTITY xorg-server-download-ftp  "&xorg-download-ftp;/xserver/xorg-server-&xorg-server-version;.tar.bz2">
+  <!ENTITY xorg-server-md5sum        "86abeb08d3f7ead3a2bd3d6a9ba6714e">
+  <!ENTITY xorg-server-size          "5.3 MB">
+  <!ENTITY xorg-server-buildsize     "588 MB">
+  <!ENTITY xorg-server-time          "1.8 SBU">
+]>
+
+<sect1 id="xorg-server" xreflabel="Xorg-Server-&xorg-server-version;">
+  <?dbhtml filename="xorg-server.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Xorg-Server-&xorg-server-version;</title>
+
+  <indexterm zone="xorg-server">
+    <primary sortas="a-xorg-server">xorg-server</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Xorg Server</title>
+
+    <para>
+      The <application>Xorg</application> Server is the core
+      of the X Window system.
+    </para>
+
+    &lfs74_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&xorg-server-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&xorg-server-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &xorg-server-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &xorg-server-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &xorg-server-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &xorg-server-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Optional patch:
+          <ulink url="&patch-root;/xorg-server-&xorg-server-version;-add_prime_support-1.patch"/>
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="openssl"/>,
+      <xref linkend="pixman"/>,
+      <xref linkend="xorg7-font"/>, and
+      <xref linkend="xkeyboard-config"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para>
+      <xref linkend="acpid"/> (runtime),
+      <xref linkend="doxygen"/> (to build API documentation),
+      <xref linkend="fop"/>, (to build documentation),
+      <xref linkend="gs"/> (to build documentation), and
+      <xref linkend="xmlto"/>, (to build documentation)
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+      <ulink url='&blfs-wiki;/Xorg7Server'/>
+    </para>
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Xorg Server</title>
+
+    <para>
+      If you have downloaded the optional patch, apply it by running
+      the following command:
+    </para>
+
+<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-add_prime_support-1.patch</userinput></screen>
+
+    <para>
+      Install the server by running the following commands:
+    </para>
+
+<screen><userinput>./configure $XORG_CONFIG \
+           --with-xkb-output=/var/lib/xkb \
+           --enable-install-setuid &&
+make</userinput></screen>
+
+    <para>
+      To test the results, issue: <command>make check</command>.
+    </para>
+
+    <para>
+      Now as the <systemitem class="username">root</systemitem>
+      user:
+    </para>
+
+<screen role="root"><userinput>make install &&
+mkdir -pv /etc/X11/xorg.conf.d &&
+cat >> /etc/sysconfig/createfiles << "EOF"
+/tmp/.ICE-unix dir 1777 root root
+/tmp/.X11-unix dir 1777 root root
+EOF</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <option>--enable-install-setuid</option>: The Xorg binary must run as
+      the root user. This switch ensures that the binary is installed
+      setuid when <command>make</command> is run by an unprivileged user.
+    </para>
+
+    <para>
+      <command>cat >> /etc/sysconfig/createfiles...</command>: This
+      command creates the <filename class="directory">/tmp/.ICE-unix</filename>
+      and <filename class="directory">/tmp/.X11-unix</filename> directories at
+      startup, and ensures that the permissions and ownership are correct as
+      required by the server.
+    </para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>
+          cvt, dmxaddinput, dmxaddscreen, dmxinfo, dmxreconfig, dmxresize,
+          dmxrminput, dmxrmscreen, dmxtodmx, dmxwininfo, gtf, vdltodmx, X,
+          Xdmx, xdmxconfig, Xnest, Xorg, and Xvfb
+        </seg>
+        <seg>
+          None
+        </seg>
+        <seg>
+          $XORG_PREFIX/include/xorg,
+          $XORG_PREFIX/lib/xorg,
+          $XORG_PREFIX/share/X11/xorg.conf.d, and
+          /var/lib/xkb
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="cvt-x7">
+        <term><command>cvt</command></term>
+        <listitem>
+          <para>
+            calculates VESA CVT mode lines.
+          </para>
+          <indexterm zone="xorg-server cvt-x7">
+            <primary sortas="b-cvt">cvt</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="dmx-x7">
+        <term><command>dmx*</command></term>
+        <listitem>
+          <para>
+            are various tools used for manipulating the dmx server.
+          </para>
+          <indexterm zone="xorg-server dmx-x7">
+            <primary sortas="b-dmx">dmx*</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gtf-x7">
+        <term><command>gtf</command></term>
+        <listitem>
+          <para>
+            calculates VESA GTF mode lines.
+          </para>
+          <indexterm zone="xorg-server gtf-x7">
+            <primary sortas="b-gtf">gtf</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="vdltodmx-x7">
+        <term><command>vdltodmx</command></term>
+        <listitem>
+          <para>
+            is a tool used to convert VDL config files to DMX config
+            files.
+          </para>
+          <indexterm zone="xorg-server vdltodmx-x7">
+            <primary sortas="b-vdltodmx">vdltodmx</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="X-x7">
+        <term><command>X</command></term>
+        <listitem>
+          <para>
+            is a symbolic link to Xorg.
+          </para>
+          <indexterm zone="xorg-server X-x7">
+            <primary sortas="b-X">X</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="Xnest-x7">
+        <term><command>Xnest</command></term>
+        <listitem>
+          <para>
+            is a nested X server.
+          </para>
+          <indexterm zone="xorg-server Xnest-x7">
+            <primary sortas="b-Xnest">Xnest</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="Xorg-x7">
+        <term><command>Xorg</command></term>
+        <listitem>
+          <para>
+            is the X11R7 X Server.
+          </para>
+          <indexterm zone="xorg-server Xorg-x7">
+            <primary sortas="b-Xorg">Xorg</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="Xvfb-x7">
+        <term><command>Xvfb</command></term>
+        <listitem>
+          <para>
+            is the virtual framebuffer X server for X Version 11.
+          </para>
+          <indexterm zone="xorg-server Xvfb-x7">
+            <primary sortas="b-Xvfb">Xvfb</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="xdmxconfig-x7">
+        <term><command>xdmxconfig</command></term>
+        <listitem>
+          <para>
+            is a graphical configuration utility for the dmx server.
+          </para>
+          <indexterm zone="xorg-server xdmxconfig-x7">
+            <primary sortas="b-xdmxconfig">xdmxconfig</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>



More information about the blfs-book mailing list