This program has the simple function of restarting a sana2 device when the
offline status is achieved.  This works extremly well with the version 1.44
release of ppp.device.  This program does not re
quire that a ping is used so that no CPU useage is consumed except when a
OFFLINE event occurs.

If a provider of internet services hangs up on your connection (trust me its
happens!), with this running, you will immediately re-connect with your
provider.  With the registered version of ppp.devi
ce (1.44 or higher), it will automatically perform its dialup script upon
receiving a ONLINE command.  

For ease configuring, this program looks for two scripts.  If you have any
actions that you need to perform if the device goes OFFLINE (hangs up), stick
them in the file:

         "AmiTCP:db/ReStarter-Offline"

If you have any actions needed to perform once the device is returned back to a
ONLINE state, stick them in a file called:
            
         "Amitcp:db/ReStarter-Online"

The above two scripts are OPTIONAL.  If they are not present, the program simply
performs a ONLINE and continues.

The program has three optional startup parameters which can be used to override
its built in defaults.  They are:

    1: Device name  - defaults to "DEVS:Networks/ppp.device"
    2: Unit number  - defaults to unit 0
    3: Logfilename  - defaults to "Amitcp:Dialerlog"

The logfile is only written to if an error occurs (like an offline event) and
when the unit is returned to an ONLINE status.  This log can be useful to
provide to a provider who has a flakey connecti
on. (Like why did YOUR system hang up on me the following 500 times???)

---------------------------------------------------------------

To install:  Sorry, no nifty scripts!  Simply copy it somewhere in your path
(like Amitcp:bin for example).  Create the above scripts if you need them.

---------------------------------------------------------------

To execute:  It should be run as a background task.  I didn't make it
self-detaching so you will have to execute it via:

        run >NIL: ReStarter

Ideally, the above line should be added to your User-StartNet script (from
AmiTCP) so that this program is run AFTER you inital dialin occurs.

Since the program is NOT self-detaching, you can easily stop it from running by
sending it a break command from shell.  It looks for any (and ALL) breaks.  For
those who don't know how to do this, si
mply look up the process number via the "status all" command.  Using that
process number, enter:
        
         "BREAK process # ALL"

(Replace the # symbol with the process number)

---------------------------------------------------------------
Bugs:  

If you actually wish to shutdown your connection, it is first necessary to stop
this program from running (or it will promptly redial!)  This really isn't a
bug, but a FEATURE! 

If more then one version of this critter is running, it will promptly exit and
not continue to run.  This prevents multiple copies from filling your memory up!
(Thus to upgrade a running version, you
 must stop it first)
---------------------------------------------------------------

Legal Stuff

This software is considered giftware.  If you find it useful, I will accept any
contributions you wish to donate! Money of course is always welcome!

I can be reached at:

    David L. Evans
    620 S. 15th Ave.
    Caldwell, ID 83605
    
    EMAIL:  devansccubb.com


Shamless plug:  You can also telnet to my bbs if you wish! We are running on a
Amiga 4000 and have been in continuous operation since 1982.  We started life
out on a Pet model 4016 of all things!

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  594    1233  48.2% -lh5- 9c57 Mar  9  1996 ReStarter.info
[generic]                10690   16932  63.1% -lh5- abe6 Mar  9  1996 restarter/ReStarter
[generic]                 1786    3874  46.1% -lh5- a36b Mar  9  1996 restarter/ReStarter.Readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         3 files   13070   22039  59.3%            Mar 16  1996