------------------------------------------------------------------------------
Title:   README.1ST FILE FOR PPPLC RELEASE MARKER_PATCHLEVEL
Version: $Header: /home/ahuxley/dev/supported/ppplc/doc/RCS/README.1ST,v 1.3 1999/01/07 13:03:21 alexis Exp $
------------------------------------------------------------------------------

Description
-----------
This is release MARKER_PATCHLEVEL of the PPPLC package - a set of tools for 
making connecting to the internet via PPP a little easier. It includes

	ppplcd: (ppp link control daemon)  

		This daemon contructs chat scripts, calls pppd with the
		correct parameters, starts news and mail transfer and calls
	        other miscellaneous scripts as per config files

	sndmsg: (lightweight IPC message dispatcher)

		This program simply puts instructional messages onto a
		IPC message queue which are then read off by ppplcd.
		These messages tell ppplcd to do various things, like
		hanging up the phone, connecting, etc.

	getmsg: (lightweight IPC message receiver)

		This program simply waits for a message on a IPC message
		queue. It reads the same queue as ppplcd, but each program
		only reads messages intented for itself. It is intended to
                complement sndmsg's role within wrapper scripts.

	ppplcc:	(menu driven wrapper for sndmsg)

		This is a simple shell script that displays a menu of
		actions and then invokes sndmsg with the correct parameters
		which then instructs ppplcd to take the specified action.
		
	ip-up, ip-down: (replacement ip-up and ip-down programs)

		These are effectively copied to /etc/ppp. All they do is
		invoke 'sndmsg' to inform ppplcd that they have been called.

	other scripts (to perform news and mail transfers, check link
		quality, adjust name lookup services, etc)

		These scripts perform various small occassional jobs. See
		the example config file for more information on what these
		do and their interfaces.

Copyright Policy
----------------
This package is (C) Alexis Huxley 1996-1998. It is distributed under the
terms of the GNU Public License, the conditions of which can be found
in the file ./doc/COPYING.

Installation
------------
For installation instructions see ./doc/INSTALL.

Configuration
-------------
For use and configuration instructions see the accompanying manual pages.

Latest version
--------------
The latest version is at http://www.danae.demon.co.uk/software/ppplc/.

Bugs etc
--------
Bugs, fixes, enhancements, suggestions for further development, etc
should be sent to ppplc-support@danae.demon.co.uk. Email to the author
directly is unlikely to get through.