gpppwrap - a graphical gtk user interface to run the ppp-on/off scripts

gpppwrap provides a easy to use interface to ppp-on/off scripts for people
that like still to use the flexibility and power of these shell scripts.
gpppwrap is mainly useful when your ISP maintains a number of modem
pools with different phone numbers or you want to use different ISPs at
different times.  gpppwrap gives you a GUI to select one ISP and then
execute the /etc/ppp/scripts/ppp-on script with this ISP name as argument.

You need gtk, gdk and glib libraries + header files to compile gpppwrap.
You you should have these things if you are using e.g gnome or gimp.

There is also a cgi script for your webserver which allows non Linux
users to dial out to a specific ISP using their web-browser.
This is very useful in networks where you use IP-masquerading.

The provided sample configurations are working example with valid
passwords for different ISPs in Germany. These ISPs offer "internet by call".
A service where you do not register you just pay via your phone bill.
----------------------------------------------------------------------------- 
INSTALLATION:

To compile run:
 make
To install gpppwrap and the man-page run:
 make install
Create a link in /dev:
 e.g cd /dev; ln -s ttyS0 modem

To install the sample scripts from etc/...: Adapt (edit) these scripts 
your needs (e.g modem speed in the peers files)
and then run:
 make install_scripts
Note: you might want to back up your existing /etc/ppp directory 
      before that

If you have static addresses in /etc/resolv.conf then transfer
them to the first "case statement" in /etc/ppp/scripts/ppp-on.
/etc/resolv.conf get's modified everytime you dial out.

The cgi-bin/pppcontrol must be installed manually as follows:
 -Copy pppcontrol to the cgi-bin directory of your web-server
 -Edit the script and change the variable $url from 
  http://10.0.0.1/cgi-bin/pppcontrol to what ever is the url pointing to
  the script. 
  I recommend to use IP addresses instead of domain names if you have 
  windows clients in your local network and no local DNS server or
  your not using dnsrd.

----------------------------------------------------------------------------- 
gpppwrap is easy and simple: reads /etc/ppp/gpppwrap.conf to get
the list of available ISPs. When you press ppp-on then
it will run the /etc/ppp/scripts/ppp-on with the name of the ISP
as defined in /etc/ppp/gpppwrap.conf.

The ppp-on/ppp-off scripts that come as examples with gpppwrap 
are perl Set-UID root (chmod 6755) scripts. This means you do not have
to be logged in a root to dial out to your Internet Service Provider.

The sample configuration files are designed to for dynamic DNS assignment.
The file /etc/resolv.conf is re-written every time you dial out.
----------------------------------------------------------------------------- 

Change log:
-----------
1999-01-17: gpppwrap-0.1: first version
1999-02-07: gpppwrap-0.2: Added spec file for RPM, Makefile bug fix
1999-03-19: gpppwrap-0.3: Bug fix for RH 4.2 and gtk-1.0.4
1999-11-01: gpppwrap-0.4: Use gtk_signal_connect instead of 
            gtk_signal_connect_object for the popup text.
2000-07-26: gpppwrap-0.5: remove state check, allow also chracters as 
            phone number
2000-10-30: gpppwrap-0.6: cgi-bin/pppcontrol added and ready to use ISPs for
            germany
2000-11-05: gpppwrap-0.7: reading of data in /etc/ppp/gpppwrap.conf discarded
            a colon.
2001-01-05: gpppwrap-0.8: -/etc/ppp/gpppwrap.conf keyword changed to ppponarg
                          -all provided scripts are now working examples
                          -ppp-on script is just a generic wrapper
                           configuration is now done in the peers scripts
                          -use dnrd as dns proxy for ip-masquerading networks.
2001-01-08: gpppwrap-0.9: -make wrapper SUID not the programs
2001-01-09: gpppwrap-1.0: -update docu
                          -fix ENV-fault in cgi-bin
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Author: Guido Socher (guido@linuxfocus.org)
gpppwrap's home-page: http://www.oche.de/~bearix/g/
Copyright: GPL