path: root/help/C/index.docbook

<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "1.10.0">
  <!ENTITY manrevision "2.3">
  <!ENTITY date "July 2015">
  <!ENTITY app "System Monitor">
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&app; Manual V&manrevision;</title>       

	 <copyright>
		<year>2015</year>
		<holder>MATE Documentation Project</holder> </copyright>
    <copyright>
      <year>2009</year>
      <holder>Paul Cutler</holder>
    </copyright>
    <copyright>
      <year>2004</year>
      <holder>Sun Microsystems</holder>
    </copyright>
    <copyright> 
      <year>2001</year>
      <year>2002</year> 
      <year>2004</year> 
      <holder>Bill Day</holder> 
    </copyright> 

<!-- translators: uncomment this:
  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
   -->

    <publisher role="maintainer">
      <publishername> MATE Documentation Project </publishername> 
    </publisher>
    <publisher>
      <publishername> GNOME Documentation Project </publishername>
    </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

  <authorgroup> 
	<author>
	  <firstname>MATE Documentation Project</firstname>
	  <surname></surname>
	  <affiliation>
		 <orgname>MATE Desktop</orgname>
	  </affiliation>
	</author>
    <author>
      <firstname>Sun</firstname>
      <surname>GNOME Documentation Team</surname>
      <affiliation><orgname>Sun Microsystems</orgname></affiliation>
    </author>
    <author> 
      <firstname>Bill</firstname> 
      <surname>Day</surname> 
      <affiliation><address><email>billday@bellatlantic.net</email></address></affiliation> 
    </author> 
      <author>
        <firstname>Paul</firstname>
        <surname>Cutler</surname>
        <affiliation>
          <orgname>GNOME Documentation Project</orgname>
          <address><email>pcutler@foresightlinux.org</email></address>
        </affiliation>
      </author>
      
<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
     
    <othercredit role="translator">
      <firstname>Latin</firstname> 
      <surname>Translator 1</surname> 
      <affiliation> 
	<orgname>Latin Translation Team</orgname> 
	<address> <email>translator@gnome.org</email> </address> 
      </affiliation>
      <contrib>Latin translation</contrib>
    </othercredit>
-->
    </authorgroup>

    <releaseinfo revision="1.10" role="review">
    </releaseinfo>

    <revhistory>
      <revision> 
	<revnumber>System Monitor Manual V&manrevision;</revnumber> 
	<date>July 2015</date>
	<revdescription>
	  <para role="author">MATE Documentation Team</para>
	  <para role="publisher">MATE Documentation Project</para>
	</revdescription>
      </revision>
      <revision>
	<revnumber>System Monitor Manual V2.2;</revnumber>
	<date>March 2009</date>
	<revdescription> 
	  <para role="author">Paul Cutler
	    <email>pcutler@foresightlinux.org</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
      <revision> 
	<revnumber>System Monitor Manual V2.1</revnumber>
	<date>February 2004</date>
	<revdescription>
	  <para role="author">Sun GNOME Documentation Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision>
      <revision>
	<revnumber>System Monitor Manual V2.0</revnumber>
	<date>November 2002</date>
	<revdescription>
	  <para role="author">Bill Day <email>billday@bellatlantic.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision>
      <revision>
	<revnumber>Procman Manual V0.11</revnumber>
	<date>January 2002</date>
	<revdescription>
	  <para role="author">Bill Day 
	    <email>billday@bellatlantic.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision>
    </revhistory> 

    <releaseinfo>
      This manual describes version &appversion; of &app;.
    </releaseinfo> 

    <legalnotice>
      <title>Feedback</title>
      <para>
        To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.
      </para>

<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
      <para>
	&app; gives users a graphical user interface for monitoring CPU,
	network, and memory activities as well as a way for viewing
	and stopping system processes.
      </para>
    </abstract>
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>System Monitor</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>mate-system-monitor</primary> 
  </indexterm>
  <indexterm zone="index"> 
    <primary>procman</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
 <!-- ============= Introduction ============================== -->
  <sect1 id="mate-system-monitor-intro">
    <title>Introduction</title>
    <para>
      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.
    </para>
    <para>
      The <application>&app;</application> window contains four tabbed sections:
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <guilabel>System</guilabel>
        </term>
        <listitem>
          <para>Displays various basic information about the computer's hardware and software.</para>
          <variablelist>
            <varlistentry>
              <term>
                Distribution
              </term>
              <listitem>
                <itemizedlist>
                  <listitem>
                    <para>Distribution version</para>
                  </listitem>
                  <listitem>
                    <para>Linux Kernel version</para>
                  </listitem>
                  <listitem>
                    <para>MATE version</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                Hardware
              </term>
              <listitem>
                <itemizedlist>
                  <listitem>
                    <para>Installed memory</para>
                  </listitem>
                  <listitem>
                    <para>Processors and speeds</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </varlistentry>
            <varlistentry>
              <term>
                System Status
              </term>
              <listitem>
                <itemizedlist>
                  <listitem>
                    <para>Currently available disk space</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </varlistentry>
          </variablelist>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Processes</guilabel>
        </term>
        <listitem>
          <para>
            Shows active processes, and how processes are related to each other. Provides detailed information about individual processes, and enables you to control active processes.  
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>Resources</guilabel>
        </term>
        <listitem>
          <para>
            Displays the current usage of the following system resources:
          </para>
          <itemizedlist>
            <listitem>
              <para>
                CPU (central processing unit) time
              </para>
            </listitem>
            <listitem>
              <para>
                Memory and swap space 
              </para>
            </listitem>
            <listitem>
              <para>
                Network usage
              </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <guilabel>File Systems</guilabel>
        </term>
        <listitem>
          <para>
            Lists all mounted file systems along with basic information about each.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect1>

<!-- ============= Getting Started =========================== -->
  <sect1 id="mate-system-monitor-getting-started">
    <title>Getting Started</title>
                                                                                
<!-- ============= To Start System Monitor ============================ -->
    <sect2 id="mate-system-monitor-to-start">
      <title>To Start &app;</title>
      <para>You can start <application>&app;</application> in the following ways:</para>
      <variablelist>
        <varlistentry>
          <term><guimenu>System</guimenu> menu</term>
          <listitem>
            <para>
              Choose <menuchoice><guimenu>Administration</guimenu> <guimenuitem>System Monitor</guimenuitem></menuchoice>.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Command line</term>
          <listitem>
            <para>
              Execute the following command: <command>mate-system-monitor</command></para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	
    <sect2 id="mate-system-monitor-when-you-start">
      <title>When You Start &app;</title>	
      <para>
        When you start <application>&app;</application>, the following window is displayed:
      </para>
      <figure id="mate-system-monitor-window"> 
        <title>&app; Window</title>
        <screenshot> 
          <mediaobject> 
            <imageobject> 
              <imagedata fileref="figures/mate-system-monitor_window.png" format="PNG"/>
            </imageobject>
            <textobject> <phrase>Shows System Monitor main window.</phrase>
            </textobject> 
          </mediaobject>
        </screenshot>
      </figure>
      <para>
        The <application>&app;</application> window contains the following elements: 
      </para>
      <variablelist> 
        <varlistentry> 
          <term>Menubar</term> 
          <listitem> 
            <para>
              The menus on the menubar contain all the commands that you need to work with <application>&app;</application>.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry> 
          <term>Display area</term> 
          <listitem> 
            <para>
              The display area contains the system monitor information. The display area contains the following tabbed sections:
            </para>
            <itemizedlist>
              <listitem>
                <para>
                  <guilabel>System</guilabel>
                </para>
                <para>
                  Contains a list of basic system properties, such as system software versions and hardware specifications and status.
                </para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Processes</guilabel>
                </para>
                <para>
                  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.
                </para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Resources</guilabel>
                </para>
                <para>
                  Contains a <guilabel>CPU History</guilabel> graph, a <guilabel>Memory and Swap History</guilabel> graph, and a <guilabel>Network History</guilabel> graph.
                </para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>File Systems</guilabel>
                </para>
                <para>
                  Contains a table of currently mounted file systems.
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
        </varlistentry>
        <varlistentry> 
          <term>Statusbar</term> 
          <listitem> 
            <para>
              The statusbar displays information about current <application>&app;</application> activity and contextual information about the menu items. 
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>


 <!-- ================ Usage ================================ -->
 <!-- This section should describe basic usage of the application. -->

  <sect1 id="mate-system-monitor-usage">
    <title>Usage</title>

    <sect2 id="mate-system-monitor-display-basic-info">
      <title>To Display Basic System Information</title>
      <para>
        To display basic system information, select the <guilabel>System</guilabel> tab.
      </para>
      <para>
        In the <guilabel>System</guilabel> tab, information is organized into three groups:
      </para>
      <itemizedlist>
	<listitem>
	  <para>
	    System Information
	  </para>
	</listitem>
	<listitem>
	  <para>
	    Hardware
	  </para>
	</listitem>
	<listitem>
	  <para>
	    System Status
	  </para>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="mate-system-monitor-display-processlist">
      <title>To Display the Process List</title>
      <para>
        To display the process list, select the <guilabel>Processes</guilabel> tab.
      </para>
      <para>
        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:
      </para>
      <itemizedlist>
          <listitem>
            <para>Process Name</para>
          </listitem>
          <listitem>
            <para>Status</para>
          </listitem>
          <listitem>
            <para>%CPU</para>
          </listitem>
          <listitem>
            <para>Nice</para>
          </listitem>
          <listitem>
            <para>ID</para>
          </listitem>
          <listitem>
            <para>Memory</para>
          </listitem>
      </itemizedlist>
        <para>
          For information about how to change the columns displayed in the process list, see <xref linkend="mate-system-monitor-prefs-proclist"/>.
        </para>

      <sect3 id="mate-system-monitor-display-processlist-child">
        <title>Parent Processes and Child Processes</title>
        <para>
          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="mate-system-monitor-modify-processlist-viewdeps"/>.
        </para>
      </sect3>

      <sect3 id="mate-system-monitor-display-processlist-priority">
        <title>Process Priority and Nice Values</title>
      <para>
        Processes run in order of priority: high-priority processes run before low-priority processes. Child processes generally inherit their priority from their parent process.
      </para>
      <para>
        The priority of a process is set by the nice value of the process, as follows: 
      </para>
      <itemizedlist>
        <listitem>
          <para>
            A nice value of 0 means that the process has normal priority.
          </para>
        </listitem>
        <listitem>
          <para>
            The higher the nice value, the lower the priority.
          </para>
        </listitem>
        <listitem>
          <para>
            The lower the nice value, the higher the priority.
          </para>
        </listitem>
      </itemizedlist>
      <para>
        For information about how to change the priority of a process, see <xref linkend="mate-system-monitor-change-priority"/>.
      </para>
      </sect3>

    </sect2>

    <sect2 id="mate-system-monitor-sort-processlist">
      <title>To Sort the Process List</title>
      <para>
        To sort the process list, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Select the <guilabel>Processes</guilabel> tab to display the process list.
          </para>
        </listitem>
        <listitem>
          <para>
            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.
          </para>
        </listitem>
        <listitem>
          <para>
            Click on any column header to sort the processes by the information in that column, in alphabetical or numerical order. 
          </para>
        </listitem>
        <listitem>
          <para>
            Click again on the column header to sort the data in reverse alphabetical or reverse numerical order.
          </para>
        </listitem>
      </orderedlist>
    </sect2>

    <sect2 id="mate-system-monitor-modify-processlist">
      <title>To Modify the Contents of the Process List</title>
      <para>
        You can modify the contents of the process list in several ways.
      </para>

      <sect3 id="mate-system-monitor-modify-processlist-all">
        <title>To Show All Processes</title>
        <para>
          To show all processes in the process list, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Processes</guilabel> tab to display the process list.
            </para>
          </listitem>
          <listitem>
            <para>
              Choose
	      <menuchoice>
		<guimenu>View</guimenu>
		<guimenuitem>All Processes</guimenuitem>
	      </menuchoice>.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-modify-processlist-my">
        <title>To Show Only Processes Owned by the Current User</title>
        <para>
          To show only the processes that are owned by the current user, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Processes</guilabel> tab to display the process list.
            </para>
          </listitem>
          <listitem>
            <para>
              Choose 
	      <menuchoice>
		<guimenu>View</guimenu>
		<guimenuitem>My Processes</guimenuitem>
	      </menuchoice>.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-modify-processlist-active">
        <title>To Show Only Active Processes</title>
        <para>
          To show only the active processes in the process list, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Processes</guilabel> tab to display the process list.
            </para>
          </listitem>
          <listitem>
            <para>
              Choose 
	      <menuchoice>
		<guimenu>View</guimenu>
		<guimenuitem>Active Processes</guimenuitem>
	      </menuchoice>.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-modify-processlist-viewdeps">
        <title>To Show Dependencies</title>
        <para>
          To show process dependencies in the process list, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Processes</guilabel> tab to display the process list.
            </para>
          </listitem>
          <listitem>
            <para>
              Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Dependencies</guimenuitem></menuchoice>.
            </para>
          </listitem>
        </orderedlist>
        <para>
          If the <guimenuitem>Dependencies</guimenuitem> menu item is selected, the processes are listed as follows:
        </para>
        <itemizedlist>
          <listitem>
            <para>
              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.  
            </para>
          </listitem>
          <listitem>
            <para>
              Child processes are indented, and listed with their parent process.
            </para>
          </listitem>
        </itemizedlist>
        <para>
          If the <guimenuitem>Dependencies</guimenuitem> menu item is not selected: 
        </para>
        <itemizedlist>
          <listitem>
            <para>
              Parent processes and child processes are not distinguishable.
            </para>
          </listitem>
          <listitem>
            <para>
              All processes are listed in alphabetical order.
            </para>
          </listitem>
        </itemizedlist>
      </sect3>

    </sect2>

    <sect2 id="mate-system-monitor-memory-map">
      <title>To Display Memory Maps for a Process</title>
      <para>
        To display memory maps for a process, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Select the <guilabel>Processes</guilabel> tab to display the process list.
          </para>
        </listitem>
        <listitem>
          <para>
            Select the process in the process list. 
          </para>
        </listitem>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>View</guimenu><guimenuitem>Memory Maps</guimenuitem></menuchoice>.
          </para>
        </listitem>
      </orderedlist>
      <para>
        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:
      </para>
      <variablelist>
        <varlistentry>
          <term><guilabel>Filename</guilabel></term>
          <listitem>
            <para>
              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. 
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>VM Start</guilabel></term>
          <listitem>
            <para>
              The address at which the memory segment begins.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>VM End</guilabel></term>
          <listitem>
            <para>
              The address at which the memory segment ends.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>VM Size</guilabel></term>
          <listitem>
            <para>
              The size of the memory segment.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Flags</guilabel></term>
          <listitem>
            <para>
              The following flags describe the different types of memory-segment access that the process can have:
            </para>
            <variablelist>
              <varlistentry>
                <term>p</term>
                <listitem>
                  <para>
                    The memory segment is private to the process, and is not accessible to other processes.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>r</term>
                <listitem>
                  <para>
                    The process has permission to read from the memory segment.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>s</term>
                <listitem>
                  <para>
                    The memory segment is shared with other processes.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>w</term>
                <listitem>
                  <para>
                    The process has permission to write into the memory segment.
                  </para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>x</term>
                <listitem>
                  <para>
                    The process has permission to execute instructions that are contained within the memory segment.
                  </para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>VM Offset</guilabel></term>
          <listitem>
            <para>
              The virtual memory offset of the memory segment.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Device</guilabel></term>
          <listitem>
            <para>
              The major and minor device numbers of the device on which the shared library filename is located.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Inode</guilabel></term>
          <listitem>
            <para>
              The inode on the device from which the shared library location is loaded into memory.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
      <para>
        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.
      </para>
      <para>
        Click <guibutton>Close</guibutton> to close the <guilabel>Memory Maps</guilabel> dialog.
      </para>
    </sect2>

    <sect2 id="mate-system-monitor-change-priority">
      <title>To Change the Priority of a Process</title>
      <para>
        To change the priority of a process, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Select the <guilabel>Processes</guilabel> tab to display the process list.
          </para>
        </listitem>
        <listitem>
          <para>
            Select the process for which you want to change the priority.
          </para>
        </listitem>
        <listitem>
          <para>
            Select the priority in <menuchoice><guimenu>Edit</guimenu><guimenuitem>Change Priority</guimenuitem></menuchoice>. If the <guimenuitem>Custom</guimenuitem> menu item is selected, the <guilabel>Change Priority</guilabel> dialog is displayed, and continue as follows.
          </para>
        </listitem>
        <listitem>
          <para>
            Use the slider to set the nice value of the process.
          </para>
          <para>
            The nice value sets the priority of the process: the lower the nice value, the higher the priority.
          </para>
          <para>
            To specify a nice value lower than zero, non-root users must enter the root password. 
          </para>
        </listitem>
        <listitem>
          <para>
            Click on the <guibutton>Change Priority</guibutton> button.
          </para>
        </listitem>
      </orderedlist>
    </sect2>


    <sect2 id="mate-system-monitor-end-process">
      <title>To End a Process</title>
      <para>
        To end a process, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Select the <guilabel>Processes</guilabel> tab to display the process list.
          </para>
        </listitem>
        <listitem>
          <para>
            Select the process that you want to end.
          </para>
        </listitem>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>End Process</guimenuitem></menuchoice>, or click on the <guibutton>End Process</guibutton> button.
          </para>
          <para>
            By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see <xref linkend="mate-system-monitor-prefs-proclist"/>.
          </para>
        </listitem>
        <listitem>
          <para>
            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.
          </para>
        </listitem>
      </orderedlist>
      <para>
        This is the preferred way to stop a process.
      </para>
    </sect2>

    <sect2 id="mate-system-monitor-terminate-process">
      <title>To Terminate a Process</title>
      <para>
        To terminate a process, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Select the <guilabel>Processes</guilabel> tab to display the process list.
          </para>
        </listitem>
        <listitem>
          <para>
            Select the process that you want to terminate.
          </para>
        </listitem>
        <listitem>
          <para>
            Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Kill Process</guimenuitem></menuchoice>.
          </para>
          <para>
            By default, a confirmation alert is displayed. For information about how to display or hide the confirmation alert, see <xref linkend="mate-system-monitor-prefs-proclist"/>.
          </para>
        </listitem>
        <listitem>
          <para>
            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.
          </para>
        </listitem>
      </orderedlist>
      <para>
        You usually terminate a process only if you cannot end the process normally as described in <xref linkend="mate-system-monitor-end-process"/>.
      </para>
    </sect2>

    <sect2 id="mate-system-monitor-cpu">
      <title>To Monitor CPU Usage</title>
      <para>
        To monitor CPU usage, select the <guilabel>Resources</guilabel> tab.
      </para>
      <para>
        <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.
      </para>
    </sect2>


    <sect2 id="mate-system-monitor-memory">
      <title>To Monitor Memory and Swap Usage</title>
      <para>
        To monitor memory and swap usage, select the <guilabel>Resources</guilabel> tab.
      </para>
      <para>
        <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: 
      </para>
      <itemizedlist>
        <listitem>
          <para>
            Used memory out of total memory
          </para>
        </listitem>
        <listitem>
          <para>
            Used swap out of total swap
          </para>
        </listitem>
      </itemizedlist>

    </sect2>
    
    <sect2 id="mate-system-monitor-network">
      <title>To Monitor Network Activity</title>
      <para>
        To monitor network activity, select the <guilabel>Resources</guilabel> tab.
      </para>
      <para>
        <application>&app;</application> displays the network history in graphical format. Underneath the graph, <application>&app;</application> also displays the following numerical values: 
      </para>
      <itemizedlist>
        <listitem>
          <para>
            Received data per second and total
          </para>
        </listitem>
        <listitem>
          <para>
            Sent data per second and total
          </para>
        </listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="mate-system-monitor-disk">
      <title>To Monitor File Systems</title>
      <para>
        To monitor file systems, select the <guilabel>File Systems</guilabel> tab.
      </para>
      <para>
        <application>&app;</application> displays mounted file systems in tabular format. From left to right, the table displays the following columns:
      </para>
      <variablelist>
        <varlistentry>
          <term>
            Device
          </term>
          <listitem>
            <para>Location of block file</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Directory
          </term>
          <listitem>
            <para>Mount point (directory to access) of device</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Type
          </term>
          <listitem>
            <para>File system type</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Total
          </term>
          <listitem>
            <para>Total capacity</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Free
          </term>
          <listitem>
            <para>Amount of space not in use</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Available
          </term>
          <listitem>
            <para>Amount of space which can be used</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            Used
          </term>
          <listitem>
            <para>Amount of space which is used (and percentage of Total)</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="mate-system-monitor-customize">
      <title>To Customize the Resources Tabbed Section</title>
      <para>
        You can customize the <guilabel>Resources</guilabel> tabbed section in the following ways:
      </para>
      <itemizedlist>
        <listitem>
          <para><xref linkend="mate-system-monitor-customize-background"/>
          </para>
        </listitem>
        <listitem>
          <para><xref linkend="mate-system-monitor-customize-grid"/>
          </para>
        </listitem>
        <listitem>
          <para><xref linkend="mate-system-monitor-customize-cpu"/>
          </para>
        </listitem>
        <listitem>
          <para><xref linkend="mate-system-monitor-customize-mem"/>
          </para>
        </listitem>
      </itemizedlist>

      <sect3 id="mate-system-monitor-customize-background">
        <title>To Change the Background Color of Graphs</title>
        <para>
          To change the background color of the <application>&app;</application> graphs, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. The <guilabel>Preferences</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Select the <guilabel>Resources</guilabel> tab in the <guilabel>Preferences</guilabel> dialog.
            </para>
          </listitem>
          <listitem>
            <para>
              Click on the <guilabel>Background color</guilabel> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>Close</guibutton> to close the <guilabel>Preferences</guilabel> dialog.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-customize-grid">
        <title>To Change the Grid Color of Graphs</title>
        <para>
          To change the grid color of the <application>&app;</application> graphs, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>. The <guilabel>Preferences</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Select the <guilabel>Resources</guilabel> tab in the <guilabel>Preferences</guilabel> dialog.
            </para>
          </listitem>
          <listitem>
            <para>
              Click on the <guilabel>Grid color</guilabel> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>Close</guibutton> to close the <guilabel>Preferences</guilabel> dialog.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-customize-cpu">
        <title>To Change the Line Color of the CPU Graph</title>
        <para>
          To change the color of the line that represents CPU usage in the <guilabel>CPU History</guilabel> graph, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Resources</guilabel> tab in the <guilabel>System Monitor</guilabel> window, to display the graphs and table that provide information about the usage of system resources.
            </para>
          </listitem>
          <listitem>
            <para>
              Click on the <guibutton>CPU</guibutton> color button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

      <sect3 id="mate-system-monitor-customize-mem">
        <title>To Change the Line Colors of the Memory and Swap Graph</title>
        <para>
          To change the color of the lines that represent memory and swap usage in the graph, perform the following steps:
        </para>
        <orderedlist>
          <listitem>
            <para>
              Select the <guilabel>Resources</guilabel> tab in the <guilabel>System Monitor</guilabel> window, to display the graphs and table that provide information about the usage of system resources.
            </para>
          </listitem>
          <listitem>
            <para>
              Click on the <guibutton>User memory</guibutton> or <guibutton>Used swap</guibutton> button. The <guilabel>Pick a color</guilabel> dialog is displayed. 
            </para>
          </listitem>
          <listitem>
            <para>
              Choose a color from the <guilabel>Palette</guilabel>, or use the color wheel or the spin boxes to customize the color. 
            </para>
          </listitem>
          <listitem>
            <para>
              Click <guibutton>OK</guibutton> to close the <guilabel>Pick a color</guilabel> dialog.
            </para>
          </listitem>
        </orderedlist>
      </sect3>

    </sect2>

  </sect1>

  <sect1 id="mate-system-monitor-prefs">
    <title>Preferences</title>
    <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:
    </para>
    <itemizedlist>
      <listitem>
        <para><xref linkend="mate-system-monitor-prefs-proclist"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="mate-system-monitor-prefs-resmon"/></para>
      </listitem>
    </itemizedlist>

    <sect2 id="mate-system-monitor-prefs-proclist">
      <title>Processes</title>
        <variablelist>
          <varlistentry>
            <term>
              <guilabel>Behavior</guilabel>
            </term>
            <listitem>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Update interval in seconds</guilabel>
                  </para>
                  <para>
                    Use this spin box to specify the interval at which you want to update the process list. 
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Enable smooth refresh</guilabel>
                  </para>
                  <para>
                    Select this option to refresh smoothly.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Alert before ending or killing processes</guilabel>
                  </para>
                  <para>
                    Select this option to display a confirmation alert when you end a process or terminate a process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Solaris mode</guilabel>
                  </para>
                  <para>
                    Select this to divide each process' CPU% in the Processes table by the number of CPUs.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <guilabel>Information Fields</guilabel>
            </term>
            <listitem>
              <para>
                Use the following options to select which fields are displayed in the process list:
              </para>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Process Name</guilabel>
                  </para>
                  <para>
                    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.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>User</guilabel>
                  </para>
                  <para>
                    Select this option to display the name of the user who owns the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Status</guilabel>
                  </para>
                  <para>
                    Select this option to display the current status of the process: sleeping or running.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Virtual Memory</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of virtual memory that is allocated to the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Resident Memory</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of physical memory that is allocated to the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Writable Memory</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of memory that can be written by the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Shared Memory</guilabel>
                  </para>
                  <para>
                    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.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>X Server Memory</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of X server memory that is used by the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>% CPU</guilabel>
                  </para>
                  <para>
                    Select this option to display the percentage of CPU time currently being used by the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>CPU Time</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of CPU time that has been used by the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Started</guilabel>
                  </para>
                  <para>
                    Select this option to display when the process began running.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Nice</guilabel>
                  </para>
                  <para>
                    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.
                  </para>
                </listitem>
                <listitem>
                  <para>
                <guilabel>ID</guilabel>
                  </para>
                  <para>
                    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.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Memory</guilabel>
                  </para>
                  <para>
                    Select this option to display the amount of system memory that is currently being used by the process.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Security Context</guilabel>
                  </para>
                  <para>
                    Select this option to display the security context in which the process is running.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Command Line</guilabel>
                  </para>
                  <para>
                    Select this option to display the command line that was used to start the process, including arguments.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="mate-system-monitor-prefs-resmon">
      <title>Resources</title>
        <variablelist>
          <varlistentry>
            <term><guilabel>Graphs</guilabel></term>
            <listitem>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Update interval in seconds</guilabel>
                  </para>
                  <para>
                    Use this spin box to specify how often you want to update the <application>&app;</application> graphs.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Background color</guilabel>
                  </para>
                  <para>
                    Use this button to customize the background color of the <application>&app;</application> graphs, as described in <xref linkend="mate-system-monitor-customize-background"/>.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Grid color</guilabel>
                  </para>
                  <para>
                    Use this button to customize the grid color of the <application>&app;</application> graphs, as described in <xref linkend="mate-system-monitor-customize-grid"/>.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><guilabel>File Systems</guilabel></term>
            <listitem>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Update interval in seconds</guilabel>
                  </para>
                  <para>
                    Use this spin box to specify how often you want to update the <guilabel>File Systems</guilabel> table.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Show all file systems</guilabel>
                  </para>
                  <para>
                    Select this option to show all file systems, including temporary and system ones.
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
        </variablelist>
    </sect2>

  </sect1>

</article>