<HTML
><HEAD
><TITLE
>Modem Lights 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"
>Modem Lights Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>John Fleck</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#MODEMLIGHTS"
>Modem Lights Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="MODEMLIGHTS"
>Modem Lights Applet</A
></H1
><P
> <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
>, shown in <A
HREF="index.html#MODEMLIGHTS-FIG1"
>Figure 1</A
>, monitors your modem while it is
  working. To add this applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>,
  right-click on the panel
  and choose
         <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Network</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Modem Lights</B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG1"
></A
><P
><IMG
SRC="modemlights.png"></P
><P
><B
>Figure 1. Modem Lights Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MODEMLIGHTS-USAGE"
>Usage</A
></H2
><P
>This applet can be used to tell if your modem is working,
    and to track its behavior and performance. It can also be
    configured to call a separate script or program to have your modem
    connect and disconnect when you click on the <B
CLASS="GUIBUTTON"
>button
    with the single green light</B
>.
    </P
><P
>Right-clicking on the applet brings up a menu containing the
    following items:
<P
></P
><UL
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Properties</B
>&#8212; brings up
	    <A
HREF="index.html#MODEMLIGHTS-PREFS"
>                <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
>
            </A
> dialog
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212; brings up this
            document. 
	    </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>About</B
> &#8212; shows basic
            information about the <TT
CLASS="APPLICATION"
>Modem Lights
            Applet</TT
>, including the applet's version and
            author's name.
         </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MODEMLIGHTS-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> by
      right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Modem Lights Settings</SPAN
> dialog (shown in <A
HREF="index.html#MODEMLIGHTS-FIG2"
>Figure 2</A
>, which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG2"
></A
><P
><IMG
SRC="modemlights-prefs.png"></P
><P
><B
>Figure 2. Preferences dialog</B
></P
></DIV
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show connect time and
    throughput</B
></TT
> &#8212; have <TT
CLASS="APPLICATION"
>Modem
    Lights Applet's</TT
> graphic display expand to include
    two small text boxes showing the current data transfer rate (top)
    and connect time (bottom).</P
><P
><TT
CLASS="GUILABEL"
><B
>Connect command:</B
></TT
> and
        <TT
CLASS="GUILABEL"
><B
>Disconnect command: </B
></TT
> &#8212;  To use
    <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> to initiate a
    connection, place the name of the startup command in the
    <TT
CLASS="GUILABEL"
><B
>Connect command</B
></TT
> text box, and the disconnect
    command in the box beneath it labeled <TT
CLASS="GUILABEL"
><B
>Disconnect
    command</B
></TT
>. When you click on the single button on the
    applet, it will connect or disconnect your modem.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Confirm connection</B
></TT
> &#8212;
        Display a dialog box confirming your connection.</P
></LI
><LI
><P
>        <TT
CLASS="GUILABEL"
><B
>Updates per second</B
></TT
> &#8212; Set the update
        rate of <TT
CLASS="APPLICATION"
>Modem Lights
        Applet's</TT
> display.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Show connect time and
        throughput</B
></TT
> &#8212; add two text windows to the
        applet showing the time you have been connected at the data
        transfer rate. This is a good way to monitor your modem's
        performance.</P
></LI
></UL
>

    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="MODEMLIGHTS-FIG3"
></A
><P
><IMG
SRC="modemlights-advpref.png"></P
><P
><B
>Figure 3. Advanced preferences dialog</B
></P
></DIV
><P
><TT
CLASS="APPLICATION"
>Modem Lights Applet's</TT
>
    <SPAN
CLASS="INTERFACE"
>Advanced preferences window</SPAN
> allows you to
    control advanced features of the applet.</P
><P
>     The properties are:
     <P
></P
><UL
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Modem lock file:</B
></TT
> &#8212;
    specifies the file created by the computer when the modem is
    working, allowing other programs to know it is in
    operation. <TT
CLASS="FILENAME"
>/var/lock/LCK..modem</TT
>, the default
    setting, is the most common, if your computer uses a symbolic link
    from <TT
CLASS="FILENAME"
>/dev/modem</TT
> to the actual modem
    device. Check with your system administrator to see if a different
    device name and therefore lock file is in use. <TT
CLASS="APPLICATION"
>Modem
    Lights Applet</TT
> needs this information to find and
    monitor your modem.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Verify owner of lock file</B
></TT
>
        &#8212;  verify that the lockfile really belongs to the
        currently running PPP daemon and is not left over from an
        older one. This is checked by default and shouldn't be changed.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Device</B
></TT
> &#8212; Device, typically
    <TT
CLASS="FILENAME"
>ppp0</TT
> on a Linux machine, is the name of the
    network interface being used by the modem. If
    <TT
CLASS="FILENAME"
>ppp0</TT
> is not correct for your machine, check
    your system documentation for the correct designation.</P
><P
>Other possible network interface names commonly used include
    <TT
CLASS="FILENAME"
>ippp0</TT
> for Linux ISDN;
    <TT
CLASS="FILENAME"
>isp0</TT
> for NetBSD ISDN and
    <TT
CLASS="FILENAME"
>ipdptp0</TT
> for Solaris PPP.</P
></LI
><LI
><P
><TT
CLASS="GUILABEL"
><B
>Use ISDN</B
></TT
> &#8212; If you use
    an ISDN modem, check the <TT
CLASS="GUILABEL"
><B
>Use ISDN</B
></TT
>
    checkbox. <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> will then
    ignore all the settings above related to standard modems.</P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
><P
> After you made all the choices you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to make the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click on
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="MODEMLIGHTS-BUGS"
>Known bugs and limitations</A
></H2
><P
>    The <TT
CLASS="GUILABEL"
><B
>Verify lock file</B
></TT
> check box on the
    advanced preferences window should always be left true. It is
    likely to be removed from future versions of <TT
CLASS="APPLICATION"
>Modem
    Lights Applet.</TT
>
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Modem Lights Applet</TT
> was written by 
    John Ellis (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:johne@bellatlantic.net"
>johne@bellatlantic.net</A
>&#62;</TT
>) and 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 John Fleck
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:jfleck@inkstain.net"
>jfleck@inkstain.net</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
>