r3368 - in trunk/BOOK: . general/sysutils

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Jan 31 07:07:53 PST 2005


Author: randy
Date: 2005-01-31 08:07:52 -0700 (Mon, 31 Jan 2005)
New Revision: 3368

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/sysutils/sysstat.xml
Log:
Added indexing tags to Sysstat

Modified: trunk/BOOK/general/sysutils/sysstat.xml
===================================================================
--- trunk/BOOK/general/sysutils/sysstat.xml	2005-01-31 02:43:49 UTC (rev 3367)
+++ trunk/BOOK/general/sysutils/sysstat.xml	2005-01-31 15:07:52 UTC (rev 3368)
@@ -8,7 +8,7 @@
   <!ENTITY sysstat-download-ftp  "ftp://ibiblio.org/pub/linux/system/status/sysstat-&sysstat-version;.tar.gz">
   <!ENTITY sysstat-size          "124 KB">
   <!ENTITY sysstat-buildsize     "1.2 MB">
-  <!ENTITY sysstat-time          ".12 SBU">
+  <!ENTITY sysstat-time          "0.12 SBU">
 ]>
 
 <sect1 id="sysstat" xreflabel="Sysstat-&sysstat-version;">
@@ -18,6 +18,8 @@
 </sect1info>
 <?dbhtml filename="sysstat.html"?>
 <title>Sysstat-&sysstat-version;</title>
+<indexterm zone="sysstat">
+<primary sortas="a-Sysstat">Sysstat</primary></indexterm>
 
 <sect2>
 <title>Introduction to <application>Sysstat</application></title>
@@ -30,11 +32,16 @@
 
 <sect3><title>Package information</title>
 <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 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>
+<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 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>
 </sect3>
 
 <sect3><title><application>Sysstat</application> dependencies</title>
@@ -51,9 +58,12 @@
 following commands:</para>
 
 <screen><userinput><command>make config &&
-make &&
-make install</command></userinput></screen>
+make</command></userinput></screen>
 
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
+
 </sect2>
 
 <sect2>
@@ -99,14 +109,17 @@
 <para>Ensure you submit the revised crontab to the cron daemon.</para>
 </sect3>
 
-<sect3><title>System startup information</title>
+<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="intro-important-bootscripts"/> package using 
 the following command:</para>
-<screen><userinput><command>make install-sysstat</command></userinput></screen>
+
+<screen><userinput role='root'><command>make install-sysstat</command></userinput></screen>
 </sect3>
 
 </sect2>
@@ -114,43 +127,77 @@
 <sect2>
 <title>Contents</title>
 
-<para>The <application>Sysstat</application> package contains 
-<command>iostat</command>, 
-<command>mpstat</command>, 
-<command>sar</command>, 
-<filename>sa1</filename>, 
-<filename>sa2</filename> and 
-<filename>sadc</filename>.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>iostat, mpstat, sar, sa1, sa2 and sadc</seg>
+<seg>None</seg>
+<seg>/usr/lib/sa and /var/log/sa</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>iostat</title>
-<para><command>iostat</command> reports <acronym>CPU</acronym> statistics and 
-input/output statistics for devices and partitions.</para></sect3>
+<varlistentry id="iostat">
+<term><command>iostat</command></term>
+<listitem><para>reports <acronym>CPU</acronym> statistics and input/output 
+statistics for devices and partitions.</para>
+<indexterm zone="sysstat iostat">
+<primary sortas="b-iostat">iostat</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>mpstat</title>
-<para><command>mpstat</command> reports individual or combined processor 
-related statistics.</para></sect3>
+<varlistentry id="mpstat">
+<term><command>mpstat</command></term>
+<listitem><para>reports individual or combined processor related 
+statistics.</para>
+<indexterm zone="sysstat mpstat">
+<primary sortas="b-mpstat">mpstat</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sar</title>
-<para><command>sar</command> collects, reports and saves system activity 
-information.</para></sect3>
+<varlistentry id="sar">
+<term><command>sar</command></term>
+<listitem><para> collects, reports and saves system activity 
+information.</para>
+<indexterm zone="sysstat sar">
+<primary sortas="b-sar">sar</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sa1</title>
-<para><filename>sa1</filename> collects and stores binary data in the system 
-activity daily data file. It is a front end to <filename>sadc</filename> 
-designed to be run from cron.</para></sect3>
+<varlistentry id="sa1">
+<term><command>sa1</command></term>
+<listitem><para>collects and stores binary data in the system activity daily 
+data file. It is a front end to <filename>sadc</filename> designed to be run 
+from cron.</para>
+<indexterm zone="sysstat sa1">
+<primary sortas="b-sa1">sa1</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sa2</title>
-<para><filename>sa2</filename> writes a summarized daily activity report. It 
-is a front end to <command>sar</command> designed to be run from 
-cron.</para></sect3>
+<varlistentry id="sa2">
+<term><command>sa2</command></term>
+<listitem><para>writes a summarized daily activity report. It is a front end 
+to <command>sar</command> designed to be run from cron.</para>
+<indexterm zone="sysstat sa2">
+<primary sortas="b-sa2">sa2</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sadc</title>
-<para><filename>sadc</filename> is the system activity data collector, used as 
-a backend for <command>sar</command>.</para></sect3>
+<varlistentry id="sadc">
+<term><command>sadc</command></term>
+<listitem><para>is the system activity data collector, used as a backend for 
+<command>sar</command>.</para>
+<indexterm zone="sysstat sadc">
+<primary sortas="b-sadc">sadc</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-01-31 02:43:49 UTC (rev 3367)
+++ trunk/BOOK/general.ent	2005-01-31 15:07:52 UTC (rev 3368)
@@ -1,8 +1,8 @@
-<!ENTITY day          "30">
+<!ENTITY day          "31">
 <!ENTITY month        "01">
 <!ENTITY year         "2005">
 <!ENTITY version      "svn-&year;&month;&day;">
-<!ENTITY releasedate  "January &day;th, &year;">
+<!ENTITY releasedate  "January &day;st, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "cvs">                  <!-- cvs|[release #] -->
 <!ENTITY lfs-version  "stable">               <!-- stable|testing|unstable] -->




More information about the blfs-book mailing list