source: BOOK/final-system/common/procps.xml @ 6d1db7d

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 6d1db7d was 6d1db7d, checked in by Joe Ciccone <jciccone@…>, 13 years ago

Added a patch to procps to fix an issue when the
screen refresh rate isn't 60Hz.

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