$Id: README,v 1.4 1999/04/11 10:50:27 zagy Exp $

Inetdial, Copyright Christian Zagrodnick 1998 - see LICENSE
(zagy@gmx.net)


OVERVIEW:

Inetdial is a little CGI-program to dial the net (or whatever).
Quite simple coded and not very secure, but enough for my usage.

Inetdial v3.0 was completly rewritten. I think it's more usable and intuitive 
now, since there is no hangup button if you are not online. The auto hangup
feature is done via checkbox now.

If you only want certain users allow dialing, you should use the webservers
authentication methods (see .htaccess and apache doc).

The documentation is very bad, but if you set up a router/gateway you
should come along with this. Read the doc, look at the .cgi and the sample
files - i think it is posible. If you need some help, mail me, i'll answer.



CHANGES, NEWS in 3.1
- uhoh...bug in Makefile, install was not posible.
- added `Semaphores' section to the doc.


CHANGES, NEWS in 3.0 (details below)

- CGI uses perl now
- More than one interface
- Default action 
- Design changes



INSTALL:

1. Adjust the paths in Makefile.config
2. Change the vars in inetdial.cgi.
3. make
4. make install (as root)
5. look at the samples-dir, change those files in /root/bin


... think thats all

If you have some questions, mail the Author: zagy@gmx.net



SEMAPHORES:

You can change these file in inetdial.cgi if you want.
Inetdial thinks we are online, if there is a file 
called /var/run/online.$interface. Thus, if this file
exists, inetdial will print out `connection established', 
`no connection' otherwise. 

If you check the `auto-hangup' box, 
`/var/run/inet_auto.$interface' is created right before
calling `/root/bin/online $interface'. It's about your 
to handle this. See the samples/ip-up file.




DIFFERENT INTERFACES:

From v3.0 on several interfaces are suported, thus you can dial more than
one provider without changing the scripts every time.

Simply add interface/name pairs to %NAMES in inetdial.cgi.
If you want to dial ippp1 add `?interface=ippp1' to the URL
(i.e. http://vodoo.boerde.de/cgi-bin/control/inetdial.cgi?interface=ippp1)



DEFAULT ACTION:

From 3.0 on you can add ACTION=DEFAULT to the Url.
(i.e. http://vodoo.boerde.de/cgi-bin/control/inetdial.cgi?\
interface=ippp1&ACTION=DEFAULT)

If you do so, ippp1 is dialed if you are offline and hung up if you are
online. No need to click the button any more.



TODO:

- Well, I think better error handling and implementing the wrapper with exec() 
  instead of system().
- Better documentation.
- you tell me.


LATEST VERSION:

The latest version is allways available at my private homepage,
http://zagy.home.pages.de/, but I'll upload it to metalab, too.
