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

systemd
Last change on this file since fe23bd1 was fe23bd1, checked in by William Harrington <kb0iic@…>, 5 years ago

the pidof command is already in /bin. Attempting to mv /usr/bin/pidof /bin results in error.

  • Property mode set to 100644
File size: 9.0 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 <command>kill</command>
40          program - a better version was installed by 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. If you have booted the temporary system, and want to run the
52      test suite, run the following command:</para>
53
54<screen><userinput remap="test">hostname clfs</userinput></screen>
55    </note>
56
57    <para os="f">If running the testsuite, first disable a test which fails
58    when scripting does not use a tty device:</para>
59
60<screen os="g"><userinput remap="test">sed -i -r 's|(pmap_initname)\\\$|\1|' testsuite/pmap.test/pmap.exp
61make check</userinput></screen>
62
63    <para os="h">Install the package:</para>
64
65<screen os="i"><userinput>make install</userinput></screen>
66
67    <para os="j">Move essential files to a location that can be found if
68    <filename class="directory">/usr</filename> is not mounted:</para>
69
70<screen os="k"><userinput>mv -v /usr/lib/libprocps.so.* /lib
71ln -sfv ../../lib/$(readlink /usr/lib/libprocps.so) /usr/lib/libprocps.so</userinput></screen>
72
73  </sect2>
74
75  <sect2 id="contents-procps-ng" role="content">
76    <title>Contents of Procps-ng</title>
77
78    <segmentedlist>
79      <segtitle>Installed programs</segtitle>
80      <segtitle>Installed library</segtitle>
81      <segtitle>Installed directories</segtitle>
82
83      <seglistitem>
84        <seg>free, pgrep, pidof, pkill, pmap, ps, pwdx, slabtop, sysctl, tload,
85        top, uptime, vmstat, w, watch</seg>
86        <seg>libprocps.{a,so}</seg>
87        <seg>/usr/include/proc, /usr/share/doc/procps-ng-&procps-ng-version;</seg>
88      </seglistitem>
89    </segmentedlist>
90
91    <variablelist>
92      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
93      <?dbfo list-presentation="list"?>
94      <?dbhtml list-presentation="table"?>
95
96      <varlistentry id="free">
97        <term><command>free</command></term>
98        <listitem>
99          <para>Reports the amount of free and used memory (both physical and
100          swap memory) in the system</para>
101          <indexterm zone="ch-system-procps-ng free">
102            <primary sortas="b-free">free</primary>
103          </indexterm>
104        </listitem>
105      </varlistentry>
106
107      <varlistentry id="pgrep">
108        <term><command>pgrep</command></term>
109        <listitem>
110          <para>Looks up processes based on their name and other attributes</para>
111          <indexterm zone="ch-system-procps-ng pgrep">
112            <primary sortas="b-pgrep">pgrep</primary>
113          </indexterm>
114        </listitem>
115      </varlistentry>
116
117      <varlistentry id="pidof">
118        <term><command>pidof</command></term>
119        <listitem>
120          <para>Reports the PIDs of the given programs</para>
121          <indexterm zone="ch-system-procps-ng pidof">
122            <primary sortas="b-pidof">pidof</primary>
123          </indexterm>
124        </listitem>
125      </varlistentry>
126
127      <varlistentry id="pkill">
128        <term><command>pkill</command></term>
129        <listitem>
130          <para>Signals processes based on their name and other attributes</para>
131          <indexterm zone="ch-system-procps-ng pkill">
132            <primary sortas="b-pkill">pkill</primary>
133          </indexterm>
134        </listitem>
135      </varlistentry>
136
137      <varlistentry id="pmap">
138        <term><command>pmap</command></term>
139        <listitem>
140          <para>Reports the memory map of the given process</para>
141          <indexterm zone="ch-system-procps-ng pmap">
142            <primary sortas="b-pmap">pmap</primary>
143          </indexterm>
144        </listitem>
145      </varlistentry>
146
147      <varlistentry id="ps">
148        <term><command>ps</command></term>
149        <listitem>
150          <para>Lists the current running processes</para>
151          <indexterm zone="ch-system-procps-ng ps">
152            <primary sortas="b-ps">ps</primary>
153          </indexterm>
154        </listitem>
155      </varlistentry>
156
157      <varlistentry id="pwdx">
158        <term><command>pwdx</command></term>
159        <listitem>
160          <para>Reports the current working directory of a process</para>
161          <indexterm zone="ch-system-procps-ng pwdx">
162            <primary sortas="b-pwdx">pwdx</primary>
163          </indexterm>
164        </listitem>
165      </varlistentry>
166
167      <varlistentry id="slabtop">
168        <term><command>slabtop</command></term>
169        <listitem>
170          <para>Displays detailed kernel slab cache information in real time</para>
171          <indexterm zone="ch-system-procps-ng slabtop">
172            <primary sortas="b-slabtop">slabtop</primary>
173          </indexterm>
174        </listitem>
175      </varlistentry>
176
177
178      <varlistentry id="sysctl">
179        <term><command>sysctl</command></term>
180        <listitem>
181          <para>Modifies kernel parameters at run time</para>
182          <indexterm zone="ch-system-procps-ng sysctl">
183            <primary sortas="b-sysctl">sysctl</primary>
184          </indexterm>
185        </listitem>
186      </varlistentry>
187
188      <varlistentry id="tload">
189        <term><command>tload</command></term>
190        <listitem>
191          <para>Prints a graph of the current system load average</para>
192          <indexterm zone="ch-system-procps-ng tload">
193            <primary sortas="b-tload">tload</primary>
194          </indexterm>
195        </listitem>
196      </varlistentry>
197
198      <varlistentry id="top">
199        <term><command>top</command></term>
200        <listitem>
201          <para>Displays a list of the most CPU intensive processes; it
202          provides an ongoing look at processor activity in real time</para>
203          <indexterm zone="ch-system-procps-ng top">
204            <primary sortas="b-top">top</primary>
205          </indexterm>
206        </listitem>
207      </varlistentry>
208
209      <varlistentry id="uptime">
210        <term><command>uptime</command></term>
211        <listitem>
212          <para>Reports how long the system has been running, how many users are
213          logged on, and the system load averages</para>
214          <indexterm zone="ch-system-procps-ng uptime">
215            <primary sortas="b-uptime">uptime</primary>
216          </indexterm>
217        </listitem>
218      </varlistentry>
219
220      <varlistentry id="vmstat">
221        <term><command>vmstat</command></term>
222        <listitem>
223          <para>Reports virtual memory statistics, giving information about
224          processes, memory, paging, block Input/Output (IO), traps, and CPU
225          activity</para>
226          <indexterm zone="ch-system-procps-ng vmstat">
227            <primary sortas="b-vmstat">vmstat</primary>
228          </indexterm>
229        </listitem>
230      </varlistentry>
231
232      <varlistentry id="w">
233        <term><command>w</command></term>
234        <listitem>
235          <para>Shows which users are currently logged on, where, and since
236          when</para>
237          <indexterm zone="ch-system-procps-ng w">
238            <primary sortas="b-w">w</primary>
239          </indexterm>
240        </listitem>
241      </varlistentry>
242
243      <varlistentry id="watch">
244        <term><command>watch</command></term>
245        <listitem>
246          <para>Runs a given command repeatedly, displaying the first
247          screen-full of its output; this allows a user to watch the output
248          change over time</para>
249          <indexterm zone="ch-system-procps-ng watch">
250            <primary sortas="b-watch">watch</primary>
251          </indexterm>
252        </listitem>
253      </varlistentry>
254
255      <varlistentry id="libprocps">
256        <term><filename class="libraryfile">libprocps</filename></term>
257        <listitem>
258          <para>Contains the functions used by most programs in this
259          package</para>
260          <indexterm zone="ch-system-procps-ng libprocps">
261            <primary sortas="c-libprocps">libprocps</primary>
262          </indexterm>
263        </listitem>
264      </varlistentry>
265
266    </variablelist>
267
268  </sect2>
269
270</sect1>
Note: See TracBrowser for help on using the repository browser.