PPP connection handling script README file
Copyright 1997 Piero Orsoni (orsoni@programmers.net)
Last modified 5/MAY/1997

--- LEGAL STUFF ---

This program comes under the GNU General Public License.
You must distribute this programs with all its files:

ppp	the program itself
README	this README file
COPYING the license (GPL)
ppp.8	the manual page

if there is no such GPL, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA

--- WHY THIS PROGRAM EXISTS ---

I wrote this program to be able to easily manage multiple ppp connection to
various internet providers. I included an easy to use interactive interface
to help people who are not familiar with linux and/or chat, pppd & C.

--- WHAT IT CAN DO ---

This program first runs the chat program to dial the remote location
telephone number, then launchs, with appropriate parameters, the pppd daemon
to start the ppp connection. Using the options in the main menu you can
create a new ppp connection, delete or edit one, connect or disconnect. I
think there is no need to explain theese very easy operations, and by the
way the question the program asks are explained along the way and sometimes
equipped with examples, that you can use as default settings. If something
is not clear to you, please write to me.

--- WHAT IT CAN'T DO ---

There is no support for the PAP protocol, so if your provider uses it you
can't use this program, unless you make some changes to it. I have not the
possibility to try a PAP connection so, for now, i have not included its
support.

--- WHAT YOU NEED TO RUN IT ---

You need to have installed in your machine:

the chat program
the pppd daemon
the dialog utility
the bash shell

those programs are present in all linux distributions, and some are
installed by default.

--- HOW TO INSTALL IT ---

Just copy the program (the file ppp) to a location in your path so you can
run it from everywhere. Then copy the manual page to the right directory:

cp ppp.8 /usr/local/man/man8 (or any other man directory that suits your own
system)

You may want/need to have a look at the first line of the code to configure
some parameters that are ok in a typical system.
You don't need to be root to use this program (unless the pppd daemon is not
owned by root and it is not setuid)

--- HOW TO RUN IT ---

Enter

ppp

to run the program in interactive mode. Enter

ppp -h

to see what command line option can be given. If you enter some command line
arguments the program will NOT start in interactive mode.

--- ---
