~ubuntu-branches/ubuntu/oneiric/gnome-system-monitor/oneiric-proposed

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Loic Minier
  • Date: 2005-08-26 18:38:24 UTC
  • Revision ID: james.westby@ubuntu.com-20050826183824-zh2978nxikpkfxyd
Tags: upstream-2.8.1
ImportĀ upstreamĀ versionĀ 2.8.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.5.2">
 
6
  <!ENTITY manrevision "2.1">
 
7
  <!ENTITY date "February 2004">
 
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>2004</year>
 
27
      <holder>Sun Microsystems</holder>
 
28
    </copyright>
 
29
    <copyright> 
 
30
      <year>2001</year>
 
31
      <year>2002</year> 
 
32
      <year>2004</year> 
 
33
      <holder>Bill Day</holder> 
 
34
    </copyright> 
 
35
 
 
36
<!-- translators: uncomment this:
 
37
  <copyright>
 
38
   <year>2002</year>
 
39
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
 
40
  </copyright>
 
41
   -->
 
42
 
 
43
    <publisher> 
 
44
      <publishername> GNOME Documentation Project </publishername> 
 
45
    </publisher> 
 
46
 
 
47
   &legal;
 
48
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
 
49
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
 
50
        any of this. -->
 
51
 
 
52
  <authorgroup> 
 
53
    <author>
 
54
      <firstname>Sun</firstname>
 
55
      <surname>GNOME Documentation Team</surname>
 
56
      <affiliation><orgname>Sun Microsystems</orgname></affiliation>
 
57
    </author>
 
58
    <author> 
 
59
      <firstname>Bill</firstname> 
 
60
      <surname>Day</surname> 
 
61
      <affiliation><address><email>billday@bellatlantic.net</email></address></affiliation> 
 
62
    </author> 
 
63
      
 
64
<!-- This is appropriate place for other contributors: translators,
 
65
     maintainers,  etc. Commented out by default.
 
66
     
 
67
    <othercredit role="translator">
 
68
      <firstname>Latin</firstname> 
 
69
      <surname>Translator 1</surname> 
 
70
      <affiliation> 
 
71
        <orgname>Latin Translation Team</orgname> 
 
72
        <address> <email>translator@gnome.org</email> </address> 
 
73
      </affiliation>
 
74
      <contrib>Latin translation</contrib>
 
75
    </othercredit>
 
76
-->
 
77
    </authorgroup>
 
78
 
 
79
    <revhistory>
 
80
      <revision> 
 
81
        <revnumber>System Monitor Manual V&manrevision;</revnumber> 
 
82
        <date>&date;</date> 
 
83
        <revdescription> 
 
84
          <para role="author">Sun GNOME Documentation Team</para>
 
85
          <para role="publisher">GNOME Documentation Project</para>
 
86
        </revdescription> 
 
87
      </revision> 
 
88
      <revision> 
 
89
        <revnumber>System Monitor Manual V2.0</revnumber> 
 
90
        <date>November 2002</date> 
 
91
        <revdescription> 
 
92
          <para role="author">Bill Day 
 
93
            <email>billday@bellatlantic.net</email>
 
94
          </para>
 
95
          <para role="publisher">GNOME Documentation Project</para>
 
96
        </revdescription> 
 
97
      </revision> 
 
98
      <revision> 
 
99
        <revnumber>Procman Manual V0.11</revnumber> 
 
100
        <date>January 2002</date> 
 
101
        <revdescription> 
 
102
          <para role="author">Bill Day 
 
103
            <email>billday@bellatlantic.net</email>
 
104
          </para>
 
105
          <para role="publisher">GNOME Documentation Project</para>
 
106
        </revdescription> 
 
107
      </revision> 
 
108
    </revhistory> 
 
109
 
 
110
    <releaseinfo>This manual describes version &appversion; of &app;.
 
111
    </releaseinfo> 
 
112
 
 
113
    <legalnotice> 
 
114
      <title>Feedback</title> 
 
115
      <para>
 
116
        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>. 
 
117
      </para>
 
118
 
 
119
<!-- Translators may also add here feedback address for translations -->
 
120
 
 
121
    </legalnotice> 
 
122
 
 
123
  </articleinfo> 
 
124
 
 
125
  <indexterm zone="index"> 
 
126
    <primary>System Monitor</primary> 
 
127
  </indexterm> 
 
128
  <indexterm zone="index"> 
 
129
    <primary>gnome-system-monitor</primary> 
 
130
  </indexterm>
 
131
  <indexterm zone="index"> 
 
132
    <primary>procman</primary> 
 
133
  </indexterm>
 
134
 
 
135
<!-- ============= Document Body ============================= -->
 
136
 <!-- ============= Introduction ============================== -->
 
137
  <sect1 id="gnome-system-monitor-intro">
 
138
    <title>Introduction</title>
 
139
    <para>
 
140
      The <application>&app;</application> application enables you to monitor system processes and usage of system resources. You can also use <application>&app;</application> to modify the behavior of your system.
 
141
    </para>
 
142
    <para>
 
143
      The <application>&app;</application> window contains two tabbed sections:
 
144
    </para>
 
145
    <variablelist>
 
146
      <varlistentry>
 
147
        <term>
 
148
          <guilabel>Process Listing</guilabel>
 
149
        </term>
 
150
        <listitem>
 
151
          <para>
 
152
            Shows active processes, and how processes are related to each other. Provides detailed information about individual processes, and enables you to control active processes.  
 
153
          </para>
 
154
        </listitem>
 
155
      </varlistentry>
 
156
      <varlistentry>
 
157
        <term>
 
158
          <guilabel>Resource Monitor</guilabel>
 
159
        </term>
 
160
        <listitem>
 
161
          <para>
 
162
            Displays the current usage of the following system resources:
 
163
          </para>
 
164
          <itemizedlist>
 
165
            <listitem>
 
166
              <para>
 
167
                CPU (central processing unit) time
 
168
              </para>
 
169
            </listitem>
 
170
            <listitem>
 
171
              <para>
 
172
                Memory and swap space 
 
173
              </para>
 
174
            </listitem>
 
175
            <listitem>
 
176
              <para>
 
177
                Disk space on each device
 
178
              </para>
 
179
            </listitem>
 
180
          </itemizedlist>
 
181
        </listitem>
 
182
      </varlistentry>
 
183
    </variablelist>
 
184
  </sect1>
 
185
 
 
186
<!-- ============= Getting Started =========================== -->
 
187
  <sect1 id="gnome-system-monitor-getting-started">
 
188
    <title>Getting Started</title>
 
189
                                                                                
 
190
<!-- ============= To Start System Monitor ============================ -->
 
191
    <sect2 id="gnome-system-monitor-to-start">
 
192
      <title>To Start &app;</title>
 
193
      <para>You can start <application>&app;</application> in the following ways:</para>
 
194
      <variablelist>
 
195
        <varlistentry>
 
196
          <term><guimenu>Applications</guimenu> menu</term>
 
197
          <listitem>
 
198
            <para>
 
199
              Choose <menuchoice><guimenu>System Tools</guimenu> <guimenuitem>System Monitor</guimenuitem></menuchoice>.
 
200
            </para>
 
201
          </listitem>
 
202
        </varlistentry>
 
203
        <varlistentry>
 
204
          <term>Command line</term>
 
205
          <listitem>
 
206
            <para>
 
207
              Execute the following command: <command>gnome-system-monitor</command></para>
 
208
          </listitem>
 
209
        </varlistentry>
 
210
      </variablelist>
 
211
    </sect2>
 
212
        
 
213
    <sect2 id="gnome-system-monitor-when-you-start">
 
214
      <title>When You Start &app;</title>       
 
215
      <para>
 
216
        When you start <application>&app;</application>, the following window is displayed:
 
217
      </para>
 
218
      <figure id="gnome-system-monitor-window"> 
 
219
        <title>&app; Window</title>
 
220
        <screenshot> 
 
221
          <mediaobject> 
 
222
            <imageobject> 
 
223
              <imagedata fileref="figures/gnome-system-monitor_window.png" format="PNG"/>
 
224
            </imageobject>
 
225
            <textobject> <phrase>Shows System Monitor main window.</phrase>
 
226
            </textobject> 
 
227
          </mediaobject>
 
228
        </screenshot>
 
229
      </figure>
 
230
      <para>
 
231
        The <application>&app;</application> window contains the following elements: 
 
232
      </para>
 
233
      <variablelist> 
 
234
        <varlistentry> 
 
235
          <term>Menubar</term> 
 
236
          <listitem> 
 
237
            <para>
 
238
              The menus on the menubar contain all of the commands that you need to work with <application>&app;</application>.
 
239
            </para>
 
240
          </listitem>
 
241
        </varlistentry>
 
242
        <varlistentry> 
 
243
          <term>Display area</term> 
 
244
          <listitem> 
 
245
            <para>
 
246
              The display area contains the system monitor information. The display area contains the following tabbed sections:
 
247
            </para>
 
248
            <itemizedlist>
 
249
              <listitem>
 
250
                <para>
 
251
                  <guilabel>Process Listing</guilabel>
 
252
                </para>
 
253
                <para>
 
254
                  Contains a <guilabel>Search</guilabel> text box, a <guilabel>View</guilabel> drop-down list, a list of processes organized as a table, a <guilabel>More Info</guilabel> button, and an <guilabel>End Process</guilabel> button.
 
255
                </para>
 
256
                <note>
 
257
                  <para>
 
258
                    Do not confuse the <guilabel>View</guilabel> drop-down list on the <guilabel>Process Listing</guilabel> tabbed section with the <guilabel>View</guilabel> menu in the menubar.
 
259
                  </para>
 
260
                </note>
 
261
              </listitem>
 
262
              <listitem>
 
263
                <para>
 
264
                  <guilabel>Resource Monitor</guilabel>
 
265
                </para>
 
266
                <para>
 
267
                  Contains a <guilabel>CPU History</guilabel> graph, a <guilabel>Memory and Swap History</guilabel> graph, and a list of <guilabel>Devices</guilabel> organized as a table.
 
268
                </para>
 
269
              </listitem>
 
270
            </itemizedlist>
 
271
          </listitem>
 
272
        </varlistentry>
 
273
        <varlistentry> 
 
274
          <term>Statusbar</term> 
 
275
          <listitem> 
 
276
            <para>
 
277
              The statusbar displays information about current <application>&app;</application> activity and contextual information about the menu items. 
 
278
            </para>
 
279
          </listitem>
 
280
        </varlistentry>
 
281
      </variablelist>
 
282
    </sect2>
 
283
  </sect1>
 
284
 
 
285
 
 
286
 <!-- ================ Usage ================================ -->
 
287
 <!-- This section should describe basic usage of the application. -->
 
288
 
 
289
  <sect1 id="gnome-system-monitor-usage">
 
290
    <title>Usage</title>
 
291
                                                                                
 
292
    <sect2 id="gnome-system-monitor-display-processlist">
 
293
      <title>To Display the Process List</title>
 
294
      <para>
 
295
        To display the process list, select the <guilabel>Process Listing</guilabel> tab. The <guilabel>Process Listing</guilabel> tab is displayed by default when you start <application>&app;</application>.
 
296
      </para>
 
297
      <para>
 
298
        In the <guilabel>Process Listing</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>Process Listing</guilabel> tab displays the following columns by default:
 
299
      </para>
 
300
      <itemizedlist>
 
301
          <listitem>
 
302
            <para>Process Name</para>
 
303
          </listitem>
 
304
          <listitem>
 
305
            <para>User</para>
 
306
          </listitem>
 
307
          <listitem>
 
308
            <para>Memory</para>
 
309
          </listitem>
 
310
          <listitem>
 
311
            <para>X Server Memory</para>
 
312
          </listitem>
 
313
          <listitem>
 
314
            <para>Nice</para>
 
315
          </listitem>
 
316
          <listitem>
 
317
            <para>ID</para>
 
318
          </listitem>
 
319
      </itemizedlist>
 
320
        <para>
 
321
          For information about how to change the columns displayed in the process list, see <xref linkend="gnome-system-monitor-prefs-proclist"/>.
 
322
        </para>
 
323
 
 
324
      <sect3 id="gnome-system-monitor-display-processlist-child">
 
325
        <title>Parent Processes, Child Processes, and Threads</title>
 
326
        <para>
 
327
          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> shows process dependencies. For information about how to change the default display behavior, see <xref linkend="gnome-system-monitor-modify-processlist-viewdeps"/>.
 
328
        </para>
 
329
        <para>
 
330
          A thread is a portion of a process that can run independently of and concurrently with other portions of the process. By default, <application>&app;</application> does not show threads. For information about how to change the default display behavior, see <xref linkend="gnome-system-monitor-modify-processlist-viewthreads"/>.
 
331
        </para>
 
332
      </sect3>
 
333
 
 
334
      <sect3 id="gnome-system-monitor-display-processlist-priority">
 
335
        <title>Process Priority and Nice Values</title>
 
336
      <para>
 
337
        Processes run in order of priority: high-priority processes run before low-priority processes. Child processes generally inherit their priority from their parent process.
 
338
      </para>
 
339
      <para>
 
340
        The priority of a process is set by the nice value of the process, as follows: 
 
341
      </para>
 
342
      <itemizedlist>
 
343
        <listitem>
 
344
          <para>
 
345
            A nice value of 0 means that the process has normal priority.
 
346
          </para>
 
347
        </listitem>
 
348
        <listitem>
 
349
          <para>
 
350
            The higher the nice value, the lower the priority.
 
351
          </para>
 
352
        </listitem>
 
353
        <listitem>
 
354
          <para>
 
355
            The lower the nice value, the higher the priority.
 
356
          </para>
 
357
        </listitem>
 
358
      </itemizedlist>
 
359
      <para>
 
360
        For information about how to change the priority of a process, see <xref linkend="gnome-system-monitor-change-priority"/>.
 
361
      </para>
 
362
      </sect3>
 
363
 
 
364
    </sect2>
 
365
 
 
366
    <sect2 id="gnome-system-monitor-sort-processlist">
 
367
      <title>To Sort the Process List</title>
 
368
      <para>
 
369
        To sort the process list, perform the following steps:
 
370
      </para>
 
371
      <orderedlist>
 
372
        <listitem>
 
373
          <para>
 
374
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
375
          </para>
 
376
        </listitem>
 
377
        <listitem>
 
378
          <para>
 
379
            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.
 
380
          </para>
 
381
        </listitem>
 
382
        <listitem>
 
383
          <para>
 
384
            Click on any column header to sort the processes by the information in that column, in alphabetical or numerical order. 
 
385
          </para>
 
386
        </listitem>
 
387
        <listitem>
 
388
          <para>
 
389
            Click again on the column header to sort the data in reverse alphabetical or reverse numerical order.
 
390
          </para>
 
391
        </listitem>
 
392
      </orderedlist>
 
393
    </sect2>
 
394
 
 
395
    <sect2 id="gnome-system-monitor-modify-processlist">
 
396
      <title>To Modify the Contents of the Process List</title>
 
397
      <para>
 
398
        You can modify the contents of the process list in several ways.
 
399
      </para>
 
400
 
 
401
      <sect3 id="gnome-system-monitor-modify-processlist-all">
 
402
        <title>To Show All Processes</title>
 
403
        <para>
 
404
          To show all processes in the process list, perform the following steps:
 
405
        </para>
 
406
        <orderedlist>
 
407
          <listitem>
 
408
            <para>
 
409
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
410
            </para>
 
411
          </listitem>
 
412
          <listitem>
 
413
            <para>
 
414
              Click on the <guilabel>View</guilabel> drop-down list, then select <guilabel>All Processes</guilabel>.
 
415
            </para>
 
416
          </listitem>
 
417
        </orderedlist>
 
418
      </sect3>
 
419
 
 
420
      <sect3 id="gnome-system-monitor-modify-processlist-my">
 
421
        <title>To Show Only Processes Owned by the Current User</title>
 
422
        <para>
 
423
          To show only the processes that are owned by the current user, perform the following steps:
 
424
        </para>
 
425
        <orderedlist>
 
426
          <listitem>
 
427
            <para>
 
428
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
429
            </para>
 
430
          </listitem>
 
431
          <listitem>
 
432
            <para>
 
433
              Click on the <guilabel>View</guilabel> drop-down list, then select <guilabel>My Processes</guilabel>.
 
434
            </para>
 
435
          </listitem>
 
436
        </orderedlist>
 
437
      </sect3>
 
438
 
 
439
      <sect3 id="gnome-system-monitor-modify-processlist-active">
 
440
        <title>To Show Only Active Processes</title>
 
441
        <para>
 
442
          To show only the active processes in the process list, perform the following steps:
 
443
        </para>
 
444
        <orderedlist>
 
445
          <listitem>
 
446
            <para>
 
447
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
448
            </para>
 
449
          </listitem>
 
450
          <listitem>
 
451
            <para>
 
452
              Click on the <guilabel>View</guilabel> drop-down list, then select <guilabel>Active Processes</guilabel>.
 
453
            </para>
 
454
          </listitem>
 
455
        </orderedlist>
 
456
      </sect3>
 
457
 
 
458
      <sect3 id="gnome-system-monitor-modify-processlist-viewdeps">
 
459
        <title>To Show Process Dependencies</title>
 
460
        <para>
 
461
          To show process dependencies in the process list, perform the following steps:
 
462
        </para>
 
463
        <orderedlist>
 
464
          <listitem>
 
465
            <para>
 
466
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
467
            </para>
 
468
          </listitem>
 
469
          <listitem>
 
470
            <para>
 
471
              Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Process Dependencies</guimenuitem></menuchoice>.
 
472
            </para>
 
473
          </listitem>
 
474
        </orderedlist>
 
475
        <para>
 
476
          If the <guimenuitem>Process Dependencies</guimenuitem> menu item is selected, the processes are listed as follows:
 
477
        </para>
 
478
        <itemizedlist>
 
479
          <listitem>
 
480
            <para>
 
481
              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.  
 
482
            </para>
 
483
          </listitem>
 
484
          <listitem>
 
485
            <para>
 
486
              Child processes are indented, and listed with their parent process.
 
487
            </para>
 
488
          </listitem>
 
489
        </itemizedlist>
 
490
        <para>
 
491
          If the <guimenuitem>Process Dependencies</guimenuitem> menu item is not selected: 
 
492
        </para>
 
493
        <itemizedlist>
 
494
          <listitem>
 
495
            <para>
 
496
              Parent processes and child processes are not distinguishable.
 
497
            </para>
 
498
          </listitem>
 
499
          <listitem>
 
500
            <para>
 
501
              All processes are listed in alphabetical order.
 
502
            </para>
 
503
          </listitem>
 
504
        </itemizedlist>
 
505
      </sect3>
 
506
 
 
507
      <sect3 id="gnome-system-monitor-modify-processlist-viewthreads">
 
508
        <title>To Show Threads</title>
 
509
        <para>
 
510
          To show threads in the process list, perform the following steps:
 
511
        </para>
 
512
        <orderedlist>
 
513
          <listitem>
 
514
            <para>
 
515
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
516
            </para>
 
517
          </listitem>
 
518
          <listitem>
 
519
            <para>
 
520
              Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Threads</guimenuitem></menuchoice>.
 
521
            </para>
 
522
          </listitem>
 
523
        </orderedlist>
 
524
      </sect3>
 
525
 
 
526
      <sect3 id="gnome-system-monitor-modify-hide-process">
 
527
        <title>To Hide a Process</title>
 
528
        <para>
 
529
          To hide a process, perform the following steps:
 
530
        </para>
 
531
        <orderedlist>
 
532
          <listitem>
 
533
            <para>
 
534
              Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
535
            </para>
 
536
          </listitem>
 
537
          <listitem>
 
538
            <para>
 
539
              Select the process that you want to hide.
 
540
            </para>
 
541
          </listitem>
 
542
            <listitem>
 
543
              <para>
 
544
                Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Hide Process</guimenuitem></menuchoice>.
 
545
              </para>
 
546
              <para>
 
547
                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"/>.
 
548
              </para>
 
549
            </listitem>
 
550
            <listitem>
 
551
              <para>
 
552
                Click on the <guibutton>Hide Process</guibutton> button to confirm that you want to hide the process. 
 
553
              </para>
 
554
            </listitem>
 
555
        </orderedlist>
 
556
      </sect3>
 
557
 
 
558
      <sect3 id="gnome-system-monitor-modify-processlist-hidden">
 
559
        <title>To Re-Display Hidden Processes</title>
 
560
        <para>
 
561
          To re-display hidden processes in the process list, perform the following steps:
 
562
        </para>
 
563
        <orderedlist>
 
564
          <listitem>
 
565
            <para>
 
566
              Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Hidden Processes</guimenuitem></menuchoice>. If no processes are currently hidden, an information alert is displayed. If any processes are currently hidden, the <guilabel>Manage Hidden Processes</guilabel> dialog is displayed. 
 
567
            </para>
 
568
          </listitem>
 
569
          <listitem>
 
570
            <para>
 
571
              Select the processes that you want to re-display in the process list.
 
572
            </para>
 
573
          </listitem>
 
574
          <listitem>
 
575
            <para>
 
576
              Click on the <guibutton>Remove From List</guibutton> button. The processes are no longer hidden, and are displayed in the process list.
 
577
            </para>
 
578
          </listitem>
 
579
          <listitem>
 
580
            <para>
 
581
              Click <guibutton>Close</guibutton> to close the <guilabel>Manage Hidden Processes</guilabel> dialog.
 
582
            </para>
 
583
          </listitem>
 
584
        </orderedlist>
 
585
      </sect3>
 
586
 
 
587
    </sect2>
 
588
 
 
589
    <sect2 id="gnome-system-monitor-find-process">
 
590
      <title>To Find a Process</title>
 
591
      <para>
 
592
        To find a process in the process list, perform the following steps:
 
593
      </para>
 
594
      <orderedlist>
 
595
        <listitem>
 
596
          <para>
 
597
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
598
          </para>
 
599
        </listitem>
 
600
        <listitem>
 
601
          <para>
 
602
            Type the name of the process in the <guilabel>Search</guilabel> text box. Wildcards are not supported.
 
603
          </para>
 
604
        </listitem>
 
605
        <listitem>
 
606
          <para>
 
607
            Press <keycap>Return</keycap>.
 
608
          </para>
 
609
          <para>
 
610
            If the process exists, <application>&app;</application> highlights the process name in the process list. Press <keycap>Return</keycap> repeatedly to highlight other occurrences of the process name in the process list.
 
611
          </para>
 
612
          <para>
 
613
            If the process does not exist, <application>&app;</application> displays an error dialog.
 
614
          </para>
 
615
        </listitem>
 
616
      </orderedlist>
 
617
    </sect2>
 
618
 
 
619
    <sect2 id="gnome-system-monitor-show-info">
 
620
      <title>To Show or Hide Additional Process Information</title>
 
621
      <para>
 
622
        To show additional information about a process, perform the following steps:
 
623
      </para>
 
624
      <orderedlist>
 
625
        <listitem>
 
626
          <para>
 
627
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
628
          </para>
 
629
        </listitem>
 
630
        <listitem>
 
631
          <para>
 
632
            Select the process in the process list. 
 
633
          </para>
 
634
        </listitem>
 
635
        <listitem>
 
636
          <para>
 
637
            Click on the <guibutton>More Info</guibutton> button.
 
638
          </para>
 
639
        </listitem>
 
640
      </orderedlist>
 
641
      <para>
 
642
        <application>&app;</application> displays the following additional process information:
 
643
      </para>
 
644
      <variablelist>
 
645
        <varlistentry>
 
646
          <term><guilabel>Process Info</guilabel></term>
 
647
          <listitem>
 
648
            <itemizedlist>
 
649
              <listitem>
 
650
                <para>
 
651
                  <guilabel>Command</guilabel>
 
652
                </para>
 
653
                <para>
 
654
                  The name of the command that started the process.
 
655
                </para>
 
656
              </listitem>
 
657
              <listitem>
 
658
                <para>
 
659
                  <guilabel>Status</guilabel>
 
660
                </para>
 
661
                <para>
 
662
                  The current status of the process: sleeping or running.
 
663
                </para>
 
664
              </listitem>
 
665
              <listitem>
 
666
                <para>
 
667
                  <guilabel>Priority</guilabel>
 
668
                </para>
 
669
                <para>
 
670
                  The priority of the process, and the associated nice value.
 
671
                </para>
 
672
              </listitem>
 
673
            </itemizedlist>
 
674
          </listitem>
 
675
        </varlistentry>
 
676
        <varlistentry>
 
677
          <term><guilabel>Memory Usage</guilabel></term>
 
678
          <listitem>
 
679
            <itemizedlist>
 
680
              <listitem>
 
681
                <para>
 
682
                  <guilabel>Total</guilabel>
 
683
                </para>
 
684
                <para>
 
685
                  The total amount of memory used by the process.
 
686
                </para>
 
687
              </listitem>
 
688
              <listitem>
 
689
                <para>
 
690
                  <guilabel>RSS</guilabel>
 
691
                </para>
 
692
                <para>
 
693
                  The amount of RSS or physical memory used by the process.
 
694
                </para>
 
695
              </listitem>
 
696
              <listitem>
 
697
                <para>
 
698
                  <guilabel>Shared</guilabel>
 
699
                </para>
 
700
                <para>
 
701
                  The amount of shared memory used by the process.
 
702
                </para>
 
703
              </listitem>
 
704
            </itemizedlist>
 
705
          </listitem>
 
706
        </varlistentry>
 
707
      </variablelist>
 
708
      <para>
 
709
        To hide the additional process information, click on the <guibutton>Less Info</guibutton> button.
 
710
      </para>
 
711
      <tip>
 
712
        <para>
 
713
          You can also double-click on the process in the process list, to show or hide the additional process information. 
 
714
        </para>
 
715
      </tip>
 
716
    </sect2>
 
717
 
 
718
    <sect2 id="gnome-system-monitor-memory-map">
 
719
      <title>To Display Memory Maps for a Process</title>
 
720
      <para>
 
721
        To display memory maps for a process, perform the following steps:
 
722
      </para>
 
723
      <orderedlist>
 
724
        <listitem>
 
725
          <para>
 
726
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
727
          </para>
 
728
        </listitem>
 
729
        <listitem>
 
730
          <para>
 
731
            Select the process in the process list. 
 
732
          </para>
 
733
        </listitem>
 
734
        <listitem>
 
735
          <para>
 
736
            Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Memory Maps</guimenuitem></menuchoice>.
 
737
          </para>
 
738
        </listitem>
 
739
      </orderedlist>
 
740
      <para>
 
741
        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:
 
742
      </para>
 
743
      <variablelist>
 
744
        <varlistentry>
 
745
          <term><guilabel>Filename</guilabel></term>
 
746
          <listitem>
 
747
            <para>
 
748
              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. 
 
749
            </para>
 
750
          </listitem>
 
751
        </varlistentry>
 
752
        <varlistentry>
 
753
          <term><guilabel>VM Start</guilabel></term>
 
754
          <listitem>
 
755
            <para>
 
756
              The address at which the memory segment begins.
 
757
            </para>
 
758
          </listitem>
 
759
        </varlistentry>
 
760
        <varlistentry>
 
761
          <term><guilabel>VM End</guilabel></term>
 
762
          <listitem>
 
763
            <para>
 
764
              The address at which the memory segment ends.
 
765
            </para>
 
766
          </listitem>
 
767
        </varlistentry>
 
768
        <varlistentry>
 
769
          <term><guilabel>VM Size</guilabel></term>
 
770
          <listitem>
 
771
            <para>
 
772
              The size of the memory segment.
 
773
            </para>
 
774
          </listitem>
 
775
        </varlistentry>
 
776
        <varlistentry>
 
777
          <term><guilabel>Flags</guilabel></term>
 
778
          <listitem>
 
779
            <para>
 
780
              The following flags describe the different types of memory-segment access that the process can have:
 
781
            </para>
 
782
            <variablelist>
 
783
              <varlistentry>
 
784
                <term>p</term>
 
785
                <listitem>
 
786
                  <para>
 
787
                    The memory segment is private to the process, and is not accessible to other processes.
 
788
                  </para>
 
789
                </listitem>
 
790
              </varlistentry>
 
791
              <varlistentry>
 
792
                <term>r</term>
 
793
                <listitem>
 
794
                  <para>
 
795
                    The process has permission to read from the memory segment.
 
796
                  </para>
 
797
                </listitem>
 
798
              </varlistentry>
 
799
              <varlistentry>
 
800
                <term>s</term>
 
801
                <listitem>
 
802
                  <para>
 
803
                    The memory segment is shared with other processes.
 
804
                  </para>
 
805
                </listitem>
 
806
              </varlistentry>
 
807
              <varlistentry>
 
808
                <term>w</term>
 
809
                <listitem>
 
810
                  <para>
 
811
                    The process has permission to write into the memory segment.
 
812
                  </para>
 
813
                </listitem>
 
814
              </varlistentry>
 
815
              <varlistentry>
 
816
                <term>x</term>
 
817
                <listitem>
 
818
                  <para>
 
819
                    The process has permission to execute instructions that are contained within the memory segment.
 
820
                  </para>
 
821
                </listitem>
 
822
              </varlistentry>
 
823
            </variablelist>
 
824
          </listitem>
 
825
        </varlistentry>
 
826
        <varlistentry>
 
827
          <term><guilabel>VM offset</guilabel></term>
 
828
          <listitem>
 
829
            <para>
 
830
              The virtual memory offset of the memory segment.
 
831
            </para>
 
832
          </listitem>
 
833
        </varlistentry>
 
834
        <varlistentry>
 
835
          <term><guilabel>Device</guilabel></term>
 
836
          <listitem>
 
837
            <para>
 
838
              The major and minor device numbers of the device on which the shared library filename is located.
 
839
            </para>
 
840
          </listitem>
 
841
        </varlistentry>
 
842
        <varlistentry>
 
843
          <term><guilabel>Inode</guilabel></term>
 
844
          <listitem>
 
845
            <para>
 
846
              The inode on the device from which the shared library location is loaded into memory.
 
847
            </para>
 
848
          </listitem>
 
849
        </varlistentry>
 
850
      </variablelist>
 
851
      <para>
 
852
        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.
 
853
      </para>
 
854
      <para>
 
855
        Click <guibutton>Close</guibutton> to close the <guilabel>Memory Maps</guilabel> dialog.
 
856
      </para>
 
857
    </sect2>
 
858
 
 
859
    <sect2 id="gnome-system-monitor-change-priority">
 
860
      <title>To Change the Priority of a Process</title>
 
861
      <para>
 
862
        To change the priority of a process, perform the following steps:
 
863
      </para>
 
864
      <orderedlist>
 
865
        <listitem>
 
866
          <para>
 
867
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
868
          </para>
 
869
        </listitem>
 
870
        <listitem>
 
871
          <para>
 
872
            Select the process for which you want to change the priority.
 
873
          </para>
 
874
        </listitem>
 
875
        <listitem>
 
876
          <para>
 
877
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Change Priority</guimenuitem></menuchoice>. The <guilabel>Change Priority</guilabel> dialog is displayed. 
 
878
          </para>
 
879
        </listitem>
 
880
        <listitem>
 
881
          <para>
 
882
            Use the slider to set the nice value of the process.
 
883
          </para>
 
884
          <para>
 
885
            The nice value sets the priority of the process: the lower the nice value, the higher the priority.
 
886
          </para>
 
887
          <para>
 
888
            To specify a nice value lower than zero, non-root users must enter the root password. 
 
889
          </para>
 
890
        </listitem>
 
891
        <listitem>
 
892
          <para>
 
893
            Click on the <guibutton>Change Priority</guibutton> button.
 
894
          </para>
 
895
        </listitem>
 
896
      </orderedlist>
 
897
    </sect2>
 
898
 
 
899
 
 
900
    <sect2 id="gnome-system-monitor-end-process">
 
901
      <title>To End a Process</title>
 
902
      <para>
 
903
        To end a process, perform the following steps:
 
904
      </para>
 
905
      <orderedlist>
 
906
        <listitem>
 
907
          <para>
 
908
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
909
          </para>
 
910
        </listitem>
 
911
        <listitem>
 
912
          <para>
 
913
            Select the process that you want to end.
 
914
          </para>
 
915
        </listitem>
 
916
        <listitem>
 
917
          <para>
 
918
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>End Process</guimenuitem></menuchoice>, or click on the <guibutton>End Process</guibutton> button.
 
919
          </para>
 
920
          <para>
 
921
            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"/>.
 
922
          </para>
 
923
        </listitem>
 
924
        <listitem>
 
925
          <para>
 
926
            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.
 
927
          </para>
 
928
        </listitem>
 
929
      </orderedlist>
 
930
      <para>
 
931
        This is the preferred way to stop a process.
 
932
      </para>
 
933
    </sect2>
 
934
 
 
935
    <sect2 id="gnome-system-monitor-terminate-process">
 
936
      <title>To Terminate a Process</title>
 
937
      <para>
 
938
        To terminate a process, perform the following steps:
 
939
      </para>
 
940
      <orderedlist>
 
941
        <listitem>
 
942
          <para>
 
943
            Select the <guilabel>Process Listing</guilabel> tab to display the process list.
 
944
          </para>
 
945
        </listitem>
 
946
        <listitem>
 
947
          <para>
 
948
            Select the process that you want to terminate.
 
949
          </para>
 
950
        </listitem>
 
951
        <listitem>
 
952
          <para>
 
953
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Kill Process</guimenuitem></menuchoice>.
 
954
          </para>
 
955
          <para>
 
956
            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"/>.
 
957
          </para>
 
958
        </listitem>
 
959
        <listitem>
 
960
          <para>
 
961
            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.
 
962
          </para>
 
963
        </listitem>
 
964
      </orderedlist>
 
965
      <para>
 
966
        You usually terminate a process only if you cannot end the process normally as described in <xref linkend="gnome-system-monitor-end-process"/>.
 
967
      </para>
 
968
    </sect2>
 
969
 
 
970
    <sect2 id="gnome-system-monitor-cpu">
 
971
      <title>To Monitor CPU Usage</title>
 
972
      <para>
 
973
        To monitor CPU usage, select the <guilabel>Resource Monitor</guilabel> tab.
 
974
      </para>
 
975
      <para>
 
976
        <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.
 
977
      </para>
 
978
    </sect2>
 
979
 
 
980
 
 
981
    <sect2 id="gnome-system-monitor-memory">
 
982
      <title>To Monitor Memory and Swap Usage</title>
 
983
      <para>
 
984
        To monitor memory and swap usage, select the <guilabel>Resource Monitor</guilabel> tab.
 
985
      </para>
 
986
      <para>
 
987
        <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: 
 
988
      </para>
 
989
      <itemizedlist>
 
990
        <listitem>
 
991
          <para>
 
992
            Used memory
 
993
          </para>
 
994
        </listitem>
 
995
        <listitem>
 
996
          <para>
 
997
            Total memory
 
998
          </para>
 
999
        </listitem>
 
1000
        <listitem>
 
1001
          <para>
 
1002
            Used swap
 
1003
          </para>
 
1004
        </listitem>
 
1005
        <listitem>
 
1006
          <para>
 
1007
            Total swap
 
1008
          </para>
 
1009
        </listitem>
 
1010
      </itemizedlist>
 
1011
 
 
1012
    </sect2>
 
1013
 
 
1014
    <sect2 id="gnome-system-monitor-disk">
 
1015
      <title>To Monitor Disk Space Usage</title>
 
1016
      <para>
 
1017
        To monitor disk space usage, select the <guilabel>Resource Monitor</guilabel> tab.
 
1018
      </para>
 
1019
      <para>
 
1020
        <application>&app;</application> displays the disk space usage information in tabular format. From left to right, the <guilabel>Devices</guilabel> table displays the following columns:
 
1021
      </para>
 
1022
      <variablelist>
 
1023
        <varlistentry>
 
1024
          <term><guilabel>Name</guilabel></term>
 
1025
          <listitem>
 
1026
            <para>
 
1027
              The name of the device.
 
1028
            </para>
 
1029
          </listitem>
 
1030
        </varlistentry>
 
1031
        <varlistentry>
 
1032
          <term><guilabel>Directory</guilabel></term>
 
1033
          <listitem>
 
1034
            <para>
 
1035
              The location of the device.
 
1036
            </para>
 
1037
          </listitem>
 
1038
        </varlistentry>
 
1039
        <varlistentry>
 
1040
          <term><guilabel>Type</guilabel></term>
 
1041
          <listitem>
 
1042
            <para>
 
1043
              The type of the device.
 
1044
            </para>
 
1045
          </listitem>
 
1046
        </varlistentry>
 
1047
        <varlistentry>
 
1048
          <term><guilabel>Total</guilabel></term>
 
1049
          <listitem>
 
1050
            <para>
 
1051
              The total amount of disk space available on the device.
 
1052
            </para>
 
1053
          </listitem>
 
1054
        </varlistentry>
 
1055
        <varlistentry>
 
1056
          <term><guilabel>Used</guilabel></term>
 
1057
          <listitem>
 
1058
            <para>
 
1059
              The amount of disk space currently used on the device, expressed in bytes and as a percentage.
 
1060
            </para>
 
1061
          </listitem>
 
1062
        </varlistentry>
 
1063
      </variablelist>
 
1064
    </sect2>
 
1065
 
 
1066
    <sect2 id="gnome-system-monitor-customize">
 
1067
      <title>To Customize the Resource Monitor Tabbed Section</title>
 
1068
      <para>
 
1069
        You can customize the <guilabel>Resource Monitor</guilabel> tabbed section in the following ways:
 
1070
      </para>
 
1071
      <itemizedlist>
 
1072
        <listitem>
 
1073
          <para><xref linkend="gnome-system-monitor-customize-background"/>
 
1074
          </para>
 
1075
        </listitem>
 
1076
        <listitem>
 
1077
          <para><xref linkend="gnome-system-monitor-customize-grid"/>
 
1078
          </para>
 
1079
        </listitem>
 
1080
        <listitem>
 
1081
          <para><xref linkend="gnome-system-monitor-customize-cpu"/>
 
1082
          </para>
 
1083
        </listitem>
 
1084
        <listitem>
 
1085
          <para><xref linkend="gnome-system-monitor-customize-mem"/>
 
1086
          </para>
 
1087
        </listitem>
 
1088
      </itemizedlist>
 
1089
 
 
1090
      <sect3 id="gnome-system-monitor-customize-background">
 
1091
        <title>To Change the Background Color of Graphs</title>
 
1092
        <para>
 
1093
          To change the background color of the <application>&app;</application> graphs, perform the following steps:
 
1094
        </para>
 
1095
        <orderedlist>
 
1096
          <listitem>
 
1097
            <para>
 
1098
              Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. The <guilabel>Preferences</guilabel> dialog is displayed. 
 
1099
            </para>
 
1100
          </listitem>
 
1101
          <listitem>
 
1102
            <para>
 
1103
              Select the <guilabel>Resource Monitor</guilabel> tab in the <guilabel>Preferences</guilabel> dialog.
 
1104
            </para>
 
1105
          </listitem>
 
1106
          <listitem>
 
1107
            <para>
 
1108
              Click on the <guilabel>Background color</guilabel> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
 
1109
            </para>
 
1110
          </listitem>
 
1111
          <listitem>
 
1112
            <para>
 
1113
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
 
1114
            </para>
 
1115
          </listitem>
 
1116
          <listitem>
 
1117
            <para>
 
1118
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
 
1119
            </para>
 
1120
          </listitem>
 
1121
          <listitem>
 
1122
            <para>
 
1123
              Click <guibutton>Close</guibutton> to close the <guilabel>Preferences</guilabel> dialog.
 
1124
            </para>
 
1125
          </listitem>
 
1126
        </orderedlist>
 
1127
      </sect3>
 
1128
 
 
1129
      <sect3 id="gnome-system-monitor-customize-grid">
 
1130
        <title>To Change the Grid Color of Graphs</title>
 
1131
        <para>
 
1132
          To change the grid color of the <application>&app;</application> graphs, perform the following steps:
 
1133
        </para>
 
1134
        <orderedlist>
 
1135
          <listitem>
 
1136
            <para>
 
1137
              Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. The <guilabel>Preferences</guilabel> dialog is displayed. 
 
1138
            </para>
 
1139
          </listitem>
 
1140
          <listitem>
 
1141
            <para>
 
1142
              Select the <guilabel>Resource Monitor</guilabel> tab in the <guilabel>Preferences</guilabel> dialog.
 
1143
            </para>
 
1144
          </listitem>
 
1145
          <listitem>
 
1146
            <para>
 
1147
              Click on the <guilabel>Grid color</guilabel> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
 
1148
            </para>
 
1149
          </listitem>
 
1150
          <listitem>
 
1151
            <para>
 
1152
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
 
1153
            </para>
 
1154
          </listitem>
 
1155
          <listitem>
 
1156
            <para>
 
1157
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
 
1158
            </para>
 
1159
          </listitem>
 
1160
          <listitem>
 
1161
            <para>
 
1162
              Click <guibutton>Close</guibutton> to close the <guilabel>Preferences</guilabel> dialog.
 
1163
            </para>
 
1164
          </listitem>
 
1165
        </orderedlist>
 
1166
      </sect3>
 
1167
 
 
1168
      <sect3 id="gnome-system-monitor-customize-cpu">
 
1169
        <title>To Change the Line Color of the CPU Graph</title>
 
1170
        <para>
 
1171
          To change the color of the line that represents CPU usage in the <guilabel>CPU History</guilabel> graph, perform the following steps:
 
1172
        </para>
 
1173
        <orderedlist>
 
1174
          <listitem>
 
1175
            <para>
 
1176
              Select the <guilabel>Resource Monitor</guilabel> tab in the <guilabel>System Monitor</guilabel> window, to display the graphs and table that provide information about the usage of system resources.
 
1177
            </para>
 
1178
          </listitem>
 
1179
          <listitem>
 
1180
            <para>
 
1181
              Click on the <guibutton>CPU</guibutton> color button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
 
1182
            </para>
 
1183
          </listitem>
 
1184
          <listitem>
 
1185
            <para>
 
1186
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
 
1187
            </para>
 
1188
          </listitem>
 
1189
          <listitem>
 
1190
            <para>
 
1191
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
 
1192
            </para>
 
1193
          </listitem>
 
1194
        </orderedlist>
 
1195
      </sect3>
 
1196
 
 
1197
      <sect3 id="gnome-system-monitor-customize-mem">
 
1198
        <title>To Change the Line Colors of the Memory and Swap Graph</title>
 
1199
        <para>
 
1200
          To change the color of the lines that represent memory and swap usage in the graph, perform the following steps:
 
1201
        </para>
 
1202
        <orderedlist>
 
1203
          <listitem>
 
1204
            <para>
 
1205
              Select the <guilabel>Resource Monitor</guilabel> tab in the <guilabel>System Monitor</guilabel> window, to display the graphs and table that provide information about the usage of system resources.
 
1206
            </para>
 
1207
          </listitem>
 
1208
          <listitem>
 
1209
            <para>
 
1210
              Click on the <guibutton>Used memory</guibutton> or <guibutton>Used swap</guibutton> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
 
1211
            </para>
 
1212
          </listitem>
 
1213
          <listitem>
 
1214
            <para>
 
1215
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
 
1216
            </para>
 
1217
          </listitem>
 
1218
          <listitem>
 
1219
            <para>
 
1220
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
 
1221
            </para>
 
1222
          </listitem>
 
1223
        </orderedlist>
 
1224
      </sect3>
 
1225
 
 
1226
    </sect2>
 
1227
 
 
1228
  </sect1>
 
1229
 
 
1230
  <sect1 id="gnome-system-monitor-prefs">
 
1231
    <title>Preferences</title>
 
1232
    <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:
 
1233
    </para>
 
1234
    <itemizedlist>
 
1235
      <listitem>
 
1236
        <para><xref linkend="gnome-system-monitor-prefs-proclist"/></para>
 
1237
      </listitem>
 
1238
      <listitem>
 
1239
        <para><xref linkend="gnome-system-monitor-prefs-resmon"/></para>
 
1240
      </listitem>
 
1241
    </itemizedlist>
 
1242
 
 
1243
    <sect2 id="gnome-system-monitor-prefs-proclist">
 
1244
      <title>Process Listing</title>
 
1245
        <variablelist>
 
1246
          <varlistentry>
 
1247
            <term>
 
1248
              <guilabel>Behavior</guilabel>
 
1249
            </term>
 
1250
            <listitem>
 
1251
              <itemizedlist>
 
1252
                <listitem>
 
1253
                  <para>
 
1254
                    <guilabel>Update interval ... seconds</guilabel>
 
1255
                  </para>
 
1256
                  <para>
 
1257
                    Use this spin box to specify the interval at which you want to update the process list. 
 
1258
                  </para>
 
1259
                </listitem>
 
1260
                <listitem>
 
1261
                  <para>
 
1262
                    <guilabel>Show warning dialog when ending or killing processes</guilabel>
 
1263
                  </para>
 
1264
                  <para>
 
1265
                    Select this option to display a confirmation alert when you end a process or terminate a process.
 
1266
                  </para>
 
1267
                </listitem>
 
1268
                <listitem>
 
1269
                  <para>
 
1270
                    <guilabel>Show warning dialog when hiding processes</guilabel>
 
1271
                  </para>
 
1272
                  <para>
 
1273
                    Select this option to display a confirmation alert when you hide a process.
 
1274
                  </para>
 
1275
                </listitem>
 
1276
              </itemizedlist>
 
1277
            </listitem>
 
1278
          </varlistentry>
 
1279
          <varlistentry>
 
1280
            <term>
 
1281
              <guilabel>Process Fields</guilabel>
 
1282
            </term>
 
1283
            <listitem>
 
1284
              <para>
 
1285
                Use the following options to select which fields are displayed in the process list:
 
1286
              </para>
 
1287
              <itemizedlist>
 
1288
                <listitem>
 
1289
                  <para>
 
1290
                    <guilabel>Process Name</guilabel>
 
1291
                  </para>
 
1292
                  <para>
 
1293
                    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.
 
1294
                  </para>
 
1295
                </listitem>
 
1296
                <listitem>
 
1297
                  <para>
 
1298
                    <guilabel>Arguments</guilabel>
 
1299
                  </para>
 
1300
                  <para>
 
1301
                    Select this option to display the name of the command, including arguments, that started the process.
 
1302
                  </para>
 
1303
                </listitem>
 
1304
                <listitem>
 
1305
                  <para>
 
1306
                    <guilabel>User</guilabel>
 
1307
                  </para>
 
1308
                  <para>
 
1309
                    Select this option to display the name of the user who owns the process.
 
1310
                  </para>
 
1311
                </listitem>
 
1312
                <listitem>
 
1313
                  <para>
 
1314
                    <guilabel>Status</guilabel>
 
1315
                  </para>
 
1316
                  <para>
 
1317
                    Select this option to display the current status of the process: sleeping or running.
 
1318
                  </para>
 
1319
                </listitem>
 
1320
                <listitem>
 
1321
                  <para>
 
1322
                    <guilabel>Memory</guilabel>
 
1323
                  </para>
 
1324
                  <para>
 
1325
                    Select this option to display the amount of system memory that is currently being used by the process.
 
1326
                  </para>
 
1327
                </listitem>
 
1328
                <listitem>
 
1329
                  <para>
 
1330
                    <guilabel>VM Size</guilabel>
 
1331
                  </para>
 
1332
                  <para>
 
1333
                    Select this option to display the amount of virtual memory that is allocated to the process.
 
1334
                  </para>
 
1335
                </listitem>
 
1336
                <listitem>
 
1337
                  <para>
 
1338
                    <guilabel>Resident Memory</guilabel>
 
1339
                  </para>
 
1340
                  <para>
 
1341
                    Select this option to display the amount of physical memory that is allocated to the process.
 
1342
                  </para>
 
1343
                </listitem>
 
1344
                <listitem>
 
1345
                  <para>
 
1346
                    <guilabel>Shared Memory</guilabel>
 
1347
                  </para>
 
1348
                  <para>
 
1349
                    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.
 
1350
                  </para>
 
1351
                </listitem>
 
1352
                <listitem>
 
1353
                  <para>
 
1354
                    <guilabel>RSS Memory</guilabel>
 
1355
                  </para>
 
1356
                  <para>
 
1357
                    Select this option to display the amount of physical memory, excluding swapped-out pages, that is used by the process.
 
1358
                  </para>
 
1359
                </listitem>
 
1360
                <listitem>
 
1361
                  <para>
 
1362
                    <guilabel>X Server Memory</guilabel>
 
1363
                  </para>
 
1364
                  <para>
 
1365
                    Select this option to display the amount of X server memory that is used by the process.
 
1366
                  </para>
 
1367
                </listitem>
 
1368
                <listitem>
 
1369
                  <para>
 
1370
                    <guilabel>% CPU</guilabel>
 
1371
                  </para>
 
1372
                  <para>
 
1373
                    Select this option to display the percentage of CPU time currently being used by the process.
 
1374
                  </para>
 
1375
                </listitem>
 
1376
                <listitem>
 
1377
                  <para>
 
1378
                    <guilabel>Nice</guilabel>
 
1379
                  </para>
 
1380
                  <para>
 
1381
                    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.
 
1382
                  </para>
 
1383
                </listitem>
 
1384
                <listitem>
 
1385
                  <para>
 
1386
                <guilabel>ID</guilabel>
 
1387
                  </para>
 
1388
                  <para>
 
1389
                    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.
 
1390
                  </para>
 
1391
                </listitem>
 
1392
              </itemizedlist>
 
1393
            </listitem>
 
1394
          </varlistentry>
 
1395
        </variablelist>
 
1396
    </sect2>
 
1397
 
 
1398
    <sect2 id="gnome-system-monitor-prefs-resmon">
 
1399
      <title>Resource Monitor</title>
 
1400
        <variablelist>
 
1401
          <varlistentry>
 
1402
            <term><guilabel>Graphs</guilabel></term>
 
1403
            <listitem>
 
1404
              <itemizedlist>
 
1405
                <listitem>
 
1406
                  <para>
 
1407
                    <guilabel>Update interval ... seconds</guilabel>
 
1408
                  </para>
 
1409
                  <para>
 
1410
                    Use this spin box to specify how often you want to update the <application>&app;</application> graphs.
 
1411
                  </para>
 
1412
                </listitem>
 
1413
                <listitem>
 
1414
                  <para>
 
1415
                    <guilabel>Background color</guilabel>
 
1416
                  </para>
 
1417
                  <para>
 
1418
                    Use this button to customize the background color of the <application>&app;</application> graphs, as described in <xref linkend="gnome-system-monitor-customize-background"/>.
 
1419
                  </para>
 
1420
                </listitem>
 
1421
                <listitem>
 
1422
                  <para>
 
1423
                    <guilabel>Grid color</guilabel>
 
1424
                  </para>
 
1425
                  <para>
 
1426
                    Use this button to customize the grid color of the <application>&app;</application> graphs, as described in <xref linkend="gnome-system-monitor-customize-grid"/>.
 
1427
                  </para>
 
1428
                </listitem>
 
1429
              </itemizedlist>
 
1430
            </listitem>
 
1431
          </varlistentry>
 
1432
          <varlistentry>
 
1433
            <term><guilabel>Devices</guilabel></term>
 
1434
            <listitem>
 
1435
              <itemizedlist>
 
1436
                <listitem>
 
1437
                  <para>
 
1438
                    <guilabel>Update interval ... seconds</guilabel>
 
1439
                  </para>
 
1440
                  <para>
 
1441
                    Use this spin box to specify how often you want to update the <guilabel>Devices</guilabel> table.
 
1442
                  </para>
 
1443
                </listitem>
 
1444
              </itemizedlist>
 
1445
            </listitem>
 
1446
          </varlistentry>
 
1447
        </variablelist>
 
1448
    </sect2>
 
1449
 
 
1450
  </sect1>
 
1451
 
 
1452
</article>