source: final-system/common/psmisc.xml @ bf8c11f

Last change on this file since bf8c11f was bf8c11f, checked in by Jim Gifford <clfs@…>, 18 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 4.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6  %general-entities;
7  %patches-entities;
8]>
9
10<sect1 id="ch-system-psmisc" role="wrap">
11  <?dbhtml filename="psmisc.html"?>
12
13  <title>Psmisc-&psmisc-version;</title>
14
15  <indexterm zone="ch-system-psmisc">
16    <primary sortas="a-Psmisc">Psmisc</primary>
17  </indexterm>
18
19  <sect2 role="package">
20    <title/>
21
22    <para>The Psmisc package contains programs for displaying information
23    about running processes.</para>
24
25    <segmentedlist>
26      <segtitle>&buildtime;</segtitle>
27      <segtitle>&diskspace;</segtitle>
28
29      <seglistitem>
30        <seg>Not checked yet</seg>
31        <seg>Not checked yet</seg>
32      </seglistitem>
33    </segmentedlist>
34
35    <segmentedlist>
36      <segtitle>&dependencies;</segtitle>
37
38      <seglistitem>
39        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
40        Grep, Make, Ncurses, and Sed</seg>
41      </seglistitem>
42    </segmentedlist>
43
44  </sect2>
45
46  <sect2 role="installation">
47    <title>Installation of Psmisc</title>
48
49    <para os="a">Prepare Psmisc for compilation:</para>
50
51<screen><userinput>./configure --prefix=/usr --exec-prefix=""</userinput></screen>
52
53    <variablelist os="b">
54      <title>The meaning of the configure option:</title>
55
56      <varlistentry>
57        <term><parameter>--exec-prefix=""</parameter></term>
58        <listitem>
59          <para>This ensures that the Psmisc binaries will install into
60          <filename class="directory">/bin</filename> instead of
61          <filename class="directory">/usr/bin</filename>. This is the
62          correct location according to the FHS, because some of the Psmisc
63          binaries are used by the LFS-Bootscripts package.</para>
64        </listitem>
65      </varlistentry>
66    </variablelist>
67
68    <para os="c">Compile the package:</para>
69
70<screen os="d"><userinput>make</userinput></screen>
71
72    <para os="e">Install the package:</para>
73
74<screen os="f"><userinput>make install</userinput></screen>
75
76    <para os="g">There is no reason for the <command>pstree</command> and
77    <command>pstree.x11</command> programs to reside in <filename
78    class="directory">/bin</filename>. Therefore, move them to <filename
79    class="directory">/usr/bin</filename>:</para>
80
81<screen os="h"><userinput>mv /bin/pstree* /usr/bin</userinput></screen>
82
83    <para os="i">By default, Psmisc's <command>pidof</command> program is not installed.
84    This usually is not a problem because it is installed later in the Sysvinit
85    package, which provides a better <command>pidof</command> program. If
86    Sysvinit will not be used for a particular system, complete the installation
87    of Psmisc by creating the following symlink:</para>
88
89<screen os="j"><userinput>ln -s killall /bin/pidof</userinput></screen>
90
91  </sect2>
92
93  <sect2 id="contents-psmisc" role="content">
94    <title>Contents of Psmisc</title>
95
96    <segmentedlist>
97      <segtitle>Installed programs</segtitle>
98
99      <seglistitem>
100        <seg>fuser, killall, pstree, and pstree.x11 (link to pstree)</seg>
101      </seglistitem>
102    </segmentedlist>
103
104    <variablelist>
105      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
106      <?dbfo list-presentation="list"?>
107      <?dbhtml list-presentation="table"?>
108
109      <varlistentry id="fuser">
110        <term><command>fuser</command></term>
111        <listitem>
112          <para>Reports the Process IDs (PIDs) of processes that use the given
113          files or file systems</para>
114          <indexterm zone="ch-system-psmisc fuser">
115            <primary sortas="b-fuser">fuser</primary>
116          </indexterm>
117        </listitem>
118      </varlistentry>
119
120      <varlistentry id="killall">
121        <term><command>killall</command></term>
122        <listitem>
123          <para>Kills processes by name; it sends a signal to all processes
124          running any of the given commands</para>
125          <indexterm zone="ch-system-psmisc killall">
126            <primary sortas="b-killall">killall</primary>
127          </indexterm>
128        </listitem>
129      </varlistentry>
130
131      <varlistentry id="pstree">
132        <term><command>pstree</command></term>
133        <listitem>
134          <para>Displays running processes as a tree</para>
135          <indexterm zone="ch-system-psmisc pstree">
136            <primary sortas="b-pstree">pstree</primary>
137          </indexterm>
138        </listitem>
139      </varlistentry>
140
141      <varlistentry id="pstree.x11">
142        <term><command>pstree.x11</command></term>
143        <listitem>
144          <para>Same as <command>pstree</command>, except that it waits for
145          confirmation before exiting</para>
146          <indexterm zone="ch-system-psmisc pstree.x11">
147            <primary sortas="b-pstree.x11">pstree.x11</primary>
148          </indexterm>
149        </listitem>
150      </varlistentry>
151
152    </variablelist>
153
154  </sect2>
155
156</sect1>
Note: See TracBrowser for help on using the repository browser.