aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/procps.xml
blob: 5a5c0e74a70302c23a99faa594b293682e16d9ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-system-procps" xreflabel="Procps" role="wrap">
<title>Procps-&procps-version;</title>
<?dbhtml filename="procps.html"?>

<indexterm zone="ch-system-procps"><primary sortas="a-Procps">Procps</primary></indexterm>

<sect2 role="package"><title/>
<para>The Procps package contains programs for monitoring processes.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>6.2 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Procps installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, GCC, Glibc,
Make, Ncurses</seg></seglistitem>
</segmentedlist>
</sect2>

<sect2 role="installation">
<title>Installation of Procps</title>

<para>Compile Procps:</para>

<screen><userinput>make</userinput></screen>

<para>Install it:</para>

<screen><userinput>make install</userinput></screen>

<para>Remove a spurious library link:</para>

<screen><userinput>rm /lib/libproc.so</userinput></screen>

</sect2>


<sect2 id="contents-procps" role="content"><title>Contents of Procps</title>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>free, kill, pgrep, pkill,
pmap, ps, skill, snice, sysctl, tload, top, uptime, vmstat, w and watch</seg>
<seg>libproc.so</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry id="free">
<term><command>free</command></term>
<listitem>
<indexterm zone="ch-system-procps free"><primary sortas="b-free">free</primary></indexterm>
<para>reports the amount of free and used memory
in the system, both physical and swap memory.</para>
</listitem>
</varlistentry>

<varlistentry id="kill">
<term><command>kill</command></term>
<listitem>
<indexterm zone="ch-system-procps kill"><primary sortas="b-kill">kill</primary></indexterm>
<para>is used to send signals to processes.</para>
</listitem>
</varlistentry>

<varlistentry id="pgrep">
<term><command>pgrep</command></term>
<listitem>
<indexterm zone="ch-system-procps pgrep"><primary sortas="b-pgrep">pgrep</primary></indexterm>
<para>looks up processes based on their name and other attributes.</para>
</listitem>
</varlistentry>

<varlistentry id="pkill">
<term><command>pkill</command></term>
<listitem>
<indexterm zone="ch-system-procps pkill"><primary sortas="b-pkill">pkill</primary></indexterm>
<para>signals processes based on their name and other attributes.</para>
</listitem>
</varlistentry>

<varlistentry id="pmap">
<term><command>pmap</command></term>
<listitem>
<indexterm zone="ch-system-procps pmap"><primary sortas="b-pmap">pmap</primary></indexterm>
<para>reports the memory map of the given process.</para>
</listitem>
</varlistentry>

<varlistentry id="ps">
<term><command>ps</command></term>
<listitem>
<indexterm zone="ch-system-procps ps"><primary sortas="b-ps">ps</primary></indexterm>
<para>gives a snapshot of the current processes.</para>
</listitem>
</varlistentry>

<varlistentry id="skill">
<term><command>skill</command></term>
<listitem>
<indexterm zone="ch-system-procps skill"><primary sortas="b-skill">skill</primary></indexterm>
<para>sends signals to processes matching the given criteria.</para>
</listitem>
</varlistentry>

<varlistentry id="snice">
<term><command>snice</command></term>
<listitem>
<indexterm zone="ch-system-procps snice"><primary sortas="b-snice">snice</primary></indexterm>
<para>changes the scheduling priority of processes matching the given criteria.</para>
</listitem>
</varlistentry>

<varlistentry id="sysctl">
<term><command>sysctl</command></term>
<listitem>
<indexterm zone="ch-system-procps sysctl"><primary sortas="b-sysctl">sysctl</primary></indexterm>
<para>modifies kernel parameters at run time.</para>
</listitem>
</varlistentry>

<varlistentry id="tload">
<term><command>tload</command></term>
<listitem>
<indexterm zone="ch-system-procps tload"><primary sortas="b-tload">tload</primary></indexterm>
<para>prints a graph of the current system load average.</para>
</listitem>
</varlistentry>

<varlistentry id="top">
<term><command>top</command></term>
<listitem>
<indexterm zone="ch-system-procps top"><primary sortas="b-top">top</primary></indexterm>
<para>displays the top CPU processes. It provides
an ongoing look at processor activity in real time.</para>
</listitem>
</varlistentry>

<varlistentry id="uptime">
<term><command>uptime</command></term>
<listitem>
<indexterm zone="ch-system-procps uptime"><primary sortas="b-uptime">uptime</primary></indexterm>
<para>reports how long the system has been
running, how many users are logged on, and the system load averages.</para>
</listitem>
</varlistentry>

<varlistentry id="vmstat">
<term><command>vmstat</command></term>
<listitem>
<indexterm zone="ch-system-procps vmstat"><primary sortas="b-vmstat">vmstat</primary></indexterm>
<para>reports virtual memory statistics, giving information about processes, 
memory, paging, block IO, traps, and CPU activity.</para>
</listitem>
</varlistentry>

<varlistentry id="w">
<term><command>w</command></term>
<listitem>
<indexterm zone="ch-system-procps w"><primary sortas="b-w">w</primary></indexterm>
<para>shows which users are currently logged on, where and since when.</para>
</listitem>
</varlistentry>

<varlistentry id="watch">
<term><command>watch</command></term>
<listitem>
<indexterm zone="ch-system-procps watch"><primary sortas="b-watch">watch</primary></indexterm>
<para>runs a given command repeatedly, displaying the first screen-full of its 
output. This allows you to watch the output change over time.</para>
</listitem>
</varlistentry>

<varlistentry id="libproc">
<term><command>libproc</command></term>
<listitem>
<indexterm zone="ch-system-procps libproc"><primary sortas="c-libproc">libproc</primary></indexterm>
<para>contains the functions used by most programs in this package.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>