source: final-system/common/psmisc.xml@ 75e10d2

Last change on this file since 75e10d2 was e6423a01, checked in by Jim Gifford <clfs@…>, 19 years ago

r781@server (orig r779): jim | 2005-11-30 22:14:06 -0800

r836@server: jim | 2005-11-30 22:13:02 -0800
Text updates to final-system


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