source: chapter06/procps.xml@ ffe21e1

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 7.4 7.5 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since ffe21e1 was ffe21e1, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Upgrade to Linux-3.8.1 and other minor touchups

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@10177 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 9.4 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" role="wrap">
9 <?dbhtml filename="procps-ng.html"?>
10
11 <sect1info condition="script">
12 <productname>procps-ng</productname>
13 <productnumber>&procps-ng-version;</productnumber>
14 <address>&procps-ng-url;</address>
15 </sect1info>
16
17 <title>Procps-ng-&procps-ng-version;</title>
18
19 <indexterm zone="ch-system-procps">
20 <primary sortas="a-Procps">Procps-ng</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Procps-ng package contains programs for monitoring processes.</para>
27
28 <segmentedlist>
29 <segtitle>&buildtime;</segtitle>
30 <segtitle>&diskspace;</segtitle>
31
32 <seglistitem>
33 <seg>&procps-ng-ch6-sbu;</seg>
34 <seg>&procps-ng-ch6-du;</seg>
35 </seglistitem>
36 </segmentedlist>
37
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of Procps-ng</title>
42
43 <para>Now prepare procps-ng for compilation:</para>
44
45<screen><userinput remap="configure">./configure --prefix=/usr \
46 --exec-prefix= \
47 --libdir=/usr/lib \
48 --docdir=/usr/share/doc/procps-ng-&procps-ng-version; \
49 --disable-static \
50 --disable-skill \
51 --disable-kill</userinput></screen>
52
53 <variablelist>
54 <title>The meaning of the configure options:</title>
55
56 <varlistentry>
57 <term><parameter>--disable-skill</parameter></term>
58 <listitem>
59 <para>This switch disables the obsolete and unportable
60 skill and snice commands.</para>
61 </listitem>
62 </varlistentry>
63 <varlistentry>
64 <term><parameter>--disable-kill</parameter></term>
65 <listitem>
66 <para>This switch disables building the kill command that
67 was installed in the util-linux package.</para>
68 </listitem>
69 </varlistentry>
70 </variablelist>
71
72 <para>Compile the package:</para>
73
74<screen><userinput remap="make">make</userinput></screen>
75
76 <para>The test suite needs some custom modifications for LFS.
77 The <command>which</command> command is not available, the
78 <command>pmap</command> test does not match a newline character in
79 two tests, and the <command>slabtop</command> test may return more than
80 999,999 objects. To run the test suite, run the following commands:</para>
81
82<screen><userinput remap="test">pushd testsuite
83 sed -i -e 's|exec which sleep|exec echo /tools/bin/sleep|' \
84 -e 's|999999|&amp;9|' config/unix.exp
85 sed -i -e 's|pmap_initname\\\$|pmap_initname|' pmap.test/pmap.exp
86 make site.exp
87 DEJAGNU=global-conf.exp runtest
88popd</userinput></screen>
89
90 <para>Install the package:</para>
91
92<screen><userinput remap="install">make install</userinput></screen>
93
94<para>Finally move the library to a location that can be found if
95<filename class="directory">/usr</filename> is not mounted.</para>
96
97<screen><userinput remap="install">mv -v /usr/lib/libprocps.so.* /lib
98ln -sfv ../../lib/libprocps.so.1.1.0 /usr/lib/libprocps.so</userinput></screen>
99
100 </sect2>
101
102 <sect2 id="contents-procps" role="content">
103 <title>Contents of Procps-ng</title>
104
105 <segmentedlist>
106 <segtitle>Installed programs</segtitle>
107 <segtitle>Installed library</segtitle>
108
109 <seglistitem>
110 <seg>free, pgrep, pkill, pmap, ps, pwdx, slabtop,
111 sysctl, tload, top, uptime, vmstat, w, and, watch</seg>
112 <seg>libprocps.so</seg>
113 </seglistitem>
114 </segmentedlist>
115
116 <variablelist>
117 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
118 <?dbfo list-presentation="list"?>
119 <?dbhtml list-presentation="table"?>
120
121 <varlistentry id="free">
122 <term><command>free</command></term>
123 <listitem>
124 <para>Reports the amount of free and used memory (both physical and
125 swap memory) in the system</para>
126 <indexterm zone="ch-system-procps free">
127 <primary sortas="b-free">free</primary>
128 </indexterm>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry id="pgrep">
133 <term><command>pgrep</command></term>
134 <listitem>
135 <para>Looks up processes based on their name and other attributes</para>
136 <indexterm zone="ch-system-procps pgrep">
137 <primary sortas="b-pgrep">pgrep</primary>
138 </indexterm>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry id="pkill">
143 <term><command>pkill</command></term>
144 <listitem>
145 <para>Signals processes based on their name and other attributes</para>
146 <indexterm zone="ch-system-procps pkill">
147 <primary sortas="b-pkill">pkill</primary>
148 </indexterm>
149 </listitem>
150 </varlistentry>
151
152 <varlistentry id="pmap">
153 <term><command>pmap</command></term>
154 <listitem>
155 <para>Reports the memory map of the given process</para>
156 <indexterm zone="ch-system-procps pmap">
157 <primary sortas="b-pmap">pmap</primary>
158 </indexterm>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry id="ps">
163 <term><command>ps</command></term>
164 <listitem>
165 <para>Lists the current running processes</para>
166 <indexterm zone="ch-system-procps ps">
167 <primary sortas="b-ps">ps</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="pwdx">
173 <term><command>pwdx</command></term>
174 <listitem>
175 <para>Reports the current working directory of a process</para>
176 <indexterm zone="ch-system-procps pwdx">
177 <primary sortas="b-pwdx">pwdx</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="slabtop">
183 <term><command>slabtop</command></term>
184 <listitem>
185 <para>Displays detailed kernel slap cache information in real time</para>
186 <indexterm zone="ch-system-procps slabtop">
187 <primary sortas="b-slabtop">slabtop</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="sysctl">
193 <term><command>sysctl</command></term>
194 <listitem>
195 <para>Modifies kernel parameters at run time</para>
196 <indexterm zone="ch-system-procps sysctl">
197 <primary sortas="b-sysctl">sysctl</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="tload">
203 <term><command>tload</command></term>
204 <listitem>
205 <para>Prints a graph of the current system load average</para>
206 <indexterm zone="ch-system-procps tload">
207 <primary sortas="b-tload">tload</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="top">
213 <term><command>top</command></term>
214 <listitem>
215 <para>Displays a list of the most CPU intensive processes; it
216 provides an ongoing look at processor activity in real time</para>
217 <indexterm zone="ch-system-procps top">
218 <primary sortas="b-top">top</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="uptime">
224 <term><command>uptime</command></term>
225 <listitem>
226 <para>Reports how long the system has been running, how many users are
227 logged on, and the system load averages</para>
228 <indexterm zone="ch-system-procps uptime">
229 <primary sortas="b-uptime">uptime</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="vmstat">
235 <term><command>vmstat</command></term>
236 <listitem>
237 <para>Reports virtual memory statistics, giving information about
238 processes, memory, paging, block Input/Output (IO), traps, and CPU
239 activity</para>
240 <indexterm zone="ch-system-procps vmstat">
241 <primary sortas="b-vmstat">vmstat</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="w">
247 <term><command>w</command></term>
248 <listitem>
249 <para>Shows which users are currently logged on, where, and since
250 when</para>
251 <indexterm zone="ch-system-procps w">
252 <primary sortas="b-w">w</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="watch">
258 <term><command>watch</command></term>
259 <listitem>
260 <para>Runs a given command repeatedly, displaying the first
261 screen-full of its output; this allows a user to watch the output
262 change over time</para>
263 <indexterm zone="ch-system-procps watch">
264 <primary sortas="b-watch">watch</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="libprocps">
270 <term><filename class="libraryfile">libproc</filename></term>
271 <listitem>
272 <para>Contains the functions used by most programs in this
273 package</para>
274 <indexterm zone="ch-system-procps libprocps">
275 <primary sortas="c-libprocps">libprocps</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 </variablelist>
281
282 </sect2>
283
284</sect1>
Note: See TracBrowser for help on using the repository browser.