<?xml version="1.0" encoding="utf-8"?>
<!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 appletversion "2.10">
<!ENTITY manrevision "2.10">
<!ENTITY date "March 2005">
<!ENTITY applet "System Monitor">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://developer.mate.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en_GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>System Monitor Manual</title> 
    <abstract role="description">
      <para>System Monitor displays system load information in graphical format in a panel.</para>
    </abstract>
    <copyright>
     <year>2005</year>
     <holder>Davyd Madeley</holder>
    </copyright>
    <copyright>
      <year>2004</year>
      <holder>Sun Microsystems</holder>
    </copyright>

    <copyright> 
      <year>2003</year> 
      <year>2004</year> 
      <holder>Chee Bin HOH</holder> 
    </copyright><copyright><year>2007</year><holder>David Lodge (dave@cirt.net)</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> 

      <legalnotice id="legalnotice">
	<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
         <para>This manual is part of a collection of MATE manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.</para>

	<para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any MATE documentation, and the members of the MATE Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>

	<para>DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT: <orderedlist>
		<listitem>
		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORISED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND</para>
		</listitem>
		<listitem>
		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</para>
		</listitem>
	  </orderedlist></para>
  </legalnotice>


<!-- 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>Angela</firstname>
        <surname>Boyle</surname>
	<affiliation><address>
	 <email>aboyle@aboyle.com</email>
	</address></affiliation>
      </author>

      <author> 
	<firstname>Chee Bin</firstname> 
	<surname>HOH</surname> 
	<affiliation> 
	  <orgname>MATE Documentation Project</orgname> 
	  <address><email>cbhoh@mimos.my</email></address>
	</affiliation> 
      </author>

      <author>
       <firstname>Davyd</firstname><surname>Madeley</surname>
       <affiliation>
        <orgname>MATE Project</orgname>
        <address><email>davyd@madeley.id.au</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="2.26" role="review"/>

    <revhistory>
      <revision>
        <revnumber>Version 2.10</revnumber>
	<date>March 2005</date>
	<revdescription>
	  <para role="author">Davyd Madeley</para>
	</revdescription>
      </revision>
    
      <revision>
	<revnumber>Version 2.8</revnumber> 
	<date>August 2004</date> 
	<revdescription> 
          <para role="author">Angela Boyle</para>
          <para role="publisher">MATE Documentation Project</para>
	</revdescription> 
      </revision> 

      <revision> 
	<revnumber>System Monitor Applet Manual V2.1</revnumber> 
	<date>February 2004</date> 
	<revdescription> 
          <para role="author">Sun MATE Documentation Team</para>
          <para role="publisher">MATE Documentation Project</para>
	</revdescription> 
      </revision> 

      <revision> 
	<revnumber>System Monitor Applet Manual V2.0</revnumber> 
	<date>July 2003</date> 
	<revdescription> 
	  <para role="author">Chee Bin HOH <email>cbhoh@mimos.my</email></para> 
	  <para role="publisher">MATE Documentation Project</para> 
	</revdescription> 
      </revision> 

    </revhistory> 

    <releaseinfo>This manual describes version 2.10 of System Monitor.</releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the System Monitor applet or this manual, follow the directions in the <ulink url="ghelp:mate-feedback" type="help">MATE Feedback Page</ulink>.</para>
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>System Monitor Applet</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>System Monitor</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="multiload-introduction"> 
    <title>Introduction</title> 

      <!-- ==== Figure ============================================= -->
      <figure id="system-monitor-applet-fig"> 
        <title>System Monitor</title> 
        <screenshot> 
        <mediaobject> 
          <imageobject><imagedata fileref="figures/system-monitor-applet_window.png" format="PNG"/> 
          </imageobject>
 	  <textobject> 
 	    <phrase>Shows System Monitor. Displays a graph for system CPU load.</phrase> 
          </textobject> 
        </mediaobject> 
	</screenshot> 
      </figure> 
      <!-- ==== End of Figure ======================================= -->

      <para>The <application>System Monitor</application> displays system load information in graphical format in a panel. You can configure <application>System Monitor</application> to display the following information for your system:</para>
      <itemizedlist>
        <listitem>
          <para>Usage of CPU (central processing unit) time</para>
        </listitem>
        <listitem>
          <para>Memory usage</para>
        </listitem>
        <listitem>
          <para>Network traffic</para>
        </listitem>
        <listitem>
          <para>Usage of swap space</para>
        </listitem>
        <listitem>
          <para>Average system load</para>
        </listitem>
	<listitem><para>Disk load</para></listitem>
      </itemizedlist>

      <sect2 id="multiload-introduction-add"> 
        <title>To Add System Monitor to a Panel</title> 
	<para>To add <application>System Monitor</application> to a panel, right-click on the panel, then choose <guimenuitem>Add to Panel</guimenuitem>. Select <application>System Monitor</application> in the <application>Add to the panel</application> dialogue, then click <guibutton>OK</guibutton>.</para>
        <para>The layout of the <application>System Monitor</application> varies depending on the size and type of panel in which the applet resides.</para>     
      </sect2>

  </sect1>

<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the applet to perform the tasks for 
     which the applet is designed. -->
  <sect1 id="multiload-usage"> 
    <title>Viewing Graphs</title> 
	<!-- ================ displaying addistional graphics======================== -->
    <sect2 id="multiload-usage-graphs"> 
      <title>Displaying Additional Graphs</title> 
      <para>To configure the <application>System Monitor</application> applet, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Monitored Resources</guilabel> you can choose which graphics you want to display:</para>
          <itemizedlist>
            <listitem>
              <para>
                <guilabel>Processor</guilabel>
              </para>
              <para>Select this option to display the graph for CPU usage.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Memory</guilabel>
              </para>
              <para>Select this option to display the graph for memory usage.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Network</guilabel>
              </para>
              <para>Select this option to display the graph for network traffic.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Swap Space</guilabel>
              </para>
              <para>Select this option to display the graph for swap-space usage.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Load</guilabel>
              </para>
              <para>Select this option to display the graph for average system load.</para>
            </listitem>
	    <listitem>
	     <para><guilabel>Harddisk</guilabel></para>
	     <para>Select this option to display the graph for disk usage.</para>
	    </listitem>
          </itemizedlist>
    </sect2>
	<!-- ================ displaying current usage of system resources================== -->
    <sect2 id="multiload-usage-current"> 
      <title>To Display the Current Usage of a System Resource</title> 
      <para>To display the current usage of a system resource, position the mouse pointer over the corresponding graph in the applet. A tooltip displays the current usage as a percentage.</para>
    </sect2>
	<!-- ================ displaying additional info================== -->
    <sect2 id="multiload-usage-extra"> 
      <title>To Display Additional System Monitor Information</title>
      <para>To display additional system monitor information, right-click on the applet, then choose <guimenuitem>Open System Monitor</guimenuitem> to start the <application>System Monitor</application> application.</para>
      <para>The <application>System Monitor</application> application enables you to monitor system processes and usage of system resources. You can use the <application>System Monitor</application> application to modify the behavior of your system.</para>
    </sect2>

  </sect1>

<!-- ============= Preferences =========================== -->
  <sect1 id="multiload-prefs">
    <title>Customising Appearance</title> 
      <figure id="system-monitor-prefs-fig"> 
        <title>Preferences Dialogue</title> 
        <screenshot> 
        <mediaobject> 
          <imageobject><imagedata fileref="figures/multiload-preferences.png" format="PNG"/> 
          </imageobject>
 	  <textobject> 
 	    <phrase>Preferences Dialogue</phrase> 
          </textobject> 
        </mediaobject> 
	</screenshot> 
      </figure> 
    <sect2 id="multiload-size">
        <title>To Change the Width</title>
              <para>In the right-click menu, go to <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Options</guilabel>, use the <guilabel>System monitor width</guilabel> spin box to specify the width of each <application>System Monitor</application> graph in pixels.</para>
  </sect2>
  <sect2 id="multiload-update">
        <title>To Update at Regular Intervals</title>
              <para>In the right-click menu, go to <guimenuitem>Preferences</guimenuitem>. Under <guilabel>Options</guilabel>, use the <guilabel>System monitor update interval</guilabel> spin box to specify the interval at which you want to update the graphs in milliseconds.</para>
    </sect2>
	<!-- ================ changing graph colors======================== -->
    <sect2 id="multiload-usage-colors"> 
      <title>Changing the Colours in a Graph</title>
      <para>To change the colours in a graph, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>Right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>.</para>
        </listitem>
        <listitem>
          <para>Select the relevant tab in the <guilabel>Colours</guilabel> area of the <guilabel>System Monitor Preferences</guilabel> dialogue.</para>
        </listitem>
        <listitem>
          <para>Click on the relevant colour selector button in the selected tabbed section.</para>
        </listitem>
        <listitem>
          <para>On the <guilabel>Pick a Colour</guilabel> dialogue, use the colour wheel or spin boxes to choose the line colour for the selected parameter.</para>
        </listitem>
        <listitem>
          <para>Click <guibutton>OK</guibutton>.</para>
        </listitem>
      </orderedlist>
      <para>The tabbed section for each resource provides colour selection buttons that you can use to change the colour of the parameters for each resource.</para>
          <itemizedlist>
            <listitem>
              <para>
                <guilabel>Processor</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
                      <entry><para><guilabel>User</guilabel></para></entry>
                      <entry><para>Processor time used by non-kernel activities</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>System</guilabel></para></entry>
                      <entry><para>Processor time used by kernel activities</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Nice</guilabel></para></entry>
                      <entry><para>Processor time used by low-priority processes</para></entry>
                    </row>
		    <row valign="top">
		      <entry><para><guilabel>IOWait</guilabel></para></entry>
		      <entry>
		       <para>Processor time used waiting for I/O</para>
		      </entry>
		    </row>
                    <row valign="top">
                      <entry><para><guilabel>Idle</guilabel></para></entry>
                      <entry><para>Unused processory capacity</para></entry>
                    </row>
                  </tbody>
                </tgroup>
              </informaltable>
            </listitem>
            <listitem>
              <para>
                <guilabel>Memory</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
                      <entry><para><guilabel>User</guilabel></para></entry>
                      <entry><para>Memory used by non-kernel activities</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Shared</guilabel></para></entry>
                      <entry><para>Memory used by more than one application</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Buffers</guilabel></para></entry>
                      <entry><para>Memory used to temporarily store sent or received data</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Cached</guilabel></para></entry>
                      <entry><para>Memory used to store data for fast access</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Free</guilabel></para></entry>
                      <entry><para>Memory not currently in use</para></entry>
                    </row>
                  </tbody>
                </tgroup>
              </informaltable>
            </listitem>
            <listitem>
              <para>
                <guilabel>Network</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
                      <entry><para><guilabel>SLIP</guilabel></para></entry>
                      <entry><para>Serial Line Internet Protocol network connection</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>PLIP</guilabel></para></entry>
                      <entry><para>Parallel Line Internet Protocol network connection</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Ethernet</guilabel></para></entry>
                      <entry><para>Ethernet network connection</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Other</guilabel></para></entry>
                      <entry><para>Network connection other than SLIP, PLIP, or Ethernet</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Background</guilabel></para></entry>
                      <entry><para>No network connection</para></entry>
                    </row>
                  </tbody>
                </tgroup>
              </informaltable>
            </listitem>
            <listitem>
              <para>
                <guilabel>Swap Space</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
		     <entry><para><guilabel>Used</guilabel></para></entry>
		     <entry>
		      <para>Swap space being used by the system</para>
		     </entry>
		    </row>
		    <row valign="top">
		     <entry><para><guilabel>Free</guilabel></para></entry>
		     <entry>
		      <para>Swap space that is free to be used</para>
		     </entry>
		    </row>
		  </tbody>
		</tgroup>
              </informaltable>
            </listitem>
            <listitem>
              <para>
                <guilabel>Load</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
		     <entry><para><guilabel>Average</guilabel></para></entry>
		     <entry><para>System Load</para></entry>
		    </row>
		    <row valign="top">
		     <entry><para><guilabel>Background</guilabel></para></entry>
		     <entry><para>that is, no load</para></entry>
		    </row>
		  </tbody>
		</tgroup>
	      </informaltable>
            </listitem>
            <listitem>
              <para>
                <guilabel>Harddisk</guilabel>
              </para>
              <para>Select this tab to display the colour buttons for the following parameters:</para>
              <informaltable frame="all">
                <tgroup cols="2" colsep="1" rowsep="1">
                  <colspec colname="COLSPEC0" colwidth="50*"/>
                  <colspec colname="COLSPEC1" colwidth="50*"/>
                  <thead>
                    <row valign="top">
                      <entry colname="COLSPEC0">
                        <para>Parameter</para></entry>
                      <entry colname="COLSPEC1">
                        <para>Description</para></entry>
                    </row>
                  </thead>
                  <tbody>
                    <row valign="top">
                      <entry><para><guilabel>Read</guilabel></para></entry>
                      <entry><para>Disk read rate</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Write</guilabel></para></entry>
                      <entry><para>Disk write rate</para></entry>
                    </row>
                    <row valign="top">
                      <entry><para><guilabel>Background</guilabel></para></entry>
                      <entry><para>Idle disk time</para></entry>
                    </row>
		  </tbody>
		</tgroup>
	      </informaltable>
	    </listitem>
          </itemizedlist>
    </sect2>
  </sect1>
</article>
