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

clfs-3.0.0-sysvinit sysvinit
Last change on this file since 357e89c was a7f82653, checked in by Chris Staub <chris@…>, 10 years ago

Text update

  • 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 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. 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 <filename class="directory">/usr</filename> is not mounted.</para>
68
69<screen os="k"><userinput>mv -v /usr/bin/pidof /bin
70mv -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>Looks up processes based on their name and other attributes</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.