source: BOOK/final-system/common/procps-ng.xml @ f698055a

clfs-3.0.0-systemdsystemd
Last change on this file since f698055a was f698055a, checked in by Chris Staub <chris@…>, 9 years ago

Improve consistency in package installation lists, mainly removing 'and'

  • Property mode set to 100644
File size: 8.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-procps-ng" role="wrap">
9  <?dbhtml filename="procps-ng.html"?>
10
11  <title>Procps-ng-&procps-ng-version;</title>
12
13  <indexterm zone="ch-system-procps-ng">
14    <primary sortas="a-Procps-ng">Procps-ng</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Procps-ng package contains programs for monitoring
21    processes.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Procps-ng</title>
27
28    <para os="a">Prepare procps-ng for compilation:</para>
29
30<screen os="b"><userinput>./configure --prefix=/usr --exec-prefix= \
31    --libdir=/usr/lib --docdir=/usr/share/doc/procps-ng-&procps-ng-version; \
32    --disable-kill</userinput></screen>
33
34    <variablelist os="c">
35      <title>The meaning of the configure options:</title>
36      <varlistentry>
37        <term><parameter>--disable-kill</parameter></term>
38        <listitem>
39          <para>This switch disables building the kill command that
40          was installed in the util-linux package.</para>
41        </listitem>
42      </varlistentry>
43    </variablelist>
44
45    <para os="d">Compile the package:</para>
46
47<screen os="e"><userinput>make</userinput></screen>
48
49    <note os="note1">
50      <para>When using the boot method, two tests will fail if the hostname is
51      not set:</para>
52
53<screen><userinput remap="test">hostname clfs</userinput></screen>
54    </note>
55
56    <para os="f">Remove the test which fails when scripting does not use a tty
57    device. Run the following commands:</para>
58
59<screen os="g"><userinput remap="test">sed -i -r 's|(pmap_initname)\\\$|\1|' testsuite/pmap.test/pmap.exp
60make check</userinput></screen>
61
62    <para os="h">Install the package:</para>
63
64<screen os="i"><userinput>make install</userinput></screen>
65
66    <para os="j">Move essential files to a location that can be found if <filename class="directory">/usr</filename> is not mounted.</para>
67
68<screen os="k"><userinput>mv -v /usr/bin/pidof /bin
69mv -v /usr/lib/libprocps.so.* /lib
70ln -sfv ../../lib/$(readlink /usr/lib/libprocps.so) /usr/lib/libprocps.so</userinput></screen>
71
72  </sect2>
73
74  <sect2 id="contents-procps-ng" role="content">
75    <title>Contents of Procps-ng</title>
76
77    <segmentedlist>
78      <segtitle>Installed programs</segtitle>
79      <segtitle>Installed library</segtitle>
80      <segtitle>Installed directories</segtitle>
81
82      <seglistitem>
83        <seg>free, pgrep, pidof, pkill, pmap, ps, pwdx, slabtop, sysctl, tload,
84        top, uptime, vmstat, w, watch</seg>
85        <seg>libprocps.{a,so}</seg>
86        <seg>/usr/include/proc, /usr/share/doc/procps-ng-&procps-ng-version;</seg>
87      </seglistitem>
88    </segmentedlist>
89
90    <variablelist>
91      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
92      <?dbfo list-presentation="list"?>
93      <?dbhtml list-presentation="table"?>
94
95      <varlistentry id="free">
96        <term><command>free</command></term>
97        <listitem>
98          <para>Reports the amount of free and used memory (both physical and
99          swap memory) in the system</para>
100          <indexterm zone="ch-system-procps-ng free">
101            <primary sortas="b-free">free</primary>
102          </indexterm>
103        </listitem>
104      </varlistentry>
105
106      <varlistentry id="pgrep">
107        <term><command>pgrep</command></term>
108        <listitem>
109          <para>Looks up processes based on their name and other attributes</para>
110          <indexterm zone="ch-system-procps-ng pgrep">
111            <primary sortas="b-pgrep">pgrep</primary>
112          </indexterm>
113        </listitem>
114      </varlistentry>
115
116      <varlistentry id="pidof">
117        <term><command>pidof</command></term>
118        <listitem>
119          <para>Looks up processes based on their name and other attributes</para>
120          <indexterm zone="ch-system-procps-ng pidof">
121            <primary sortas="b-pidof">pidof</primary>
122          </indexterm>
123        </listitem>
124      </varlistentry>
125
126      <varlistentry id="pkill">
127        <term><command>pkill</command></term>
128        <listitem>
129          <para>Signals processes based on their name and other attributes</para>
130          <indexterm zone="ch-system-procps-ng pkill">
131            <primary sortas="b-pkill">pkill</primary>
132          </indexterm>
133        </listitem>
134      </varlistentry>
135
136      <varlistentry id="pmap">
137        <term><command>pmap</command></term>
138        <listitem>
139          <para>Reports the memory map of the given process</para>
140          <indexterm zone="ch-system-procps-ng pmap">
141            <primary sortas="b-pmap">pmap</primary>
142          </indexterm>
143        </listitem>
144      </varlistentry>
145
146      <varlistentry id="ps">
147        <term><command>ps</command></term>
148        <listitem>
149          <para>Lists the current running processes</para>
150          <indexterm zone="ch-system-procps-ng ps">
151            <primary sortas="b-ps">ps</primary>
152          </indexterm>
153        </listitem>
154      </varlistentry>
155
156      <varlistentry id="pwdx">
157        <term><command>pwdx</command></term>
158        <listitem>
159          <para>Reports the current working directory of a process</para>
160          <indexterm zone="ch-system-procps-ng pwdx">
161            <primary sortas="b-pwdx">pwdx</primary>
162          </indexterm>
163        </listitem>
164      </varlistentry>
165
166      <varlistentry id="slabtop">
167        <term><command>slabtop</command></term>
168        <listitem>
169          <para>Displays detailed kernel slab cache information in real time</para>
170          <indexterm zone="ch-system-procps-ng slabtop">
171            <primary sortas="b-slabtop">slabtop</primary>
172          </indexterm>
173        </listitem>
174      </varlistentry>
175
176
177      <varlistentry id="sysctl">
178        <term><command>sysctl</command></term>
179        <listitem>
180          <para>Modifies kernel parameters at run time</para>
181          <indexterm zone="ch-system-procps-ng sysctl">
182            <primary sortas="b-sysctl">sysctl</primary>
183          </indexterm>
184        </listitem>
185      </varlistentry>
186
187      <varlistentry id="tload">
188        <term><command>tload</command></term>
189        <listitem>
190          <para>Prints a graph of the current system load average</para>
191          <indexterm zone="ch-system-procps-ng tload">
192            <primary sortas="b-tload">tload</primary>
193          </indexterm>
194        </listitem>
195      </varlistentry>
196
197      <varlistentry id="top">
198        <term><command>top</command></term>
199        <listitem>
200          <para>Displays a list of the most CPU intensive processes; it
201          provides an ongoing look at processor activity in real time</para>
202          <indexterm zone="ch-system-procps-ng top">
203            <primary sortas="b-top">top</primary>
204          </indexterm>
205        </listitem>
206      </varlistentry>
207
208      <varlistentry id="uptime">
209        <term><command>uptime</command></term>
210        <listitem>
211          <para>Reports how long the system has been running, how many users are
212          logged on, and the system load averages</para>
213          <indexterm zone="ch-system-procps-ng uptime">
214            <primary sortas="b-uptime">uptime</primary>
215          </indexterm>
216        </listitem>
217      </varlistentry>
218
219      <varlistentry id="vmstat">
220        <term><command>vmstat</command></term>
221        <listitem>
222          <para>Reports virtual memory statistics, giving information about
223          processes, memory, paging, block Input/Output (IO), traps, and CPU
224          activity</para>
225          <indexterm zone="ch-system-procps-ng vmstat">
226            <primary sortas="b-vmstat">vmstat</primary>
227          </indexterm>
228        </listitem>
229      </varlistentry>
230
231      <varlistentry id="w">
232        <term><command>w</command></term>
233        <listitem>
234          <para>Shows which users are currently logged on, where, and since
235          when</para>
236          <indexterm zone="ch-system-procps-ng w">
237            <primary sortas="b-w">w</primary>
238          </indexterm>
239        </listitem>
240      </varlistentry>
241
242      <varlistentry id="watch">
243        <term><command>watch</command></term>
244        <listitem>
245          <para>Runs a given command repeatedly, displaying the first
246          screen-full of its output; this allows a user to watch the output
247          change over time</para>
248          <indexterm zone="ch-system-procps-ng watch">
249            <primary sortas="b-watch">watch</primary>
250          </indexterm>
251        </listitem>
252      </varlistentry>
253
254      <varlistentry id="libprocps">
255        <term><filename class="libraryfile">libprocps</filename></term>
256        <listitem>
257          <para>Contains the functions used by most programs in this
258          package</para>
259          <indexterm zone="ch-system-procps-ng libprocps">
260            <primary sortas="c-libprocps">libprocps</primary>
261          </indexterm>
262        </listitem>
263      </varlistentry>
264
265    </variablelist>
266
267  </sect2>
268
269</sect1>
Note: See TracBrowser for help on using the repository browser.