PPPKit v0.7 By atomik
---------------------
This is a easy to use program written in perl to generate chat scripts for
making a PPP Connection to the internet.


To Install:
Type ./Install

Detailed Installation
----------------------
Dialup Number     : The number you use to dial up to your ISP.
Login Name        : Your user name.
Password          : Your password. (And yes it IS normal that you don't
                    see yourself typing it, I set it -echo.)
Domain            : Your ISP's domain. (Example: "aol.com")
Device            : Similar to com ports in DOS, you must specify which
                    `com` port your modem is on. There is more information
                    on this topic in the setup.
Connection Speed  : The Maximum connect speed. You should put this one as
	            115200 even if you are on a 28.8
Local IP          : Your Local IP, if your dynamic put 0.0.0.0 in.
Remote IP         : Your Remote IP, if your dynamic put 0.0.0.0 in.
NETMASK           : Your netmask, Probably 255.255.255.0.
Accessing a NS?   : Do you have any DNS numbers you would like to put in?
Primary DNS       : Put in your primary nameserver.
Secondary NS?     : Do you have a secondary nameserver?
Secondary DNS     : Put in your secondary nameserver.

* you can get your nameservers (and other info) by calling your ISP.

Connecting, disconnecting, etc:
-------------------------------
Connect         : type "ppp-on" to connect.
Disconnect      : type "ppp-off" to disconnect.
Connection info : type "ppp-info" to find out some stuff about your
                  connection.


Common Installation problems:
-----------------------------
1) Windows/PNP modems.

Many times if this script won't dial it's because of the modem you
are using.  These days there are a LOT of modems that are made for 
Windows.  If you have a "WinModem" you are out of luck, those will
not work with linux.  But if you have a plug and play modem, you are in
luck because you can get a program called "isapnptools" which will make 
it work.  

You can get isapnptools from:

http://sunsite.unc.edu/pub/Linux/system/hardware/isapnptools-1.11.bin.tgz


2) Perl isn't where it is suppose to be (or isn't even installed.)

If you get the error:

./Install: Command not found.

First make certain you are in the right directory, and that you are
spelling "Install" correctly (note the capital I).  If you are sure, then 
first type "locate perl" (or "whereis perl") and if it turns up something 
like "perl: /usr/local/bin/perl5.00403 /usr/local/bin/perl" you have to
change the path of the main executable (/usr/local/bin/perl) in the first 
line of the program "Install". The first line looks like "#!/usr/bin/perl-w"
And saying that the locate (or whereis) said the perl binary was in 
/usr/local/bin, you would make it say "#!/usr/local/bin/perl -w". If
whereis or locate do not turn up any results, then you must download perl. 
However, most new linux distributions come with perl, so this shouldn't 
be a problem.

You can get the latest version of perl from:

http://www.perl.com/CPAN/src/latest.tar.gz

Or you can get the perl RPM from:

ftp://ftp.redhat.com/pub/redhat/redhat-5.0/i386/RedHat/RPMS/perl-5.004-1.i386.rpm


Files this program makes.
-------------------------
/usr/sbin/ppp-on    :  This starts up the dialer, and has contains
                       information such as your login, password, etc.  
                       If you need to quickly edit something, like to
                       change your password...then this is the file to 
		       edit.  If there is a previous /usr/sbin/ppp-on, 
                       it will be backed up, and will be put back to 
                       normal if you run the 'Uninstall' program.
  
/usr/sbin/pppdialer :  The main dialer. You probably won't have to edit
                       this unless you want to change your modem strings,
                       etc.

/etc/resolv.conf    :  This is where information about your nameservers,
                       and domain is kept. If you want to add another 
                       nameserver to the list just add a line that says
                       "nameserver <yournameserver>" without the quotes.
                       This file is also backed up. 

/usr/sbin/ppp-off   :  This is the disconnect script.

/usr/sbin/ppp-info  :  Gives you info about your connection. (Remote &
                       Local IP, which device ppp is on.)

/etc/ppp/ip-up      :  After you connect, this file is executed.  Add
                       everything that you want to do right after you
                       connect to this file, but don't take out the lines
                       that are already in it...those lines generate the
                       'stats' file that is used by ppp-info. This file is
                       also backed up.

/etc/ppp/ip-down    :  When you disconnect, this file is executed. Don't
                       delete the line that is already in there, that gets
                       rid of the stale 'stats' file. This file is also
                       backed up.

/etc/ppp/options    :  The options file.  Just contains the word "lock".
                       This file is also backed up.

If you have any other problems, questions, comments, or bugs feel free to
e-mail me at atomik@undertow.csh.rit.edu.

