← Back to branch summary

~noskcaj/ubuntu/vivid/gnome-system-monitor/3.15

« back to all changes in this revision

Viewing changes to help/C/gnome-system-monitor.xml

  • Committer: Package Import Robot
  • Author(s): Andreas Henriksson
  • Date: 2013-03-22 16:44:14 UTC
  • mfrom: (1.5.1) (2.2.1 sid)
  • mto: (2.2.2 sid)
  • mto: This revision was merged to the branch mainline in revision 100.
  • Revision ID: package-import@ubuntu.com-20130322164414-lg3x8lv9owt6cfnl
Tags: 3.7.92-1
* New upstream release.
* Bump build-dependencies according to configure.ac:
  - libgtk-3-dev bumped from (>= 3.0.0) to (>= 3.5.12)
  - libgtkmm-3.0-dev bumped from (>= 2.99) to (>= 3.3.18)
* Change build-dependencies for new documentation infrastructure:
 - drop gnome-doc-tools
 - add yelp-tools and itstool
* Drop patches
  - 03_dont_show_in_KDE.patch and 04_kfreebsd_cputime.patch both
    applied upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/C/gnome-system-monitor.xml
1
 
<?xml version="1.0"?>
2
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
 
  <!ENTITY legal SYSTEM "legal.xml">
5
 
  <!ENTITY appversion "2.24.4">
6
 
  <!ENTITY manrevision "2.2">
7
 
  <!ENTITY date "March 2009">
8
 
  <!ENTITY app "System Monitor">
9
 
]>
10
 
 
11
 
<!--
12
 
      (Do not remove this comment block.)
13
 
  Maintained by the GNOME Documentation Project
14
 
  http://developer.gnome.org/projects/gdp
15
 
  Template version: 2.0 beta
16
 
  Template last modified Apr 11, 2002
17
 
-->
18
 
<!-- =============Document Header ============================= -->
19
 
<article id="index" lang="en">
20
 
<!-- please do not change the id; for translations, change lang to -->
21
 
<!-- appropriate code -->
22
 
  <articleinfo>
23
 
    <title>&app; Manual V&manrevision;</title>
24
 
 
25
 
    <copyright>
26
 
      <year>2009</year>
27
 
      <holder>Paul Cutler</holder>
28
 
    </copyright>
29
 
    <copyright>
30
 
      <year>2004</year>
31
 
      <holder>Sun Microsystems</holder>
32
 
    </copyright>
33
 
    <copyright>
34
 
      <year>2001</year>
35
 
      <year>2002</year>
36
 
      <year>2004</year>
37
 
      <holder>Bill Day</holder>
38
 
    </copyright>
39
 
 
40
 
<!-- translators: uncomment this:
41
 
  <copyright>
42
 
   <year>2002</year>
43
 
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
44
 
  </copyright>
45
 
   -->
46
 
 
47
 
    <publisher role="maintainer">
48
 
      <publishername> GNOME Documentation Project </publishername>
49
 
    </publisher>
50
 
 
51
 
   &legal;
52
 
   <!-- This file  contains link to license for the documentation (GNU FDL), and
53
 
        other legal stuff such as "NO WARRANTY" statement. Please do not change
54
 
        any of this. -->
55
 
 
56
 
  <authorgroup>
57
 
    <author>
58
 
      <firstname>Sun</firstname>
59
 
      <surname>GNOME Documentation Team</surname>
60
 
      <affiliation><orgname>Sun Microsystems</orgname></affiliation>
61
 
    </author>
62
 
    <author>
63
 
      <firstname>Bill</firstname>
64
 
      <surname>Day</surname>
65
 
      <affiliation><address><email>billday@bellatlantic.net</email></address></affiliation>
66
 
    </author>
67
 
      <author>
68
 
        <firstname>Paul</firstname>
69
 
        <surname>Cutler</surname>
70
 
        <affiliation>
71
 
          <orgname>GNOME Documentation Project</orgname>
72
 
          <address><email>pcutler@foresightlinux.org</email></address>
73
 
        </affiliation>
74
 
      </author>
75
 
 
76
 
<!-- This is appropriate place for other contributors: translators,
77
 
     maintainers,  etc. Commented out by default.
78
 
 
79
 
    <othercredit role="translator">
80
 
      <firstname>Latin</firstname>
81
 
      <surname>Translator 1</surname>
82
 
      <affiliation>
83
 
        <orgname>Latin Translation Team</orgname>
84
 
        <address> <email>translator@gnome.org</email> </address>
85
 
      </affiliation>
86
 
      <contrib>Latin translation</contrib>
87
 
    </othercredit>
88
 
-->
89
 
    </authorgroup>
90
 
 
91
 
    <releaseinfo revision="2.28" role="review">
92
 
      <ulink type="review" url="http://bugzilla.gnome.org/show_bug.cgi?id=500559"/>
93
 
    </releaseinfo>
94
 
 
95
 
    <revhistory>
96
 
      <revision>
97
 
        <revnumber>System Monitor Manual V&manrevision;</revnumber>
98
 
        <date>March 2009</date>
99
 
        <revdescription>
100
 
          <para role="author">Paul Cutler
101
 
            <email>pcutler@foresightlinux.org</email>
102
 
          </para>
103
 
          <para role="publisher">GNOME Documentation Project</para>
104
 
        </revdescription>
105
 
      </revision>
106
 
      <revision>
107
 
        <revnumber>System Monitor Manual V2.1</revnumber>
108
 
        <date>February 2004</date>
109
 
        <revdescription>
110
 
          <para role="author">Sun GNOME Documentation Team</para>
111
 
          <para role="publisher">GNOME Documentation Project</para>
112
 
        </revdescription>
113
 
      </revision>
114
 
      <revision>
115
 
        <revnumber>System Monitor Manual V2.0</revnumber>
116
 
        <date>November 2002</date>
117
 
        <revdescription>
118
 
          <para role="author">Bill Day <email>billday@bellatlantic.net</email>
119
 
          </para>
120
 
          <para role="publisher">GNOME Documentation Project</para>
121
 
        </revdescription>
122
 
      </revision>
123
 
      <revision>
124
 
        <revnumber>Procman Manual V0.11</revnumber>
125
 
        <date>January 2002</date>
126
 
        <revdescription>
127
 
          <para role="author">Bill Day
128
 
            <email>billday@bellatlantic.net</email>
129
 
          </para>
130
 
          <para role="publisher">GNOME Documentation Project</para>
131
 
        </revdescription>
132
 
      </revision>
133
 
    </revhistory>
134
 
 
135
 
    <releaseinfo>
136
 
      This manual describes version &appversion; of &app;.
137
 
    </releaseinfo>
138
 
 
139
 
    <legalnotice>
140
 
      <title>Feedback</title>
141
 
      <para>
142
 
        To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.
143
 
      </para>
144
 
 
145
 
<!-- Translators may also add here feedback address for translations -->
146
 
 
147
 
    </legalnotice>
148
 
    <abstract role="description">
149
 
      <para>
150
 
        &app; gives users a graphical user interface for monitoring CPU,
151
 
        network, and memory activities as well as a way for viewing
152
 
        and stopping system processes.
153
 
      </para>
154
 
    </abstract>
155
 
  </articleinfo>
156
 
 
157
 
  <indexterm zone="index">
158
 
    <primary>System Monitor</primary>
159
 
  </indexterm>
160
 
  <indexterm zone="index">
161
 
    <primary>gnome-system-monitor</primary>
162
 
  </indexterm>
163
 
  <indexterm zone="index">
164
 
    <primary>procman</primary>
165
 
  </indexterm>
166
 
 
167
 
<!-- ============= Document Body ============================= -->
168
 
 <!-- ============= Introduction ============================== -->
169
 
  <sect1 id="gnome-system-monitor-intro">
170
 
    <title>Introduction</title>
171
 
    <para>
172
 
      The <application>&app;</application> application enables you to display basic system information and monitor system processes, usage of system resources, and file systems. You can also use <application>&app;</application> to modify the behavior of your system.
173
 
    </para>
174
 
    <para>
175
 
      The <application>&app;</application> window contains four tabbed sections:
176
 
    </para>
177
 
    <variablelist>
178
 
      <varlistentry>
179
 
        <term>
180
 
          <guilabel>System</guilabel>
181
 
        </term>
182
 
        <listitem>
183
 
          <para>Displays various basic information about the computer's hardware and software.</para>
184
 
          <variablelist>
185
 
            <varlistentry>
186
 
              <term>
187
 
                Distribution
188
 
              </term>
189
 
              <listitem>
190
 
                <itemizedlist>
191
 
                  <listitem>
192
 
                    <para>Distribution version</para>
193
 
                  </listitem>
194
 
                  <listitem>
195
 
                    <para>Linux Kernel version</para>
196
 
                  </listitem>
197
 
                  <listitem>
198
 
                    <para>GNOME version</para>
199
 
                  </listitem>
200
 
                </itemizedlist>
201
 
              </listitem>
202
 
            </varlistentry>
203
 
            <varlistentry>
204
 
              <term>
205
 
                Hardware
206
 
              </term>
207
 
              <listitem>
208
 
                <itemizedlist>
209
 
                  <listitem>
210
 
                    <para>Installed memory</para>
211
 
                  </listitem>
212
 
                  <listitem>
213
 
                    <para>Processors and speeds</para>
214
 
                  </listitem>
215
 
                </itemizedlist>
216
 
              </listitem>
217
 
            </varlistentry>
218
 
            <varlistentry>
219
 
              <term>
220
 
                System Status
221
 
              </term>
222
 
              <listitem>
223
 
                <itemizedlist>
224
 
                  <listitem>
225
 
                    <para>Currently available disk space</para>
226
 
                  </listitem>
227
 
                </itemizedlist>
228
 
              </listitem>
229
 
            </varlistentry>
230
 
          </variablelist>
231
 
        </listitem>
232
 
      </varlistentry>
233
 
      <varlistentry>
234
 
        <term>
235
 
          <guilabel>Processes</guilabel>
236
 
        </term>
237
 
        <listitem>
238
 
          <para>
239
 
            Shows active processes, and how processes are related to each other. Provides detailed information about individual processes, and enables you to control active processes.
240
 
          </para>
241
 
        </listitem>
242
 
      </varlistentry>
243
 
      <varlistentry>
244
 
        <term>
245
 
          <guilabel>Resources</guilabel>
246
 
        </term>
247
 
        <listitem>
248
 
          <para>
249
 
            Displays the current usage of the following system resources:
250
 
          </para>
251
 
          <itemizedlist>
252
 
            <listitem>
253
 
              <para>
254
 
                CPU (central processing unit) time
255
 
              </para>
256
 
            </listitem>
257
 
            <listitem>
258
 
              <para>
259
 
                Memory and swap space
260
 
              </para>
261
 
            </listitem>
262
 
            <listitem>
263
 
              <para>
264
 
                Network usage
265
 
              </para>
266
 
            </listitem>
267
 
          </itemizedlist>
268
 
        </listitem>
269
 
      </varlistentry>
270
 
      <varlistentry>
271
 
        <term>
272
 
          <guilabel>File Systems</guilabel>
273
 
        </term>
274
 
        <listitem>
275
 
          <para>
276
 
            Lists all mounted file systems along with basic information about each.
277
 
          </para>
278
 
        </listitem>
279
 
      </varlistentry>
280
 
    </variablelist>
281
 
  </sect1>
282
 
 
283
 
<!-- ============= Getting Started =========================== -->
284
 
  <sect1 id="gnome-system-monitor-getting-started">
285
 
    <title>Getting Started</title>
286
 
 
287
 
<!-- ============= To Start System Monitor ============================ -->
288
 
    <sect2 id="gnome-system-monitor-to-start">
289
 
      <title>To Start &app;</title>
290
 
      <para>You can start <application>&app;</application> in the following ways:</para>
291
 
      <variablelist>
292
 
        <varlistentry>
293
 
          <term><guimenu>System</guimenu> menu</term>
294
 
          <listitem>
295
 
            <para>
296
 
              Choose <menuchoice><guimenu>Administration</guimenu> <guimenuitem>System Monitor</guimenuitem></menuchoice>.
297
 
            </para>
298
 
          </listitem>
299
 
        </varlistentry>
300
 
        <varlistentry>
301
 
          <term>Command line</term>
302
 
          <listitem>
303
 
            <para>
304
 
              Execute the following command: <command>gnome-system-monitor</command></para>
305
 
          </listitem>
306
 
        </varlistentry>
307
 
      </variablelist>
308
 
    </sect2>
309
 
 
310
 
    <sect2 id="gnome-system-monitor-when-you-start">
311
 
      <title>When You Start &app;</title>
312
 
      <para>
313
 
        When you start <application>&app;</application>, the following window is displayed:
314
 
      </para>
315
 
      <figure id="gnome-system-monitor-window">
316
 
        <title>&app; Window</title>
317
 
        <screenshot>
318
 
          <mediaobject>
319
 
            <imageobject>
320
 
              <imagedata fileref="figures/gnome-system-monitor_window.png" format="PNG"/>
321
 
            </imageobject>
322
 
            <textobject> <phrase>Shows System Monitor main window.</phrase>
323
 
            </textobject>
324
 
          </mediaobject>
325
 
        </screenshot>
326
 
      </figure>
327
 
      <para>
328
 
        The <application>&app;</application> window contains the following elements:
329
 
      </para>
330
 
      <variablelist>
331
 
        <varlistentry>
332
 
          <term>Menubar</term>
333
 
          <listitem>
334
 
            <para>
335
 
              The menus on the menubar contain all of the commands that you need to work with <application>&app;</application>.
336
 
            </para>
337
 
          </listitem>
338
 
        </varlistentry>
339
 
        <varlistentry>
340
 
          <term>Display area</term>
341
 
          <listitem>
342
 
            <para>
343
 
              The display area contains the system monitor information. The display area contains the following tabbed sections:
344
 
            </para>
345
 
            <itemizedlist>
346
 
              <listitem>
347
 
                <para>
348
 
                  <guilabel>System</guilabel>
349
 
                </para>
350
 
                <para>
351
 
                  Contains a list of basic system properties, such as system software versions and hardware specifications and status.
352
 
                </para>
353
 
              </listitem>
354
 
              <listitem>
355
 
                <para>
356
 
                  <guilabel>Processes</guilabel>
357
 
                </para>
358
 
                <para>
359
 
                  Contains a list of processes organized as a table, a list of load averages over the past few minutes, and an <guibutton>End Process</guibutton> button.
360
 
                </para>
361
 
              </listitem>
362
 
              <listitem>
363
 
                <para>
364
 
                  <guilabel>Resources</guilabel>
365
 
                </para>
366
 
                <para>
367
 
                  Contains a <guilabel>CPU History</guilabel> graph, a <guilabel>Memory and Swap History</guilabel> graph, and a <guilabel>Network History</guilabel> graph.
368
 
                </para>
369
 
              </listitem>
370
 
              <listitem>
371
 
                <para>
372
 
                  <guilabel>File Systems</guilabel>
373
 
                </para>
374
 
                <para>
375
 
                  Contains a table of currently mounted file systems.
376
 
                </para>
377
 
              </listitem>
378
 
            </itemizedlist>
379
 
          </listitem>
380
 
        </varlistentry>
381
 
        <varlistentry>
382
 
          <term>Statusbar</term>
383
 
          <listitem>
384
 
            <para>
385
 
              The statusbar displays information about current <application>&app;</application> activity and contextual information about the menu items.
386
 
            </para>
387
 
          </listitem>
388
 
        </varlistentry>
389
 
      </variablelist>
390
 
    </sect2>
391
 
  </sect1>
392
 
 
393
 
 
394
 
 <!-- ================ Usage ================================ -->
395
 
 <!-- This section should describe basic usage of the application. -->
396
 
 
397
 
  <sect1 id="gnome-system-monitor-usage">
398
 
    <title>Usage</title>
399
 
 
400
 
    <sect2 id="gnome-system-monitor-display-basic-info">
401
 
      <title>To Display Basic System Information</title>
402
 
      <para>
403
 
        To display basic system information, select the <guilabel>System</guilabel> tab.
404
 
      </para>
405
 
      <para>
406
 
        In the <guilabel>System</guilabel> tab, information is organized into three groups:
407
 
      </para>
408
 
      <itemizedlist>
409
 
        <listitem>
410
 
          <para>
411
 
            System Information
412
 
          </para>
413
 
        </listitem>
414
 
        <listitem>
415
 
          <para>
416
 
            Hardware
417
 
          </para>
418
 
        </listitem>
419
 
        <listitem>
420
 
          <para>
421
 
            System Status
422
 
          </para>
423
 
        </listitem>
424
 
      </itemizedlist>
425
 
    </sect2>
426
 
 
427
 
    <sect2 id="gnome-system-monitor-display-processlist">
428
 
      <title>To Display the Process List</title>
429
 
      <para>
430
 
        To display the process list, select the <guilabel>Processes</guilabel> tab.
431
 
      </para>
432
 
      <para>
433
 
        In the <guilabel>Processes</guilabel> tab, the processes are organized as a table. The rows of the table display information about the processes. The columns represent information fields for the processes, such as the name of the user who owns the process, the amount of memory currently being used by the process, and so on. From left to right, the <guilabel>Processes</guilabel> tab displays the following columns by default:
434
 
      </para>
435
 
      <itemizedlist>
436
 
          <listitem>
437
 
            <para>Process Name</para>
438
 
          </listitem>
439
 
          <listitem>
440
 
            <para>Status</para>
441
 
          </listitem>
442
 
          <listitem>
443
 
            <para>%CPU</para>
444
 
          </listitem>
445
 
          <listitem>
446
 
            <para>Nice</para>
447
 
          </listitem>
448
 
          <listitem>
449
 
            <para>ID</para>
450
 
          </listitem>
451
 
          <listitem>
452
 
            <para>Memory</para>
453
 
          </listitem>
454
 
      </itemizedlist>
455
 
        <para>
456
 
          For information about how to change the columns displayed in the process list, see <xref linkend="gnome-system-monitor-prefs-proclist"/>.
457
 
        </para>
458
 
 
459
 
      <sect3 id="gnome-system-monitor-display-processlist-child">
460
 
        <title>Parent Processes and Child Processes</title>
461
 
        <para>
462
 
          A parent process is a process that spawns another process. The spawned process is a child process of the original parent process. By default, <application>&app;</application> does not show process dependencies. For information about how to change the default display behavior, see <xref linkend="gnome-system-monitor-modify-processlist-viewdeps"/>.
463
 
        </para>
464
 
      </sect3>
465
 
 
466
 
      <sect3 id="gnome-system-monitor-display-processlist-priority">
467
 
        <title>Process Priority and Nice Values</title>
468
 
      <para>
469
 
        Processes run in order of priority: high-priority processes run before low-priority processes. Child processes generally inherit their priority from their parent process.
470
 
      </para>
471
 
      <para>
472
 
        The priority of a process is set by the nice value of the process, as follows:
473
 
      </para>
474
 
      <itemizedlist>
475
 
        <listitem>
476
 
          <para>
477
 
            A nice value of 0 means that the process has normal priority.
478
 
          </para>
479
 
        </listitem>
480
 
        <listitem>
481
 
          <para>
482
 
            The higher the nice value, the lower the priority.
483
 
          </para>
484
 
        </listitem>
485
 
        <listitem>
486
 
          <para>
487
 
            The lower the nice value, the higher the priority.
488
 
          </para>
489
 
        </listitem>
490
 
      </itemizedlist>
491
 
      <para>
492
 
        For information about how to change the priority of a process, see <xref linkend="gnome-system-monitor-change-priority"/>.
493
 
      </para>
494
 
      </sect3>
495
 
 
496
 
    </sect2>
497
 
 
498
 
    <sect2 id="gnome-system-monitor-sort-processlist">
499
 
      <title>To Sort the Process List</title>
500
 
      <para>
501
 
        To sort the process list, perform the following steps:
502
 
      </para>
503
 
      <orderedlist>
504
 
        <listitem>
505
 
          <para>
506
 
            Select the <guilabel>Processes</guilabel> tab to display the process list.
507
 
          </para>
508
 
        </listitem>
509
 
        <listitem>
510
 
          <para>
511
 
            By default, the processes are listed by name, in alphabetical order. To list the processes in reverse alphabetical order, click on the <guilabel>Process Name</guilabel> column header.
512
 
          </para>
513
 
        </listitem>
514
 
        <listitem>
515
 
          <para>
516
 
            Click on any column header to sort the processes by the information in that column, in alphabetical or numerical order.
517
 
          </para>
518
 
        </listitem>
519
 
        <listitem>
520
 
          <para>
521
 
            Click again on the column header to sort the data in reverse alphabetical or reverse numerical order.
522
 
          </para>
523
 
        </listitem>
524
 
      </orderedlist>
525
 
    </sect2>
526
 
 
527
 
    <sect2 id="gnome-system-monitor-modify-processlist">
528
 
      <title>To Modify the Contents of the Process List</title>
529
 
      <para>
530
 
        You can modify the contents of the process list in several ways.
531
 
      </para>
532
 
 
533
 
      <sect3 id="gnome-system-monitor-modify-processlist-all">
534
 
        <title>To Show All Processes</title>
535
 
        <para>
536
 
          To show all processes in the process list, perform the following steps:
537
 
        </para>
538
 
        <orderedlist>
539
 
          <listitem>
540
 
            <para>
541
 
              Select the <guilabel>Processes</guilabel> tab to display the process list.
542
 
            </para>
543
 
          </listitem>
544
 
          <listitem>
545
 
            <para>
546
 
              Choose
547
 
              <menuchoice>
548
 
                <guimenu>View</guimenu>
549
 
                <guimenuitem>All Processes</guimenuitem>
550
 
              </menuchoice>.
551
 
            </para>
552
 
          </listitem>
553
 
        </orderedlist>
554
 
      </sect3>
555
 
 
556
 
      <sect3 id="gnome-system-monitor-modify-processlist-my">
557
 
        <title>To Show Only Processes Owned by the Current User</title>
558
 
        <para>
559
 
          To show only the processes that are owned by the current user, perform the following steps:
560
 
        </para>
561
 
        <orderedlist>
562
 
          <listitem>
563
 
            <para>
564
 
              Select the <guilabel>Processes</guilabel> tab to display the process list.
565
 
            </para>
566
 
          </listitem>
567
 
          <listitem>
568
 
            <para>
569
 
              Choose
570
 
              <menuchoice>
571
 
                <guimenu>View</guimenu>
572
 
                <guimenuitem>My Processes</guimenuitem>
573
 
              </menuchoice>.
574
 
            </para>
575
 
          </listitem>
576
 
        </orderedlist>
577
 
      </sect3>
578
 
 
579
 
      <sect3 id="gnome-system-monitor-modify-processlist-active">
580
 
        <title>To Show Only Active Processes</title>
581
 
        <para>
582
 
          To show only the active processes in the process list, perform the following steps:
583
 
        </para>
584
 
        <orderedlist>
585
 
          <listitem>
586
 
            <para>
587
 
              Select the <guilabel>Processes</guilabel> tab to display the process list.
588
 
            </para>
589
 
          </listitem>
590
 
          <listitem>
591
 
            <para>
592
 
              Choose
593
 
              <menuchoice>
594
 
                <guimenu>View</guimenu>
595
 
                <guimenuitem>Active Processes</guimenuitem>
596
 
              </menuchoice>.
597
 
            </para>
598
 
          </listitem>
599
 
        </orderedlist>
600
 
      </sect3>
601
 
 
602
 
      <sect3 id="gnome-system-monitor-modify-processlist-viewdeps">
603
 
        <title>To Show Dependencies</title>
604
 
        <para>
605
 
          To show process dependencies in the process list, perform the following steps:
606
 
        </para>
607
 
        <orderedlist>
608
 
          <listitem>
609
 
            <para>
610
 
              Select the <guilabel>Processes</guilabel> tab to display the process list.
611
 
            </para>
612
 
          </listitem>
613
 
          <listitem>
614
 
            <para>
615
 
              Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Dependencies</guimenuitem></menuchoice>.
616
 
            </para>
617
 
          </listitem>
618
 
        </orderedlist>
619
 
        <para>
620
 
          If the <guimenuitem>Dependencies</guimenuitem> menu item is selected, the processes are listed as follows:
621
 
        </para>
622
 
        <itemizedlist>
623
 
          <listitem>
624
 
            <para>
625
 
              Parent processes are indicated by a triangle symbol to the left of the process name. Click on the triangle symbol to show or hide the associated child processes.
626
 
            </para>
627
 
          </listitem>
628
 
          <listitem>
629
 
            <para>
630
 
              Child processes are indented, and listed with their parent process.
631
 
            </para>
632
 
          </listitem>
633
 
        </itemizedlist>
634
 
        <para>
635
 
          If the <guimenuitem>Dependencies</guimenuitem> menu item is not selected:
636
 
        </para>
637
 
        <itemizedlist>
638
 
          <listitem>
639
 
            <para>
640
 
              Parent processes and child processes are not distinguishable.
641
 
            </para>
642
 
          </listitem>
643
 
          <listitem>
644
 
            <para>
645
 
              All processes are listed in alphabetical order.
646
 
            </para>
647
 
          </listitem>
648
 
        </itemizedlist>
649
 
      </sect3>
650
 
 
651
 
    </sect2>
652
 
 
653
 
    <sect2 id="gnome-system-monitor-memory-map">
654
 
      <title>To Display Memory Maps for a Process</title>
655
 
      <para>
656
 
        To display memory maps for a process, perform the following steps:
657
 
      </para>
658
 
      <orderedlist>
659
 
        <listitem>
660
 
          <para>
661
 
            Select the <guilabel>Processes</guilabel> tab to display the process list.
662
 
          </para>
663
 
        </listitem>
664
 
        <listitem>
665
 
          <para>
666
 
            Select the process in the process list.
667
 
          </para>
668
 
        </listitem>
669
 
        <listitem>
670
 
          <para>
671
 
            Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Memory Maps</guimenuitem></menuchoice>.
672
 
          </para>
673
 
        </listitem>
674
 
      </orderedlist>
675
 
      <para>
676
 
        The <guilabel>Memory Maps</guilabel> dialog displays the information in tabular format. The name of the process is displayed above the memory-map table. From left to right, the <guilabel>Memory Maps</guilabel> dialog displays the following columns:
677
 
      </para>
678
 
      <variablelist>
679
 
        <varlistentry>
680
 
          <term><guilabel>Filename</guilabel></term>
681
 
          <listitem>
682
 
            <para>
683
 
              The location of a shared library that is currently used by the process. If this field is blank, the memory information in this row describes memory that is owned by the process whose name is displayed above the memory-map table.
684
 
            </para>
685
 
          </listitem>
686
 
        </varlistentry>
687
 
        <varlistentry>
688
 
          <term><guilabel>VM Start</guilabel></term>
689
 
          <listitem>
690
 
            <para>
691
 
              The address at which the memory segment begins.
692
 
            </para>
693
 
          </listitem>
694
 
        </varlistentry>
695
 
        <varlistentry>
696
 
          <term><guilabel>VM End</guilabel></term>
697
 
          <listitem>
698
 
            <para>
699
 
              The address at which the memory segment ends.
700
 
            </para>
701
 
          </listitem>
702
 
        </varlistentry>
703
 
        <varlistentry>
704
 
          <term><guilabel>VM Size</guilabel></term>
705
 
          <listitem>
706
 
            <para>
707
 
              The size of the memory segment.
708
 
            </para>
709
 
          </listitem>
710
 
        </varlistentry>
711
 
        <varlistentry>
712
 
          <term><guilabel>Flags</guilabel></term>
713
 
          <listitem>
714
 
            <para>
715
 
              The following flags describe the different types of memory-segment access that the process can have:
716
 
            </para>
717
 
            <variablelist>
718
 
              <varlistentry>
719
 
                <term>p</term>
720
 
                <listitem>
721
 
                  <para>
722
 
                    The memory segment is private to the process, and is not accessible to other processes.
723
 
                  </para>
724
 
                </listitem>
725
 
              </varlistentry>
726
 
              <varlistentry>
727
 
                <term>r</term>
728
 
                <listitem>
729
 
                  <para>
730
 
                    The process has permission to read from the memory segment.
731
 
                  </para>
732
 
                </listitem>
733
 
              </varlistentry>
734
 
              <varlistentry>
735
 
                <term>s</term>
736
 
                <listitem>
737
 
                  <para>
738
 
                    The memory segment is shared with other processes.
739
 
                  </para>
740
 
                </listitem>
741
 
              </varlistentry>
742
 
              <varlistentry>
743
 
                <term>w</term>
744
 
                <listitem>
745
 
                  <para>
746
 
                    The process has permission to write into the memory segment.
747
 
                  </para>
748
 
                </listitem>
749
 
              </varlistentry>
750
 
              <varlistentry>
751
 
                <term>x</term>
752
 
                <listitem>
753
 
                  <para>
754
 
                    The process has permission to execute instructions that are contained within the memory segment.
755
 
                  </para>
756
 
                </listitem>
757
 
              </varlistentry>
758
 
            </variablelist>
759
 
          </listitem>
760
 
        </varlistentry>
761
 
        <varlistentry>
762
 
          <term><guilabel>VM Offset</guilabel></term>
763
 
          <listitem>
764
 
            <para>
765
 
              The virtual memory offset of the memory segment.
766
 
            </para>
767
 
          </listitem>
768
 
        </varlistentry>
769
 
        <varlistentry>
770
 
          <term><guilabel>Device</guilabel></term>
771
 
          <listitem>
772
 
            <para>
773
 
              The major and minor device numbers of the device on which the shared library filename is located.
774
 
            </para>
775
 
          </listitem>
776
 
        </varlistentry>
777
 
        <varlistentry>
778
 
          <term><guilabel>Inode</guilabel></term>
779
 
          <listitem>
780
 
            <para>
781
 
              The inode on the device from which the shared library location is loaded into memory.
782
 
            </para>
783
 
          </listitem>
784
 
        </varlistentry>
785
 
      </variablelist>
786
 
      <para>
787
 
        Click on any column header to sort the data by the information in that column, in alphabetical or numerical order. Click again on the column header to sort the data in reverse alphabetical or reverse numerical order.
788
 
      </para>
789
 
      <para>
790
 
        Click <guibutton>Close</guibutton> to close the <guilabel>Memory Maps</guilabel> dialog.
791
 
      </para>
792
 
    </sect2>
793
 
 
794
 
    <sect2 id="gnome-system-monitor-change-priority">
795
 
      <title>To Change the Priority of a Process</title>
796
 
      <para>
797
 
        To change the priority of a process, perform the following steps:
798
 
      </para>
799
 
      <orderedlist>
800
 
        <listitem>
801
 
          <para>
802
 
            Select the <guilabel>Processes</guilabel> tab to display the process list.
803
 
          </para>
804
 
        </listitem>
805
 
        <listitem>
806
 
          <para>
807
 
            Select the process for which you want to change the priority.
808
 
          </para>
809
 
        </listitem>
810
 
        <listitem>
811
 
          <para>
812
 
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Change Priority</guimenuitem></menuchoice>. The <guilabel>Change Priority</guilabel> dialog is displayed.
813
 
          </para>
814
 
        </listitem>
815
 
        <listitem>
816
 
          <para>
817
 
            Use the slider to set the nice value of the process.
818
 
          </para>
819
 
          <para>
820
 
            The nice value sets the priority of the process: the lower the nice value, the higher the priority.
821
 
          </para>
822
 
          <para>
823
 
            To specify a nice value lower than zero, non-root users must enter the root password.
824
 
          </para>
825
 
        </listitem>
826
 
        <listitem>
827
 
          <para>
828
 
            Click on the <guibutton>Change Priority</guibutton> button.
829
 
          </para>
830
 
        </listitem>
831
 
      </orderedlist>
832
 
    </sect2>
833
 
 
834
 
 
835
 
    <sect2 id="gnome-system-monitor-end-process">
836
 
      <title>To End a Process</title>
837
 
      <para>
838
 
        To end a process, perform the following steps:
839
 
      </para>
840
 
      <orderedlist>
841
 
        <listitem>
842
 
          <para>
843
 
            Select the <guilabel>Processes</guilabel> tab to display the process list.
844
 
          </para>
845
 
        </listitem>
846
 
        <listitem>
847
 
          <para>
848
 
            Select the process that you want to end.
849
 
          </para>
850
 
        </listitem>
851
 
        <listitem>
852
 
          <para>
853
 
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>End Process</guimenuitem></menuchoice>, or click on the <guibutton>End Process</guibutton> button.
854
 
          </para>
855
 
          <para>
856
 
            By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see <xref linkend="gnome-system-monitor-prefs-proclist"/>.
857
 
          </para>
858
 
        </listitem>
859
 
        <listitem>
860
 
          <para>
861
 
            Click on the <guibutton>End Process</guibutton> button to confirm that you want to end the process. <application>&app;</application> forces the process to finish normally.
862
 
          </para>
863
 
        </listitem>
864
 
      </orderedlist>
865
 
      <para>
866
 
        This is the preferred way to stop a process.
867
 
      </para>
868
 
    </sect2>
869
 
 
870
 
    <sect2 id="gnome-system-monitor-terminate-process">
871
 
      <title>To Terminate a Process</title>
872
 
      <para>
873
 
        To terminate a process, perform the following steps:
874
 
      </para>
875
 
      <orderedlist>
876
 
        <listitem>
877
 
          <para>
878
 
            Select the <guilabel>Processes</guilabel> tab to display the process list.
879
 
          </para>
880
 
        </listitem>
881
 
        <listitem>
882
 
          <para>
883
 
            Select the process that you want to terminate.
884
 
          </para>
885
 
        </listitem>
886
 
        <listitem>
887
 
          <para>
888
 
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Kill Process</guimenuitem></menuchoice>.
889
 
          </para>
890
 
          <para>
891
 
            By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see <xref linkend="gnome-system-monitor-prefs-proclist"/>.
892
 
          </para>
893
 
        </listitem>
894
 
        <listitem>
895
 
          <para>
896
 
            Click on the <guibutton>Kill Process</guibutton> button to confirm that you want to terminate the process. <application>&app;</application> forces the process to finish immediately.
897
 
          </para>
898
 
        </listitem>
899
 
      </orderedlist>
900
 
      <para>
901
 
        You usually terminate a process only if you cannot end the process normally as described in <xref linkend="gnome-system-monitor-end-process"/>.
902
 
      </para>
903
 
    </sect2>
904
 
 
905
 
    <sect2 id="gnome-system-monitor-cpu">
906
 
      <title>To Monitor CPU Usage</title>
907
 
      <para>
908
 
        To monitor CPU usage, select the <guilabel>Resources</guilabel> tab.
909
 
      </para>
910
 
      <para>
911
 
        <application>&app;</application> displays the CPU usage history in graphical format. Underneath the graph, <application>&app;</application> also displays the current CPU usage, as a percentage.
912
 
      </para>
913
 
    </sect2>
914
 
 
915
 
 
916
 
    <sect2 id="gnome-system-monitor-memory">
917
 
      <title>To Monitor Memory and Swap Usage</title>
918
 
      <para>
919
 
        To monitor memory and swap usage, select the <guilabel>Resources</guilabel> tab.
920
 
      </para>
921
 
      <para>
922
 
        <application>&app;</application> displays the memory usage history and the swap usage history in graphical format. Underneath the graph, <application>&app;</application> also displays the following numerical values:
923
 
      </para>
924
 
      <itemizedlist>
925
 
        <listitem>
926
 
          <para>
927
 
            Used memory out of total memory
928
 
          </para>
929
 
        </listitem>
930
 
        <listitem>
931
 
          <para>
932
 
            Used swap out of total swap
933
 
          </para>
934
 
        </listitem>
935
 
      </itemizedlist>
936
 
 
937
 
    </sect2>
938
 
 
939
 
    <sect2 id="gnome-system-monitor-network">
940
 
      <title>To Monitor Network Activity</title>
941
 
      <para>
942
 
        To monitor network activity, select the <guilabel>Resources</guilabel> tab.
943
 
      </para>
944
 
      <para>
945
 
        <application>&app;</application> displays the network history in graphical format. Underneath the graph, <application>&app;</application> also displays the following numerical values:
946
 
      </para>
947
 
      <itemizedlist>
948
 
        <listitem>
949
 
          <para>
950
 
            Received data per second and total
951
 
          </para>
952
 
        </listitem>
953
 
        <listitem>
954
 
          <para>
955
 
            Sent data per second and total
956
 
          </para>
957
 
        </listitem>
958
 
      </itemizedlist>
959
 
    </sect2>
960
 
 
961
 
    <sect2 id="gnome-system-monitor-disk">
962
 
      <title>To Monitor File Systems</title>
963
 
      <para>
964
 
        To monitor file systems, select the <guilabel>File Systems</guilabel> tab.
965
 
      </para>
966
 
      <para>
967
 
        <application>&app;</application> displays mounted file systems in tabular format. From left to right, the table displays the following columns:
968
 
      </para>
969
 
      <variablelist>
970
 
        <varlistentry>
971
 
          <term>
972
 
            Device
973
 
          </term>
974
 
          <listitem>
975
 
            <para>Location of block file</para>
976
 
          </listitem>
977
 
        </varlistentry>
978
 
        <varlistentry>
979
 
          <term>
980
 
            Directory
981
 
          </term>
982
 
          <listitem>
983
 
            <para>Mount point (directory to access) of device</para>
984
 
          </listitem>
985
 
        </varlistentry>
986
 
        <varlistentry>
987
 
          <term>
988
 
            Type
989
 
          </term>
990
 
          <listitem>
991
 
            <para>File system type</para>
992
 
          </listitem>
993
 
        </varlistentry>
994
 
        <varlistentry>
995
 
          <term>
996
 
            Total
997
 
          </term>
998
 
          <listitem>
999
 
            <para>Total capacity</para>
1000
 
          </listitem>
1001
 
        </varlistentry>
1002
 
        <varlistentry>
1003
 
          <term>
1004
 
            Free
1005
 
          </term>
1006
 
          <listitem>
1007
 
            <para>Amount of space not in use</para>
1008
 
          </listitem>
1009
 
        </varlistentry>
1010
 
        <varlistentry>
1011
 
          <term>
1012
 
            Available
1013
 
          </term>
1014
 
          <listitem>
1015
 
            <para>Amount of space which can be used</para>
1016
 
          </listitem>
1017
 
        </varlistentry>
1018
 
        <varlistentry>
1019
 
          <term>
1020
 
            Used
1021
 
          </term>
1022
 
          <listitem>
1023
 
            <para>Amount of space which is used (and percentage of Total)</para>
1024
 
          </listitem>
1025
 
        </varlistentry>
1026
 
      </variablelist>
1027
 
    </sect2>
1028
 
 
1029
 
  </sect1>
1030
 
 
1031
 
  <sect1 id="gnome-system-monitor-prefs">
1032
 
    <title>Preferences</title>
1033
 
    <para>To configure <application>&app;</application>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. The <guilabel>Preferences</guilabel> dialog contains the following tabbed sections:
1034
 
    </para>
1035
 
 
1036
 
    <sect2 id="gnome-system-monitor-prefs-proclist">
1037
 
      <title>Processes</title>
1038
 
        <variablelist>
1039
 
          <varlistentry>
1040
 
            <term>
1041
 
              <guilabel>Behavior</guilabel>
1042
 
            </term>
1043
 
            <listitem>
1044
 
              <itemizedlist>
1045
 
                <listitem>
1046
 
                  <para>
1047
 
                    <guilabel>Update interval in seconds</guilabel>
1048
 
                  </para>
1049
 
                  <para>
1050
 
                    Use this spin box to specify the interval at which you want to update the process list.
1051
 
                  </para>
1052
 
                </listitem>
1053
 
                <listitem>
1054
 
                  <para>
1055
 
                    <guilabel>Enable smooth refresh</guilabel>
1056
 
                  </para>
1057
 
                  <para>
1058
 
                    Select this option to refresh smoothly.
1059
 
                  </para>
1060
 
                </listitem>
1061
 
                <listitem>
1062
 
                  <para>
1063
 
                    <guilabel>Alert before ending or killing processes</guilabel>
1064
 
                  </para>
1065
 
                  <para>
1066
 
                    Select this option to display a confirmation alert when you end a process or terminate a process.
1067
 
                  </para>
1068
 
                </listitem>
1069
 
                <listitem>
1070
 
                  <para>
1071
 
                    <guilabel>Divide CPU usage by CPU count</guilabel>
1072
 
                  </para>
1073
 
                  <para>
1074
 
                    Select this to divide each process' CPU% in the Processes table by the number of CPUs.
1075
 
                  </para>
1076
 
                </listitem>
1077
 
              </itemizedlist>
1078
 
            </listitem>
1079
 
          </varlistentry>
1080
 
          <varlistentry>
1081
 
            <term>
1082
 
              <guilabel>Information Fields</guilabel>
1083
 
            </term>
1084
 
            <listitem>
1085
 
              <para>
1086
 
                Use the following options to select which fields are displayed in the process list:
1087
 
              </para>
1088
 
              <itemizedlist>
1089
 
                <listitem>
1090
 
                  <para>
1091
 
                    <guilabel>Process Name</guilabel>
1092
 
                  </para>
1093
 
                  <para>
1094
 
                    Select this option to display the name of the process. This column may also contain an icon to indicate the application that is associated with the process.
1095
 
                  </para>
1096
 
                </listitem>
1097
 
                <listitem>
1098
 
                  <para>
1099
 
                    <guilabel>User</guilabel>
1100
 
                  </para>
1101
 
                  <para>
1102
 
                    Select this option to display the name of the user who owns the process.
1103
 
                  </para>
1104
 
                </listitem>
1105
 
                <listitem>
1106
 
                  <para>
1107
 
                    <guilabel>Status</guilabel>
1108
 
                  </para>
1109
 
                  <para>
1110
 
                    Select this option to display the current status of the process: sleeping or running.
1111
 
                  </para>
1112
 
                </listitem>
1113
 
                <listitem>
1114
 
                  <para>
1115
 
                    <guilabel>Virtual Memory</guilabel>
1116
 
                  </para>
1117
 
                  <para>
1118
 
                    Select this option to display the amount of virtual memory that is allocated to the process.
1119
 
                  </para>
1120
 
                </listitem>
1121
 
                <listitem>
1122
 
                  <para>
1123
 
                    <guilabel>Resident Memory</guilabel>
1124
 
                  </para>
1125
 
                  <para>
1126
 
                    Select this option to display the amount of physical memory that is allocated to the process.
1127
 
                  </para>
1128
 
                </listitem>
1129
 
                <listitem>
1130
 
                  <para>
1131
 
                    <guilabel>Writable Memory</guilabel>
1132
 
                  </para>
1133
 
                  <para>
1134
 
                    Select this option to display the amount of memory that can be written by the process.
1135
 
                  </para>
1136
 
                </listitem>
1137
 
                <listitem>
1138
 
                  <para>
1139
 
                    <guilabel>Shared Memory</guilabel>
1140
 
                  </para>
1141
 
                  <para>
1142
 
                    Select this option to display the amount of shared memory that is allocated to the process. Shared memory is memory that can be accessed by another process.
1143
 
                  </para>
1144
 
                </listitem>
1145
 
                <listitem>
1146
 
                  <para>
1147
 
                    <guilabel>X Server Memory</guilabel>
1148
 
                  </para>
1149
 
                  <para>
1150
 
                    Select this option to display the amount of X server memory that is used by the process.
1151
 
                  </para>
1152
 
                </listitem>
1153
 
                <listitem>
1154
 
                  <para>
1155
 
                    <guilabel>% CPU</guilabel>
1156
 
                  </para>
1157
 
                  <para>
1158
 
                    Select this option to display the percentage of CPU time currently being used by the process.
1159
 
                  </para>
1160
 
                </listitem>
1161
 
                <listitem>
1162
 
                  <para>
1163
 
                    <guilabel>CPU Time</guilabel>
1164
 
                  </para>
1165
 
                  <para>
1166
 
                    Select this option to display the amount of CPU time that has been used by the process.
1167
 
                  </para>
1168
 
                </listitem>
1169
 
                <listitem>
1170
 
                  <para>
1171
 
                    <guilabel>Started</guilabel>
1172
 
                  </para>
1173
 
                  <para>
1174
 
                    Select this option to display when the process began running.
1175
 
                  </para>
1176
 
                </listitem>
1177
 
                <listitem>
1178
 
                  <para>
1179
 
                    <guilabel>Nice</guilabel>
1180
 
                  </para>
1181
 
                  <para>
1182
 
                    Select this option to display the nice value of the process. The nice value sets the priority of the process: the lower the nice value, the higher the priority.
1183
 
                  </para>
1184
 
                </listitem>
1185
 
                <listitem>
1186
 
                  <para>
1187
 
                <guilabel>ID</guilabel>
1188
 
                  </para>
1189
 
                  <para>
1190
 
                    Select this option to display the process identifier, also known as the pid. The pid is a number that uniquely identifies the process. You can use the pid to manipulate the process on the command line.
1191
 
                  </para>
1192
 
                </listitem>
1193
 
                <listitem>
1194
 
                  <para>
1195
 
                    <guilabel>Memory</guilabel>
1196
 
                  </para>
1197
 
                  <para>
1198
 
                    Select this option to display the amount of system memory that is currently being used by the process.
1199
 
                  </para>
1200
 
                </listitem>
1201
 
                <listitem>
1202
 
                  <para>
1203
 
                    <guilabel>Security Context</guilabel>
1204
 
                  </para>
1205
 
                  <para>
1206
 
                    Select this option to display the security context in which the process is running.
1207
 
                  </para>
1208
 
                </listitem>
1209
 
                <listitem>
1210
 
                  <para>
1211
 
                    <guilabel>Command Line</guilabel>
1212
 
                  </para>
1213
 
                  <para>
1214
 
                    Select this option to display the command line that was used to start the process, including arguments.
1215
 
                  </para>
1216
 
                </listitem>
1217
 
              </itemizedlist>
1218
 
            </listitem>
1219
 
          </varlistentry>
1220
 
        </variablelist>
1221
 
    </sect2>
1222
 
 
1223
 
    <sect2 id="gnome-system-monitor-prefs-resmon">
1224
 
      <title>Resources</title>
1225
 
        <variablelist>
1226
 
          <varlistentry>
1227
 
            <term><guilabel>Graphs</guilabel></term>
1228
 
            <listitem>
1229
 
              <itemizedlist>
1230
 
                <listitem>
1231
 
                  <para>
1232
 
                    <guilabel>Update interval in seconds</guilabel>
1233
 
                  </para>
1234
 
                  <para>
1235
 
                    Use this spin box to specify how often you want to update the <application>&app;</application> graphs.
1236
 
                  </para>
1237
 
                </listitem>
1238
 
                <listitem>
1239
 
                  <para>
1240
 
                    <guilabel>Show network speed in bits</guilabel>
1241
 
                  </para>
1242
 
                  <para>
1243
 
                    Select this option to use bits instead of bytes for displaying network speed in the <application>&app;</application> graphs.
1244
 
                  </para>
1245
 
                </listitem>
1246
 
              </itemizedlist>
1247
 
            </listitem>
1248
 
          </varlistentry>
1249
 
        </variablelist>
1250
 
    </sect2>
1251
 
 
1252
 
    <sect2 id="gnome-system-monitor-prefs-filesystems">
1253
 
      <title>File Systems</title>
1254
 
        <variablelist>
1255
 
          <varlistentry>
1256
 
            <term><guilabel>Behavior</guilabel></term>
1257
 
            <listitem>
1258
 
              <itemizedlist>
1259
 
                <listitem>
1260
 
                  <para>
1261
 
                    <guilabel>Update interval in seconds</guilabel>
1262
 
                  </para>
1263
 
                  <para>
1264
 
                    Use this spin box to specify how often you want to update the <guilabel>File Systems</guilabel> table.
1265
 
                  </para>
1266
 
                </listitem>
1267
 
                <listitem>
1268
 
                  <para>
1269
 
                    <guilabel>Show all file systems</guilabel>
1270
 
                  </para>
1271
 
                  <para>
1272
 
                    Select this option to show all file systems, including temporary and system ones.
1273
 
                  </para>
1274
 
                </listitem>
1275
 
              </itemizedlist>
1276
 
            </listitem>
1277
 
          </varlistentry>
1278
 
 
1279
 
        </variablelist>
1280
 
    </sect2>
1281
 
 
1282
 
  </sect1>
1283
 
 
1284
 
</article>