source: BOOK/final-system/common/procps.xml @ 979f0f0

clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 979f0f0 was 979f0f0, checked in by Chris Staub <chris@…>, 9 years ago

Fix make version mentioned in procps

  • Property mode set to 100644
File size: 8.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.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 &make-version;:</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 SKIP='/bin/kill /usr/share/man/man1/kill.1' 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, 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="pgrep">
85        <term><command>pgrep</command></term>
86        <listitem>
87          <para>Looks up processes based on their name and other attributes</para>
88          <indexterm zone="ch-system-procps pgrep">
89            <primary sortas="b-pgrep">pgrep</primary>
90          </indexterm>
91        </listitem>
92      </varlistentry>
93
94      <varlistentry id="pkill">
95        <term><command>pkill</command></term>
96        <listitem>
97          <para>Signals processes based on their name and other attributes</para>
98          <indexterm zone="ch-system-procps pkill">
99            <primary sortas="b-pkill">pkill</primary>
100          </indexterm>
101        </listitem>
102      </varlistentry>
103
104      <varlistentry id="pmap">
105        <term><command>pmap</command></term>
106        <listitem>
107          <para>Reports the memory map of the given process</para>
108          <indexterm zone="ch-system-procps pmap">
109            <primary sortas="b-pmap">pmap</primary>
110          </indexterm>
111        </listitem>
112      </varlistentry>
113
114      <varlistentry id="ps">
115        <term><command>ps</command></term>
116        <listitem>
117          <para>Lists the current running processes</para>
118          <indexterm zone="ch-system-procps ps">
119            <primary sortas="b-ps">ps</primary>
120          </indexterm>
121        </listitem>
122      </varlistentry>
123
124      <varlistentry id="pwdx">
125        <term><command>pwdx</command></term>
126        <listitem>
127          <para>Reports the current working directory of a process</para>
128          <indexterm zone="ch-system-procps pwdx">
129            <primary sortas="b-pwdx">pwdx</primary>
130          </indexterm>
131        </listitem>
132      </varlistentry>
133
134      <varlistentry id="skill">
135        <term><command>skill</command></term>
136        <listitem>
137          <para>Sends signals to processes matching the given criteria</para>
138          <indexterm zone="ch-system-procps skill">
139            <primary sortas="b-skill">skill</primary>
140          </indexterm>
141        </listitem>
142      </varlistentry>
143
144      <varlistentry id="slabtop">
145        <term><command>slabtop</command></term>
146        <listitem>
147          <para>Displays detailed kernel slab cache information in real time</para>
148          <indexterm zone="ch-system-procps slabtop">
149            <primary sortas="b-slabtop">slabtop</primary>
150          </indexterm>
151        </listitem>
152      </varlistentry>
153
154      <varlistentry id="snice">
155        <term><command>snice</command></term>
156        <listitem>
157          <para>Changes the scheduling priority of processes matching the given
158          criteria</para>
159          <indexterm zone="ch-system-procps snice">
160            <primary sortas="b-snice">snice</primary>
161          </indexterm>
162        </listitem>
163      </varlistentry>
164
165      <varlistentry id="sysctl">
166        <term><command>sysctl</command></term>
167        <listitem>
168          <para>Modifies kernel parameters at run time</para>
169          <indexterm zone="ch-system-procps sysctl">
170            <primary sortas="b-sysctl">sysctl</primary>
171          </indexterm>
172        </listitem>
173      </varlistentry>
174
175      <varlistentry id="tload">
176        <term><command>tload</command></term>
177        <listitem>
178          <para>Prints a graph of the current system load average</para>
179          <indexterm zone="ch-system-procps tload">
180            <primary sortas="b-tload">tload</primary>
181          </indexterm>
182        </listitem>
183      </varlistentry>
184
185      <varlistentry id="top">
186        <term><command>top</command></term>
187        <listitem>
188          <para>Displays a list of the most CPU intensive processes; it
189          provides an ongoing look at processor activity in real time</para>
190          <indexterm zone="ch-system-procps top">
191            <primary sortas="b-top">top</primary>
192          </indexterm>
193        </listitem>
194      </varlistentry>
195
196      <varlistentry id="uptime">
197        <term><command>uptime</command></term>
198        <listitem>
199          <para>Reports how long the system has been running, how many users are
200          logged on, and the system load averages</para>
201          <indexterm zone="ch-system-procps uptime">
202            <primary sortas="b-uptime">uptime</primary>
203          </indexterm>
204        </listitem>
205      </varlistentry>
206
207      <varlistentry id="vmstat">
208        <term><command>vmstat</command></term>
209        <listitem>
210          <para>Reports virtual memory statistics, giving information about
211          processes, memory, paging, block Input/Output (IO), traps, and CPU
212          activity</para>
213          <indexterm zone="ch-system-procps vmstat">
214            <primary sortas="b-vmstat">vmstat</primary>
215          </indexterm>
216        </listitem>
217      </varlistentry>
218
219      <varlistentry id="w">
220        <term><command>w</command></term>
221        <listitem>
222          <para>Shows which users are currently logged on, where, and since
223          when</para>
224          <indexterm zone="ch-system-procps w">
225            <primary sortas="b-w">w</primary>
226          </indexterm>
227        </listitem>
228      </varlistentry>
229
230      <varlistentry id="watch">
231        <term><command>watch</command></term>
232        <listitem>
233          <para>Runs a given command repeatedly, displaying the first
234          screen-full of its output; this allows a user to watch the output
235          change over time</para>
236          <indexterm zone="ch-system-procps watch">
237            <primary sortas="b-watch">watch</primary>
238          </indexterm>
239        </listitem>
240      </varlistentry>
241
242      <varlistentry id="libproc">
243        <term><filename class="libraryfile">libproc</filename></term>
244        <listitem>
245          <para>Contains the functions used by most programs in this
246          package</para>
247          <indexterm zone="ch-system-procps libproc">
248            <primary sortas="c-libproc">libproc</primary>
249          </indexterm>
250        </listitem>
251      </varlistentry>
252
253    </variablelist>
254
255  </sect2>
256
257</sect1>
Note: See TracBrowser for help on using the repository browser.