source: clfs-sysroot/BOOK/final-system/common/procps.xml@ 9e7e74c

Last change on this file since 9e7e74c was a6c1085, checked in by Joe Ciccone <jciccone@…>, 15 years ago

Updated Procps to 3.2.8.

  • Property mode set to 100644
File size: 8.9 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.html"?>
10
11 <title>Procps-&procps-version;</title>
12
13 <indexterm zone="ch-system-procps">
14 <primary sortas="a-Procps">Procps</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Procps package contains programs for monitoring
21 processes.</para>
22
23 </sect2>
24
25 &env-target;
26
27 <sect2 role="installation">
28 <title>Installation of Procps</title>
29
30 <para os="a">Compile the package:</para>
31
32<screen os="b"><userinput>make CPPFLAGS= lib64=lib m64=</userinput></screen>
33
34 <para os="c">Install the package:</para>
35
36<screen os="d"><userinput>make DESTDIR=${CLFS} lib64=lib m64= ldconfig= \
37 install="install -D" install</userinput></screen>
38
39 <variablelist os="e">
40 <title>The meaning of the make options:</title>
41 <varlistentry>
42 <term><parameter>CPPFLAGS=</parameter></term>
43 <listitem>
44 <para>By default, procps tries to include the host system
45 ncurses headers, so we have to disable that.</para>
46 </listitem>
47 </varlistentry>
48
49 <varlistentry>
50 <term><parameter>lib64=lib</parameter></term>
51 <listitem>
52 <para>By default, procps will attempt to install into
53 <filename class="directory">/lib64</filename> if it
54 exists, even if the package is not built 64-bit. This option
55 forces procps to install its libraries into
56 <filename class="directory">/lib</filename> instead.</para>
57 </listitem>
58 </varlistentry>
59 </variablelist>
60
61 </sect2>
62
63 <sect2 id="contents-procps" role="content">
64 <title>Contents of Procps</title>
65
66 <segmentedlist>
67 <segtitle>Installed programs</segtitle>
68 <segtitle>Installed library</segtitle>
69
70 <seglistitem>
71 <seg>free, kill, pgrep, pkill, pmap, ps, pwdx, skill, slabtop, snice, sysctl,
72 tload, top, uptime, vmstat, w, and watch</seg>
73 <seg>libproc.so</seg>
74 </seglistitem>
75 </segmentedlist>
76
77 <variablelist>
78 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
79 <?dbfo list-presentation="list"?>
80 <?dbhtml list-presentation="table"?>
81
82 <varlistentry id="free">
83 <term><command>free</command></term>
84 <listitem>
85 <para>Reports the amount of free and used memory (both physical and
86 swap memory) in the system</para>
87 <indexterm zone="ch-system-procps free">
88 <primary sortas="b-free">free</primary>
89 </indexterm>
90 </listitem>
91 </varlistentry>
92
93 <varlistentry id="kill">
94 <term><command>kill</command></term>
95 <listitem>
96 <para>Sends signals to processes</para>
97 <indexterm zone="ch-system-procps kill">
98 <primary sortas="b-kill">kill</primary>
99 </indexterm>
100 </listitem>
101 </varlistentry>
102
103 <varlistentry id="pgrep">
104 <term><command>pgrep</command></term>
105 <listitem>
106 <para>Looks up processes based on their name and other attributes</para>
107 <indexterm zone="ch-system-procps pgrep">
108 <primary sortas="b-pgrep">pgrep</primary>
109 </indexterm>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry id="pkill">
114 <term><command>pkill</command></term>
115 <listitem>
116 <para>Signals processes based on their name and other attributes</para>
117 <indexterm zone="ch-system-procps pkill">
118 <primary sortas="b-pkill">pkill</primary>
119 </indexterm>
120 </listitem>
121 </varlistentry>
122
123 <varlistentry id="pmap">
124 <term><command>pmap</command></term>
125 <listitem>
126 <para>Reports the memory map of the given process</para>
127 <indexterm zone="ch-system-procps pmap">
128 <primary sortas="b-pmap">pmap</primary>
129 </indexterm>
130 </listitem>
131 </varlistentry>
132
133 <varlistentry id="ps">
134 <term><command>ps</command></term>
135 <listitem>
136 <para>Lists the current running processes</para>
137 <indexterm zone="ch-system-procps ps">
138 <primary sortas="b-ps">ps</primary>
139 </indexterm>
140 </listitem>
141 </varlistentry>
142
143 <varlistentry id="pwdx">
144 <term><command>pwdx</command></term>
145 <listitem>
146 <para>Reports the current working directory of a process</para>
147 <indexterm zone="ch-system-procps pwdx">
148 <primary sortas="b-pwdx">pwdx</primary>
149 </indexterm>
150 </listitem>
151 </varlistentry>
152
153 <varlistentry id="skill">
154 <term><command>skill</command></term>
155 <listitem>
156 <para>Sends signals to processes matching the given criteria</para>
157 <indexterm zone="ch-system-procps skill">
158 <primary sortas="b-skill">skill</primary>
159 </indexterm>
160 </listitem>
161 </varlistentry>
162
163 <varlistentry id="slabtop">
164 <term><command>slabtop</command></term>
165 <listitem>
166 <para>Displays detailed kernel slab cache information in real time</para>
167 <indexterm zone="ch-system-procps slabtop">
168 <primary sortas="b-slabtop">slabtop</primary>
169 </indexterm>
170 </listitem>
171 </varlistentry>
172
173 <varlistentry id="snice">
174 <term><command>snice</command></term>
175 <listitem>
176 <para>Changes the scheduling priority of processes matching the given
177 criteria</para>
178 <indexterm zone="ch-system-procps snice">
179 <primary sortas="b-snice">snice</primary>
180 </indexterm>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry id="sysctl">
185 <term><command>sysctl</command></term>
186 <listitem>
187 <para>Modifies kernel parameters at run time</para>
188 <indexterm zone="ch-system-procps sysctl">
189 <primary sortas="b-sysctl">sysctl</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="tload">
195 <term><command>tload</command></term>
196 <listitem>
197 <para>Prints a graph of the current system load average</para>
198 <indexterm zone="ch-system-procps tload">
199 <primary sortas="b-tload">tload</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="top">
205 <term><command>top</command></term>
206 <listitem>
207 <para>Displays a list of the most CPU intensive processes; it
208 provides an ongoing look at processor activity in real time</para>
209 <indexterm zone="ch-system-procps top">
210 <primary sortas="b-top">top</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="uptime">
216 <term><command>uptime</command></term>
217 <listitem>
218 <para>Reports how long the system has been running, how many users are
219 logged on, and the system load averages</para>
220 <indexterm zone="ch-system-procps uptime">
221 <primary sortas="b-uptime">uptime</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="vmstat">
227 <term><command>vmstat</command></term>
228 <listitem>
229 <para>Reports virtual memory statistics, giving information about
230 processes, memory, paging, block Input/Output (IO), traps, and CPU
231 activity</para>
232 <indexterm zone="ch-system-procps vmstat">
233 <primary sortas="b-vmstat">vmstat</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="w">
239 <term><command>w</command></term>
240 <listitem>
241 <para>Shows which users are currently logged on, where, and since
242 when</para>
243 <indexterm zone="ch-system-procps w">
244 <primary sortas="b-w">w</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="watch">
250 <term><command>watch</command></term>
251 <listitem>
252 <para>Runs a given command repeatedly, displaying the first
253 screen-full of its output; this allows a user to watch the output
254 change over time</para>
255 <indexterm zone="ch-system-procps watch">
256 <primary sortas="b-watch">watch</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="libproc">
262 <term><filename class="libraryfile">libproc</filename></term>
263 <listitem>
264 <para>Contains the functions used by most programs in this
265 package</para>
266 <indexterm zone="ch-system-procps libproc">
267 <primary sortas="c-libproc">libproc</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 </variablelist>
273
274 </sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.