source: clfs-sysroot/BOOK/final-system/common/procps.xml @ 59fb197

Last change on this file since 59fb197 was 02095ae, checked in by Jim Gifford <clfs@…>, 18 years ago

r3633@server (orig r1649): jciccone | 2006-05-25 16:48:42 -0700
Added the Initial clfs-2.0 branch using sysroot builds.

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