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

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

Put one configure option per line

  • Property mode set to 100644
File size: 9.0 KB
RevLine 
[d228eef]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
[b27081c4]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; \
[d228eef]35 --disable-kill</userinput></screen>
36
37 <variablelist os="c">
[24b004c]38 <title>The meaning of the configure options:</title>
[d228eef]39 <varlistentry>
40 <term><parameter>--disable-kill</parameter></term>
41 <listitem>
[d910285]42 <para>This switch disables building the <command>kill</command>
43 program - a better version was installed by the Util-linux package.</para>
[d228eef]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
[8699cff]52 <note os="note1">
53 <para>When using the boot method, two tests will fail if the hostname is
[a7f82653]54 not set. If you have booted the temporary system, and want to run the
55 test suite, run the following command:</para>
[8699cff]56
57<screen><userinput remap="test">hostname clfs</userinput></screen>
58 </note>
59
[a7f82653]60 <para os="f">If running the testsuite, first disable a test which fails
61 when scripting does not use a tty device:</para>
[d228eef]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
[d910285]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>
[d228eef]72
[b95fd36]73<screen os="k"><userinput>mv -v /usr/lib/libprocps.so.* /lib
[d228eef]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>
[b4bf2c5]84 <segtitle>Installed directories</segtitle>
[d228eef]85
86 <seglistitem>
87 <seg>free, pgrep, pidof, pkill, pmap, ps, pwdx, slabtop, sysctl, tload,
[c2102b28]88 top, uptime, vmstat, w, watch</seg>
[b4bf2c5]89 <seg>libprocps.{a,so}</seg>
90 <seg>/usr/include/proc, /usr/share/doc/procps-ng-&procps-ng-version;</seg>
[d228eef]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
[a4fd97e]120 <varlistentry id="pidof">
[d228eef]121 <term><command>pidof</command></term>
122 <listitem>
[a4fd97e]123 <para>Reports the PIDs of the given programs</para>
[d228eef]124 <indexterm zone="ch-system-procps-ng pidof">
125 <primary sortas="b-pidof">pidof</primary>
126 </indexterm>
127 </listitem>
[a4fd97e]128 </varlistentry>
[d228eef]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
[b4bf2c5]258 <varlistentry id="libprocps">
259 <term><filename class="libraryfile">libprocps</filename></term>
[d228eef]260 <listitem>
261 <para>Contains the functions used by most programs in this
262 package</para>
[b4bf2c5]263 <indexterm zone="ch-system-procps-ng libprocps">
264 <primary sortas="c-libprocps">libprocps</primary>
[d228eef]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.