  "I swear by my life and my love of it that I will never live
   for the sake of another man, nor ask another man to live for
   mine."

                    John Galt in "Atlas Shrugged", by Ayn Rand


AUTHOR

  The author is ilsundal@alfheim.net.  This package is freeware,
  and I'm open to any form of input you may have.  PPP-in-a-box was a long
  awaited release, I was simply tired of people asking me for my PPP
  scripts, so here they are world.

AVAILABILITY

  PPP-in-a-box is available at these fine locations:

    ftp://ftp.skyfire.net/pub/linux/ppp/ppp-in-a-box-1.01.tar.gz
    http://www.alfheim.net/ppp/ppp-in-a-box-1.01.tar.gz

PLATFORMS

  PPP-in-a-box has only been tested on linux slackware releases 3.0 - 3.4,
  but I am assuming that it will work on others as well.  If any
  modifications need to be made for PPP-in-a-box to be supported for other
  platforms, feel free to email me with them via ilsundal@alfheim.net. ;)

INSTALLATION

  Installation is rather simple, simply untar the contents of the archive
  ppp-in-a-box-1.01.tar.gz in a directory as root, and run install.

  alfheim:~# tar xvfz ppp-in-a-box-1.01.tar.gz
  alfheim:~# cd ppp-in-a-box-1.01/
  alfheim:~/ppp-in-a-box-1.01# ./installme

  The following describes the contents of the archive, and what each file
  does.

  README       - primarily for decorative purposes.
  chap-secrets - for use if your peer authenticates with CHAP
                 [Cryptographic Handshake  Authentication  Protocol]
  connect      - connection script, this is the file you'll execute for
                 connection.
  installme    - PPP-in-a-box installation script.
  options      - pppd options file, add additional pppd flags.
  pap-secrets  - most popular way for authentication, edit this file with
		 your user information, important!
  ppp          - edit this script, and fill in the appropriate varibles,
                 this is extermely important, or this will not work.
  ppp.down     - script to terminate your PPP connection.
  ppp.minicom  - script that works hand-in-hand with everyone's favorite
                 linux terminal program, minicom.
  uninstallme  - the name says it all .. ;)
 
NORMAL USE

  The installation script places everything you need to go both on, and 
  off-line in the /usr/local/sbin directory.

  To initiate a PPP connection, simply type "ppp-up", and to terminate your
  PPP connection, simple type "ppp-down".

MINICOM USE

  If for some very odd reason your provider does not support PAP, or CHAP
  authorization, you may resort to using minicom to establish your PPP
  connection.  Simply dialup your provider's  number using minicom,
  login with your username/password, afterwards your provider should have
  assigned you an IP address. Enter in sequence ALT-A, Q to leave minicom
  without resetting your modem (this will keep your connection alive when
  exiting), and execute the ppp.minicom script in /etc/ppp.  

FINAL NOTE

  For your own protection, make sure the permissions on
  /etc/ppp/pap-secrets, /etc/ppp/chap-secrets are readable only by root,
  you wouldn't want a user on your machine to know your passwords now
  would you? :) 

  Also, this ppp package will automatically reconnect to your provider if
  for any reason your PPP connection is severed, you must invoke the
  ppp-down command to stop it. ;)

GREETS

  greets go out to kurdt, efpee, caller, doommaker, twisted, the blade nation, 
  kidice, pyramid, antihero, dendybar, cerkit, and especially rattle who 
  suggested two 'cleaner' solutions to the script. ;)

  may the elves of alfheim prevail!@~
