
What is tkppp?
--------------
tkppp is a short wish (tcl/tk) script I wrote to control a PPP
connection on my Linux box.  It presents a small window with
buttons for starting and quitting PPP, a small status message area 
and a quick-glance icon for determining the status of the PPP
link.

What is new with tkppp-1.3
--------------------------
  -  per-user .tkppprc initialization file allows much customization.
  -  auto-minimize option iconifies the window when the PPP link goes up.
  -  auto-maximize option deiconifies the window if the PPP link goes
       down inadvertently.
  -  When minimized shows status of link.
  -  auto-ping option pings periodically at a specified interval to
     keep the session from timing out.
  -  Shows dynamically-allocated IP address and (optionally) IP name.
  -  Easy configuration to add networking scripts or programs to run
       from the menubar.  Sample weathermap program included.

What is required?
-----------------
  -  the PPP package, including working ppp-on and ppp-off scripts.
  -  tcl/tk (the system was tested using tcl 7.3 and tk 3.6).

Testing
-------
  -  gunzip -c tkppp-1.3.tar.gz | tar xvf -
  -  cd tkppp-1.3
  -  edit tkppp and change the options to suit your system.
     See tkppprc for documentation on the options.
  -  try it out from inside the tkppp directory.  You may need
     to run tkppp as root IFF your own ppp-on and ppp-off scripts
     require that.

Installation
------------
  -  If you like it, you may want to move the files someplace
     more permanent.  I suggest /usr/include/X11/bitmaps for
     the bitmaps and /usr/local/bin or some such for the tkppp script.
     Be sure to edit tkppp if you move the bitmaps around.
  -  cp tkppprc ~/.tkppprc
  -  ~/.tkppprc overrides default settings in tkppp.
  -  Copy the man page somewhere.

What it does
------------
tkppp calls the ppp-on and ppp-off scripts that should be provided
with your PPP distribution.  You will need to get these working or
write your own scripts to initiate and take down the PPP connection.

Once tkppp is running, it wakes up every so often to check the status
of the PPP link.

Distribution
------------
tkppp 1.3 is copyrighted, but may be freely redistributed.

*** I am maintaining tkppp, so please pass along your comments,
bug fixes, patches, enhancements, etc. to jeschke@cs.indiana.edu
so that I can merge them into future releases of tkppp. ***

Enjoy!

Eric Jeschke
jeschke@cs.indiana.edu


Legalese
--------
I don't think there is anything in tkppp that can possibly harm your
system in any way, but nevertheless, just to cover my butt:

ERIC JESCHKE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
IN NO EVENT SHALL ERIC JESCHKE BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

