File	Date	Author	Commit
LICENSE	2013-09-04	Julio Gonzalez Gil	[1991c9] Initial commit
README	2013-09-06	Julio Gonzalez Gil	[f37ea6] Fixed typo on README file
config.cfg.sample	2013-09-04	Julio Gonzalez Gil	[1991c9] Initial commit
dsl-watchdog	2013-09-04	Julio Gonzalez Gil	[1991c9] Initial commit
restartrouterdsl	2013-09-04	Julio Gonzalez Gil	[1991c9] Initial commit

Read Me

INTRODUCTIONS
=============

dsl-watchdog is a set of scripts to check if there's faulty connectivity to
internet on home networks using DSL routers and restart the connection or
router if needed

The user can use a config file to specify which hosts he wishes to ping and
how much package loss is allowed. If the loss is greater than the configured
value or 100%, the dsl-watchdog script will call the expect script
"restartrouterdsl".

At this moment the "restartrouterdsl" script is able to interact with two
router models.

INSTALL
=======

To use the dsl-watchdog , you need to install expect (http://expect.nist.gov)

Now just copy config.cfg.sample to config.cfg, replace the 
values and install a cron job to call dsl-watchdog (no parameters needed)

SECURITY
========

WARNING: dsl-watchdog will run the instructions on config.cfg. Also the
router credentials will be stored there and everbody able to run the
script will be able to restart the connection or the router.

Therefore, be sure to restrict execute, read and write permissions. 

It's suggested to chmod the run:

chmod 700 dsl-watchdog
chmod go-rwx dsl-watchdog/*

And it's strongly recommended to run this script with an
unprivileged user.