<HTML
><HEAD
><TITLE
>Load Average Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Load Average Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Telsa Gywnne and Eric Baudais</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#LOADAVG-APPLET"
>The load average applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="LOADAVG-APPLET"
>The load average applet</A
></H1
><P
> 
     The <TT
CLASS="APPLICATION"
>loadavg_applet</TT
> is a small monitor
     applet which sits in your panel and tells you the current load
     average.  
   </P
><P
>     The load average of a machine is a rather arbitrary number which
     represents how "busy" your machine is. It is calculated as an 
     average of (very roughly) how many processes there are which are
     either running or are waiting for a wake-up call from the kernel.
     It is very useful for comparing over time with different load 
     averages on your machine, but it is not very useful to compare
     it with other machines. Normally, it is represented as a fraction.

    <DIV
CLASS="FIGURE"
><A
NAME="LOADAVG-APPLET-FIG"
></A
><P
><IMG
SRC="loadavg-applet.png"></P
><P
><B
>Figure 1. Load Average Applet</B
></P
></DIV
>
  </P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOADAVG-USAGE"
>Usage</A
></H2
><P
>      You don't need to do anything to this applet. It will sit and
      run in your panel. Various options to alter its display are
      available. 
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOADAVG-RIGHT-CLICK"
>Right-Click Pop-Up Menu Items</A
></H2
><P
> 
      In addition to the standard menu items,
      the right-click pop-up menu has the following items: 
     </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Default Properties...</DT
><DD
><P
>         This opens the <TT
CLASS="GUILABEL"
><B
>multiload_applet dialogue box</B
></TT
>
         <A
HREF="index.html#LOADAVG-PROPERTIES"
>described below</A
> which allows 
         you to alter the default properties of this and related monitor 
         applets.
       </P
></DD
><DT
>Properties...</DT
><DD
><P
>         This opens the <TT
CLASS="GUILABEL"
><B
>multiload_applet dialogue box</B
></TT
>
         <A
HREF="index.html#LOADAVG-PROPERTIES"
>described below</A
> which
         affects only the <TT
CLASS="APPLICATION"
>loadavg_applet</TT
>
         properties.
       </P
></DD
><DT
>Run gtop...</DT
><DD
><P
>         This option will run the <B
CLASS="COMMAND"
>gtop</B
> which
         starts up the GNOME System Monitor. <TT
CLASS="APPLICATION"
>gtop</TT
>
         gives a much more detailed look at your system and what's happening
         on it. 
       </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOADAVG-PROPERTIES"
>Properties</A
></H2
><DIV
CLASS="FIGURE"
><A
NAME="LOADAVG-DEFAULT-FIG"
></A
><P
><IMG
SRC="loadavg-applet-default.png"></P
><P
><B
>Figure 2. Default Properties Dialog</B
></P
></DIV
><P
>      Like several of the monitor applets,
      <TT
CLASS="APPLICATION"
>loadavg_applet</TT
> has two ways of setting
      preferences. You can make changes that affect any of this group of
      applets, 
      (<TT
CLASS="APPLICATION"
>cpuload_applet</TT
>, <TT
CLASS="APPLICATION"
>memload_applet</TT
>,
      <TT
CLASS="APPLICATION"
>swapload_applet</TT
>, <TT
CLASS="APPLICATION"
>netload_applet</TT
>
      and <TT
CLASS="APPLICATION"
>loadavg_applet</TT
>) in one large dialogue
      box. This is useful if you run one or more of them. These are the
      settings used by default. They are reached from the
      <B
CLASS="GUIMENUITEM"
>Default Properties...</B
> menu item.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="LOADAVG-GREYED-FIG"
></A
><P
><IMG
SRC="loadavg-applet-greyed.png"></P
><P
><B
>Figure 3. Greyed Out Properties Dialog</B
></P
></DIV
><P
>      Or you can change just the properties for 
      <TT
CLASS="APPLICATION"
>loadavg_applet</TT
>. This is useful for when
      you only use <TT
CLASS="APPLICATION"
>loadavg_applet</TT
> or want to
      try new combinations out. It is reached from the 
      <B
CLASS="GUIMENUITEM"
>Properties</B
> menu item.
    </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>      If you use the <B
CLASS="GUIMENUITEM"
>Properties...</B
> menu item
      and edit the preferences for just this applet, you must uncheck
      the <B
CLASS="GUIBUTTON"
>Use default properties</B
> checkbox before
      you can alter any settings.
     </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="FIGURE"
><A
NAME="LOADAVG-PROPERTIES-FIG"
></A
><P
><IMG
SRC="loadavg-applet-properties.png"></P
><P
><B
>Figure 4. Load Average Properties Dialog</B
></P
></DIV
><P
>      The changes you can make to the properties are four:
    </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Colours</DT
><DD
><P
>         You can alter the colours used for the applet's display
         clicking on the colour boxes. This invokes the GNOME colour wheel.
         The titles are a little misleading. "Used" is the current load 
         average, and "free" is the background colour.
        </P
></DD
><DT
>Speed</DT
><DD
><P
>          You can alter the speed that the graph proceeds with this.
          It is measured in milliseconds. The default is 500.
        </P
></DD
><DT
>Size</DT
><DD
><P
>          You can alter the size of the applet with this. It is measured
          in pixels. The default value is 40, and the range is from 1 pixel
          to whatever you like. In a vertical panel, this refers to the
          height. In a horizontal panel, it refers to the width. 
        </P
></DD
><DT
>Maximum</DT
><DD
><P
>          This is the maximum number in the Y axis (the possible
          maximum load average which the applet will show). The default
          is 10.
        </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>           This option is only available from the <B
CLASS="GUIMENUITEM"
>Default
           Properties menu option</B
>. It does not appear on
           the dialogue box which is started by the
           <B
CLASS="GUIMENUITEM"
>Properties menu option</B
>.
         </P
></TD
></TR
></TABLE
></DIV
></DD
></DL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOADAVG-BUGS"
>Known Bugs and Limitations</A
></H2
><P
>      Resizing and then altering the panel orientation can still cause
      intermittent problems, although they now fix themselves after a
      short period.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LOADAVG-AUTHORS"
>Authors</A
></H2
><P
>      This applet was writen by Martin Baulig (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:martin@home-of-linux.org"
>martin@home-of-linux.org</A
>&#62;</TT
>).
      Please send all comments, suggestions, and bug 
      reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
      bug tracking database</A
>. (Instructions for submitting bug
      reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>      on-line</A
>. If you are using
      GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
      Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
      <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
      Menu</B
>, for submitting bug reports.
    </P
><P
> 
      This manual was written by Telsa Gwynne
      (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:telsa@linuxchix.org"
>telsa@linuxchix.org</A
>&#62;</TT
>) and Eric Baudais 
      (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:baudais@okstate.edu"
>baudais@okstate.edu</A
>&#62;</TT
>). Please send all comments and
      suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
      by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
      submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
      Table</A
>.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>