From 81fd230419b0cfd052b08fc1ed352bb7d49975df Mon Sep 17 00:00:00 2001
From: Gerard Beekmans <gerard@linuxfromscratch.org>
Date: Sat, 19 Feb 2005 22:16:42 +0000
Subject: Trunk is now identical to Testing

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@4648 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter06/procps.xml | 158 +++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 154 insertions(+), 4 deletions(-)

(limited to 'chapter06/procps.xml')

diff --git a/chapter06/procps.xml b/chapter06/procps.xml
index 09dcfafe4..102836c9a 100644
--- a/chapter06/procps.xml
+++ b/chapter06/procps.xml
@@ -3,13 +3,14 @@
   <!ENTITY % general-entities SYSTEM "../general.ent">
   %general-entities;
 ]>
-<sect1 id="ch-system-procps" xreflabel="Procps" role="wrap">
+<sect1 id="ch-system-procps" role="wrap">
 <title>Procps-&procps-version;</title>
 <?dbhtml filename="procps.html"?>
 
 <indexterm zone="ch-system-procps"><primary sortas="a-Procps">Procps</primary></indexterm>
 
 <sect2 role="package"><title/>
+<para>The Procps package contains programs for monitoring processes.</para>
 
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>
@@ -17,16 +18,21 @@
 <seglistitem><seg>0.1 SBU</seg><seg>6.2 MB</seg></seglistitem>
 </segmentedlist>
 
+<segmentedlist>
+<segtitle>Procps installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, GCC, Glibc,
+Make, and Ncurses</seg></seglistitem>
+</segmentedlist>
 </sect2>
 
 <sect2 role="installation">
 <title>Installation of Procps</title>
 
-<para>Compile Procps:</para>
+<para>Compile the package:</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>Install it:</para>
+<para>Install the package:</para>
 
 <screen><userinput>make install</userinput></screen>
 
@@ -35,8 +41,152 @@
 
 <sect2 id="contents-procps" role="content"><title>Contents of Procps</title>
 
-<para>See testing</para>
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<segtitle>Installed library</segtitle>
+<seglistitem><seg>free, kill, pgrep, pkill,
+pmap, ps, skill, snice, sysctl, tload, top, uptime, vmstat, w, and watch</seg>
+<seg>libproc.so</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="free">
+<term><command>free</command></term>
+<listitem>
+<para>Reports the amount of free and used memory (both physical and
+swap memory) in the system</para>
+<indexterm zone="ch-system-procps free"><primary sortas="b-free">free</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="kill">
+<term><command>kill</command></term>
+<listitem>
+<para>Sends signals to processes</para>
+<indexterm zone="ch-system-procps kill"><primary sortas="b-kill">kill</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="pgrep">
+<term><command>pgrep</command></term>
+<listitem>
+<para>Looks up processes based on their name and other attributes</para>
+<indexterm zone="ch-system-procps pgrep"><primary sortas="b-pgrep">pgrep</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="pkill">
+<term><command>pkill</command></term>
+<listitem>
+<para>Signals processes based on their name and other attributes</para>
+<indexterm zone="ch-system-procps pkill"><primary sortas="b-pkill">pkill</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="pmap">
+<term><command>pmap</command></term>
+<listitem>
+<para>Reports the memory map of the given process</para>
+<indexterm zone="ch-system-procps pmap"><primary sortas="b-pmap">pmap</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="ps">
+<term><command>ps</command></term>
+<listitem>
+<para>Lists the current running processes</para>
+<indexterm zone="ch-system-procps ps"><primary sortas="b-ps">ps</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="skill">
+<term><command>skill</command></term>
+<listitem>
+<para>Sends signals to processes matching the given criteria</para>
+<indexterm zone="ch-system-procps skill"><primary sortas="b-skill">skill</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="snice">
+<term><command>snice</command></term>
+<listitem>
+<para>Changes the scheduling priority of processes matching the given criteria</para>
+<indexterm zone="ch-system-procps snice"><primary sortas="b-snice">snice</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="sysctl">
+<term><command>sysctl</command></term>
+<listitem>
+<para>Modifies kernel parameters at run time</para>
+<indexterm zone="ch-system-procps sysctl"><primary sortas="b-sysctl">sysctl</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="tload">
+<term><command>tload</command></term>
+<listitem>
+<para>Prints a graph of the current system load average</para>
+<indexterm zone="ch-system-procps tload"><primary sortas="b-tload">tload</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="top">
+<term><command>top</command></term>
+<listitem>
+<para>Displays the top CPU processes; it provides an ongoing look at
+processor activity in real time</para>
+<indexterm zone="ch-system-procps top"><primary sortas="b-top">top</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="uptime">
+<term><command>uptime</command></term>
+<listitem>
+<para>Reports how long the system has been running, how many users are
+logged on, and the system load averages</para>
+<indexterm zone="ch-system-procps uptime"><primary sortas="b-uptime">uptime</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="vmstat">
+<term><command>vmstat</command></term>
+<listitem>
+<para>Reports virtual memory statistics, giving information about
+processes, memory, paging, block Input/Output (IO), traps, and CPU activity</para>
+<indexterm zone="ch-system-procps vmstat"><primary sortas="b-vmstat">vmstat</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="w">
+<term><command>w</command></term>
+<listitem>
+<para>Shows which users are currently logged on, where, and since when</para>
+<indexterm zone="ch-system-procps w"><primary sortas="b-w">w</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="watch">
+<term><command>watch</command></term>
+<listitem>
+<para>Runs a given command repeatedly, displaying the first screen-full of its 
+output; this allows a user to watch the output change over time</para>
+<indexterm zone="ch-system-procps watch"><primary sortas="b-watch">watch</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="libproc">
+<term><filename class="libraryfile">libproc</filename></term>
+<listitem>
+<para>Contains the functions used by most programs in this package</para>
+<indexterm zone="ch-system-procps libproc"><primary sortas="c-libproc">libproc</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 
 </sect1>
+
-- 
cgit v1.2.3-54-g00ecf