==================================================================
EzPPP 1.0 Beta 9
Home Page: http://www.serv.net/~cameron/ezppp/index.html
Primary FTP: ftp.a42.com /pub/jay
Author: Jay Painter
E-mail: jay@a42.com
==================================================================
This program is released under the GNU >= 2.0 licensing agreement.

-----
WARNING: The .ezppprc file from BETA9 and above is --NOT-- compatible with the 
.ezppprc file from any previous version.  Delete it before running EzPPP.
-----

FILES
-------------------------------------------------------------------------------
ezppp/README                     -- this file
ezppp/LICENSE                    -- the licencing agreement for EzPPP (GNU)
ezppp/icon                       -- directory containing the ezppp icon
ezppp/doc                        -- docs for EzPPP, right now just the 
                                    web pages
ezppp/src                        -- source files
ezppp/makefiles                  -- makefiles to compile the EzPPP application
                                    IF you have the Qt toolkit installed.
ezppp/bin                        -- pre-compiled binaries of EzPPP
ezppp/lib                        -- the Qt 1.2 shared liberary, pre-comiled in
                                    i386-ELF format
ezppp/util                       -- misc stuff that's useful to me, maybe to
                                    you too
-------------------------------------------------------------------------------

This is a fully functional BETA release.  I'm sure it has bugs, so please
submit bug reports with enough information so that I can re-create the 
crash.

EzPPP is a X-based PPP connection configuration utility which handles
multiple accounts.  It is similar to the Macintosh's FreePPP, only better:)

EzPPP is writen in C++ using the Qt GUI toolkit.  Info on the Qt tookit can
be found at http://www.troll.no.  If you wish to compile the source, you must
have the Qt toolkit correctly installed.

I've included the source, a Intel-ELF compiled Qt shared library, libqt.so.1.2,
and the ELF-compiled EzPPP application.

Better documentation is avaible in the ./doc directory: howto.html.  I suggest
reading it and not using the "QUICK INSTALL" below!

=== QUICK INSTALL ===
The libqt liberary is in the lib/ directory.  The bin/ directory contains
pre-compiled versions of EzPPP for Intel-ELF-Linux machines.  There is a
staicly linked version, and a dynamicly linked version.  *NOTE*: If you are
a beginner to Linux, it's best to use the static version.
BEGINNERS:
	To use the staticly linked EzPPP:

		cd ezppp/bin/i386-ELF-static
		cp ezppp /usr/X11R6/bin

	Now, become root so you can give yourself permissions to some files
	EzPPP has to modify to work correctly.  As root:

		cd /etc
		chmod 666 resolv.conf
		cd /dev
		chmod 666 /dev/cuaX   (where x={0,1,2,3})

	Finally, you have to make sure you know where the REAL pppd daemon is.
	On Slackware96, /usr/sbin/pppd is actually a script which executes
	pppd-2.1 if you are running kernel <= version 1.2.x, or pppd-2.2 if you
	are running kernel >= version 2.0.x.  If you are running Slackware96, 
	and kernel 2.0.x, then the pppd daemon (full path) is 
	/usr/sbin/pppd-2.2  .  Make sure you have execute permission to this. 
	If you are unsure if the pppd file is a script of a executeable, use the
	command 'file pppd', it will tell you if it's a script or a
	ELF-executeable.

		cd /usr/sbin
		chown root.root pppd-2.2
		chmod 555 pppd-2.2
		chmod +s pppd-2.2
		
	The second line, chmod +s, will make pppd-2.2 set it's user ID to root
	upon execution.  This is useful if you want to use ppp as a non-root
	user.  You may want to do the same chmod's on ezppp if you are having
	problems accessing /dev/modem.

	You are now ready to start EzPPP, of course you need to be running
	X-windows first:)  The first thing you want to do is make sure EzPPP
	knows where the real pppd daemon is located.  Click on the "Expand"
	arrow button in the lower right hand corner to reveal the editing
	section, then click the "General" Tab.  You can change the pppd path
	now.  Next, click on the "Modem" tab and make sure your modem settings
	are ok, you can change the initalizeation string sent to the modem by
	the "Edit Modem Commands" button.  After you've worked that out, click
	the "Accounts" tab  and hit the "New" button to create a new account.
	You will have to enter a account name, and a phone number.  Most ISP's
	have dynamic IP addresses, so you'll be able to ignore dealing with
 	the "IP" tab.  You will have to enter a DNS address,
	which will be prvided by you ISP, if you don't have it, call up your
	ISP customer service and get it.  They may give you one or two, enter
	all of them into the DNS list.  Now you have to create your script.
	I've written a script.html (in ezppp/doc) to help out with that.  I'm
	working on better docs, but this is all I have for now.


----------

PORTERS???  I would like to have a final release which incudes binaries from
other Linux supported architectures.  Please contact me if you have a non-Intel
Linux system and are interested in porting.

When you run EzPPP, it will create a .ezppprc file in your home directory.
This file is binary.  You can't edit it.

Questions, comments, and suggestions welcome.  Please include the string
"EzPPP" in the subject heading when mailing me to help me sort my mail.

-------------------------------------------------------------------------------
Jay Painter
jay@a42.com
