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/psmisc.xml | 82 ++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 77 insertions(+), 5 deletions(-)

(limited to 'chapter06/psmisc.xml')

diff --git a/chapter06/psmisc.xml b/chapter06/psmisc.xml
index 5cdaa6c0f..bcceec79a 100644
--- a/chapter06/psmisc.xml
+++ b/chapter06/psmisc.xml
@@ -3,13 +3,15 @@
   <!ENTITY % general-entities SYSTEM "../general.ent">
   %general-entities;
 ]>
-<sect1 id="ch-system-psmisc" xreflabel="Psmisc" role="wrap">
+<sect1 id="ch-system-psmisc" role="wrap">
 <title>Psmisc-&psmisc-version;</title>
 <?dbhtml filename="psmisc.html"?>
 
 <indexterm zone="ch-system-psmisc"><primary sortas="a-Psmisc">Psmisc</primary></indexterm>
 
 <sect2 role="package"><title/>
+<para>The Psmisc package contains programs for displaying information on
+processes.</para>
 
 <segmentedlist>
 <segtitle>&buildtime;</segtitle>
@@ -17,6 +19,11 @@
 <seglistitem><seg>0.1 SBU</seg><seg>2.2 MB</seg></seglistitem>
 </segmentedlist>
 
+<segmentedlist>
+<segtitle>Psmisc installation depends on</segtitle>
+<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
+GCC, Gettext, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem>
+</segmentedlist>
 </sect2>
 
 <sect2 role="installation">
@@ -26,20 +33,44 @@
 
 <screen><userinput>./configure --prefix=/usr --exec-prefix=""</userinput></screen>
 
+<para>The meaning of the configure option:</para>
+
+<variablelist>
+<varlistentry>
+<term><parameter>--exec-prefix=""</parameter></term>
+<listitem><para>This causes the binaries to be installed in <filename
+class="directory">/bin</filename> instead of <filename
+class="directory">/usr/bin</filename>. Because the Psmisc programs are
+often used in bootscripts, they should be available when the <filename
+class="directory">/usr</filename> file system is not
+mounted.</para></listitem>
+</varlistentry>
+</variablelist>
+
 <para>Compile the package:</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>Now install it:</para>
+<para>Install the package:</para>
 
 <screen><userinput>make install</userinput></screen>
 
-<para>Move a program:</para>
+<para>There is no reason for the <command>pstree</command> and
+<command>pstree.x11</command> programs to reside in <filename
+class="directory">/bin</filename>. Therefore, move them to <filename
+class="directory">/usr/bin</filename>. Also, there is no need for
+<command>pstree.x11</command> to exist as a separate program. Make it
+a symbolic link to <command>pstree</command> instead:</para>
 
 <screen><userinput>mv /bin/pstree* /usr/bin
 ln -sf pstree /usr/bin/pstree.x11</userinput></screen>
 
-<para>If you're not going to use Sysvinit, you should create the following symlink:</para>
+<para>By default, Psmisc's <command>pidof</command> program is not
+installed. This usually is not a problem because it is installed later
+in the Sysvinit package, which provides a better
+<command>pidof</command> program. If Sysvinit will not be used for a
+particular system, complete the installation of Psmisc by creating the
+following symlink:</para>
 
 <screen><userinput>ln -s killall /bin/pidof</userinput></screen>
 
@@ -48,8 +79,49 @@ ln -sf pstree /usr/bin/pstree.x11</userinput></screen>
 
 <sect2 id="contents-psmisc" role="content"><title>Contents of Psmisc</title>
 
-<para>See testing</para>
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<seglistitem><seg>fuser, killall, pstree, and pstree.x11 (link to pstree)</seg></seglistitem>
+</segmentedlist>
+
+<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
+
+<varlistentry id="fuser">
+<term><command>fuser</command></term>
+<listitem>
+<para>Reports the Process IDs (PIDs) of processes that use the given files or file systems</para>
+<indexterm zone="ch-system-psmisc fuser"><primary sortas="b-fuser">fuser</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="killall">
+<term><command>killall</command></term>
+<listitem>
+<para>Kills processes by name; it sends a signal to all processes
+running any of the given commands</para>
+<indexterm zone="ch-system-psmisc killall"><primary sortas="b-killall">killall</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="pstree">
+<term><command>pstree</command></term>
+<listitem>
+<para>Displays running processes as a tree</para>
+<indexterm zone="ch-system-psmisc pstree"><primary sortas="b-pstree">pstree</primary></indexterm>
+</listitem>
+</varlistentry>
+
+<varlistentry id="pstree.x11">
+<term><command>pstree.x11</command></term>
+<listitem>
+<para>Same as <command>pstree</command>, except that it waits for confirmation before exiting</para>
+<indexterm zone="ch-system-psmisc pstree.x11"><primary sortas="b-pstree.x11">pstree.x11</primary></indexterm>
+</listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 
 </sect1>
+
-- 
cgit v1.2.3-54-g00ecf