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

sysvinit
Last change on this file since b27081c4 was b27081c4, checked in by Chris Staub <chris@…>, 8 years ago

Put one configure option per line

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