source: clfs-sysroot/BOOK/final-system/common/procps.xml@ 0043a50

Last change on this file since 0043a50 was 823185c, checked in by Joe Ciccone <jciccone@…>, 18 years ago

Text Updates.
  • Property mode set to 100644
File size: 8.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 <sect2 role="installation">
26 <title>Installation of Procps</title>
27
28 <para os="s1">The following sed stops the Makefile from trying to install
29 binaries owned by root and prevents ldconfig from being
30 run.</para>
31
32<screen os="s2"><userinput>cp -v Makefile{,.orig}
33sed -e "/^install :=/s/--owner 0 --group 0//" \
34 -e "/^ldconfig :=/s/= ldconfig/=/" Makefile.orig &gt; Makefile</userinput></screen>
35
36 <para os="a">Compile the package:</para>
37
38<screen os="b"><userinput>make</userinput></screen>
39
40 <para os="c">Install the package:</para>
41
42<screen os="d"><userinput>make DESTDIR=${CLFS} lib64=lib install</userinput></screen>
43
44 </sect2>
45
46 <sect2 id="contents-procps" role="content">
47 <title>Contents of Procps</title>
48
49 <segmentedlist>
50 <segtitle>Installed programs</segtitle>
51 <segtitle>Installed library</segtitle>
52
53 <seglistitem>
54 <seg>free, kill, pgrep, pkill, pmap, ps, pwdx, skill, slabtop, snice, sysctl,
55 tload, top, uptime, vmstat, w, and watch</seg>
56 <seg>libproc.so</seg>
57 </seglistitem>
58 </segmentedlist>
59
60 <variablelist>
61 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
62 <?dbfo list-presentation="list"?>
63 <?dbhtml list-presentation="table"?>
64
65 <varlistentry id="free">
66 <term><command>free</command></term>
67 <listitem>
68 <para>Reports the amount of free and used memory (both physical and
69 swap memory) in the system</para>
70 <indexterm zone="ch-system-procps free">
71 <primary sortas="b-free">free</primary>
72 </indexterm>
73 </listitem>
74 </varlistentry>
75
76 <varlistentry id="kill">
77 <term><command>kill</command></term>
78 <listitem>
79 <para>Sends signals to processes</para>
80 <indexterm zone="ch-system-procps kill">
81 <primary sortas="b-kill">kill</primary>
82 </indexterm>
83 </listitem>
84 </varlistentry>
85
86 <varlistentry id="pgrep">
87 <term><command>pgrep</command></term>
88 <listitem>
89 <para>Looks up processes based on their name and other attributes</para>
90 <indexterm zone="ch-system-procps pgrep">
91 <primary sortas="b-pgrep">pgrep</primary>
92 </indexterm>
93 </listitem>
94 </varlistentry>
95
96 <varlistentry id="pkill">
97 <term><command>pkill</command></term>
98 <listitem>
99 <para>Signals processes based on their name and other attributes</para>
100 <indexterm zone="ch-system-procps pkill">
101 <primary sortas="b-pkill">pkill</primary>
102 </indexterm>
103 </listitem>
104 </varlistentry>
105
106 <varlistentry id="pmap">
107 <term><command>pmap</command></term>
108 <listitem>
109 <para>Reports the memory map of the given process</para>
110 <indexterm zone="ch-system-procps pmap">
111 <primary sortas="b-pmap">pmap</primary>
112 </indexterm>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry id="ps">
117 <term><command>ps</command></term>
118 <listitem>
119 <para>Lists the current running processes</para>
120 <indexterm zone="ch-system-procps ps">
121 <primary sortas="b-ps">ps</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="pwdx">
127 <term><command>pwdx</command></term>
128 <listitem>
129 <para>Reports the current working directory of a process</para>
130 <indexterm zone="ch-system-procps pwdx">
131 <primary sortas="b-pwdx">pwdx</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="skill">
137 <term><command>skill</command></term>
138 <listitem>
139 <para>Sends signals to processes matching the given criteria</para>
140 <indexterm zone="ch-system-procps skill">
141 <primary sortas="b-skill">skill</primary>
142 </indexterm>
143 </listitem>
144 </varlistentry>
145
146 <varlistentry id="slabtop">
147 <term><command>slabtop</command></term>
148 <listitem>
149 <para>Displays detailed kernel slab cache information in real time</para>
150 <indexterm zone="ch-system-procps slabtop">
151 <primary sortas="b-slabtop">slabtop</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry id="snice">
157 <term><command>snice</command></term>
158 <listitem>
159 <para>Changes the scheduling priority of processes matching the given
160 criteria</para>
161 <indexterm zone="ch-system-procps snice">
162 <primary sortas="b-snice">snice</primary>
163 </indexterm>
164 </listitem>
165 </varlistentry>
166
167 <varlistentry id="sysctl">
168 <term><command>sysctl</command></term>
169 <listitem>
170 <para>Modifies kernel parameters at run time</para>
171 <indexterm zone="ch-system-procps sysctl">
172 <primary sortas="b-sysctl">sysctl</primary>
173 </indexterm>
174 </listitem>
175 </varlistentry>
176
177 <varlistentry id="tload">
178 <term><command>tload</command></term>
179 <listitem>
180 <para>Prints a graph of the current system load average</para>
181 <indexterm zone="ch-system-procps tload">
182 <primary sortas="b-tload">tload</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 <varlistentry id="top">
188 <term><command>top</command></term>
189 <listitem>
190 <para>Displays a list of the most CPU intensive processes; it
191 provides an ongoing look at processor activity in real time</para>
192 <indexterm zone="ch-system-procps top">
193 <primary sortas="b-top">top</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="uptime">
199 <term><command>uptime</command></term>
200 <listitem>
201 <para>Reports how long the system has been running, how many users are
202 logged on, and the system load averages</para>
203 <indexterm zone="ch-system-procps uptime">
204 <primary sortas="b-uptime">uptime</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="vmstat">
210 <term><command>vmstat</command></term>
211 <listitem>
212 <para>Reports virtual memory statistics, giving information about
213 processes, memory, paging, block Input/Output (IO), traps, and CPU
214 activity</para>
215 <indexterm zone="ch-system-procps vmstat">
216 <primary sortas="b-vmstat">vmstat</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="w">
222 <term><command>w</command></term>
223 <listitem>
224 <para>Shows which users are currently logged on, where, and since
225 when</para>
226 <indexterm zone="ch-system-procps w">
227 <primary sortas="b-w">w</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="watch">
233 <term><command>watch</command></term>
234 <listitem>
235 <para>Runs a given command repeatedly, displaying the first
236 screen-full of its output; this allows a user to watch the output
237 change over time</para>
238 <indexterm zone="ch-system-procps watch">
239 <primary sortas="b-watch">watch</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="libproc">
245 <term><filename class="libraryfile">libproc</filename></term>
246 <listitem>
247 <para>Contains the functions used by most programs in this
248 package</para>
249 <indexterm zone="ch-system-procps libproc">
250 <primary sortas="c-libproc">libproc</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 </variablelist>
256
257 </sect2>
258
259</sect1>
Note: See TracBrowser for help on using the repository browser.