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

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

Text updates for procps-ng

  • 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/bin/pidof /bin
71mv -v /usr/lib/libprocps.so.* /lib
72ln -sfv ../../lib/$(readlink /usr/lib/libprocps.so) /usr/lib/libprocps.so</userinput></screen>
73
74  </sect2>
75
76  <sect2 id="contents-procps-ng" role="content">
77    <title>Contents of Procps-ng</title>
78
79    <segmentedlist>
80      <segtitle>Installed programs</segtitle>
81      <segtitle>Installed library</segtitle>
82      <segtitle>Installed directories</segtitle>
83
84      <seglistitem>
85        <seg>free, pgrep, pidof, pkill, pmap, ps, pwdx, slabtop, sysctl, tload,
86        top, uptime, vmstat, w, watch</seg>
87        <seg>libprocps.{a,so}</seg>
88        <seg>/usr/include/proc, /usr/share/doc/procps-ng-&procps-ng-version;</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="free">
98        <term><command>free</command></term>
99        <listitem>
100          <para>Reports the amount of free and used memory (both physical and
101          swap memory) in the system</para>
102          <indexterm zone="ch-system-procps-ng free">
103            <primary sortas="b-free">free</primary>
104          </indexterm>
105        </listitem>
106      </varlistentry>
107
108      <varlistentry id="pgrep">
109        <term><command>pgrep</command></term>
110        <listitem>
111          <para>Looks up processes based on their name and other attributes</para>
112          <indexterm zone="ch-system-procps-ng pgrep">
113            <primary sortas="b-pgrep">pgrep</primary>
114          </indexterm>
115        </listitem>
116      </varlistentry>
117
118      <varlistentry id="pidof">
119        <term><command>pidof</command></term>
120        <listitem>
121          <para>Looks up processes based on their name and other attributes</para>
122          <indexterm zone="ch-system-procps-ng pidof">
123            <primary sortas="b-pidof">pidof</primary>
124          </indexterm>
125        </listitem>
126      </varlistentry>
127
128      <varlistentry id="pkill">
129        <term><command>pkill</command></term>
130        <listitem>
131          <para>Signals processes based on their name and other attributes</para>
132          <indexterm zone="ch-system-procps-ng pkill">
133            <primary sortas="b-pkill">pkill</primary>
134          </indexterm>
135        </listitem>
136      </varlistentry>
137
138      <varlistentry id="pmap">
139        <term><command>pmap</command></term>
140        <listitem>
141          <para>Reports the memory map of the given process</para>
142          <indexterm zone="ch-system-procps-ng pmap">
143            <primary sortas="b-pmap">pmap</primary>
144          </indexterm>
145        </listitem>
146      </varlistentry>
147
148      <varlistentry id="ps">
149        <term><command>ps</command></term>
150        <listitem>
151          <para>Lists the current running processes</para>
152          <indexterm zone="ch-system-procps-ng ps">
153            <primary sortas="b-ps">ps</primary>
154          </indexterm>
155        </listitem>
156      </varlistentry>
157
158      <varlistentry id="pwdx">
159        <term><command>pwdx</command></term>
160        <listitem>
161          <para>Reports the current working directory of a process</para>
162          <indexterm zone="ch-system-procps-ng pwdx">
163            <primary sortas="b-pwdx">pwdx</primary>
164          </indexterm>
165        </listitem>
166      </varlistentry>
167
168      <varlistentry id="slabtop">
169        <term><command>slabtop</command></term>
170        <listitem>
171          <para>Displays detailed kernel slab cache information in real time</para>
172          <indexterm zone="ch-system-procps-ng slabtop">
173            <primary sortas="b-slabtop">slabtop</primary>
174          </indexterm>
175        </listitem>
176      </varlistentry>
177
178
179      <varlistentry id="sysctl">
180        <term><command>sysctl</command></term>
181        <listitem>
182          <para>Modifies kernel parameters at run time</para>
183          <indexterm zone="ch-system-procps-ng sysctl">
184            <primary sortas="b-sysctl">sysctl</primary>
185          </indexterm>
186        </listitem>
187      </varlistentry>
188
189      <varlistentry id="tload">
190        <term><command>tload</command></term>
191        <listitem>
192          <para>Prints a graph of the current system load average</para>
193          <indexterm zone="ch-system-procps-ng tload">
194            <primary sortas="b-tload">tload</primary>
195          </indexterm>
196        </listitem>
197      </varlistentry>
198
199      <varlistentry id="top">
200        <term><command>top</command></term>
201        <listitem>
202          <para>Displays a list of the most CPU intensive processes; it
203          provides an ongoing look at processor activity in real time</para>
204          <indexterm zone="ch-system-procps-ng top">
205            <primary sortas="b-top">top</primary>
206          </indexterm>
207        </listitem>
208      </varlistentry>
209
210      <varlistentry id="uptime">
211        <term><command>uptime</command></term>
212        <listitem>
213          <para>Reports how long the system has been running, how many users are
214          logged on, and the system load averages</para>
215          <indexterm zone="ch-system-procps-ng uptime">
216            <primary sortas="b-uptime">uptime</primary>
217          </indexterm>
218        </listitem>
219      </varlistentry>
220
221      <varlistentry id="vmstat">
222        <term><command>vmstat</command></term>
223        <listitem>
224          <para>Reports virtual memory statistics, giving information about
225          processes, memory, paging, block Input/Output (IO), traps, and CPU
226          activity</para>
227          <indexterm zone="ch-system-procps-ng vmstat">
228            <primary sortas="b-vmstat">vmstat</primary>
229          </indexterm>
230        </listitem>
231      </varlistentry>
232
233      <varlistentry id="w">
234        <term><command>w</command></term>
235        <listitem>
236          <para>Shows which users are currently logged on, where, and since
237          when</para>
238          <indexterm zone="ch-system-procps-ng w">
239            <primary sortas="b-w">w</primary>
240          </indexterm>
241        </listitem>
242      </varlistentry>
243
244      <varlistentry id="watch">
245        <term><command>watch</command></term>
246        <listitem>
247          <para>Runs a given command repeatedly, displaying the first
248          screen-full of its output; this allows a user to watch the output
249          change over time</para>
250          <indexterm zone="ch-system-procps-ng watch">
251            <primary sortas="b-watch">watch</primary>
252          </indexterm>
253        </listitem>
254      </varlistentry>
255
256      <varlistentry id="libprocps">
257        <term><filename class="libraryfile">libprocps</filename></term>
258        <listitem>
259          <para>Contains the functions used by most programs in this
260          package</para>
261          <indexterm zone="ch-system-procps-ng libprocps">
262            <primary sortas="c-libprocps">libprocps</primary>
263          </indexterm>
264        </listitem>
265      </varlistentry>
266
267    </variablelist>
268
269  </sect2>
270
271</sect1>
Note: See TracBrowser for help on using the repository browser.