				Xdialppp README

Xdialppp is an X application that lets you configurate and manage your
ppp connection.

It has been tested on Linux 2.0.33 & Linux 2.0.0 .

--------------------------------------------------------------------------------

0.NOTE - Changes since 0.4.2 :

   The only change in this version (0.4.4) is the addition of a script that
   allows managing connections with multiple ISP's. Please read the script
	'connect'
   and MANAGING MULTIPLE CONNECTIONS(5) for details.

--------------------------------------------------------------------------------

1.FUNCTIONALITY:

   The program is divided in 2 parts.

		1.xdialppp connect : This is the window from where you connect
				to your ISP.

		2.xdialppp configurator : Here you enter all your data about the
				connection, i.e.: phone #, username, password,
				and some other options.

   The first time you run the program, you will have to configurate it, pressing
   the CONFIGURATE button. (see NOTE below)
   Once you have entered all your data, you can press the OK button in the
   configuration form. This saves two connection scripts, and two configuration
   files, which are later used to perform the connection by xdialppp.
   When you have generated the scripts, and are back in the first window, you
   are able to connect pressing the CONNECT button.
   If you get a connection made, you can disconnect via the DISCONNECT button.
   The console log will be telling you what is happening.

   These are the files that xdialppp generates:

			xppprc

			<connectionname>.xppprc

			<connectionname>.ppp-init (to make the connection)
	and
			<connectionname>.ppp-dial (used by the first, to dial)

   Where <connectionname> is a name for your connection.
   All the files listed above are located in /usr/local/lib/xdialppp

   ---------------------------------
   NOTE (data needed to configurate):

   Some data is filled in by default. For example, I assume that your ISP asks
   your username with the prompt 'Username:' (don't include the ' symbols).
   If your ISP issue you any other prompt, you can change it (let's say 'Login:'
   or any prompt in your languaje : 'Nombre:' ,'Name:' , etc.) in the input
   field labeled 'Prompt1'.
   Also, I assume that your ISP prompts 'Password:', if you need, you can change
   it to whatever your ISP issue you to ask your password in the input field
   labeled 'Prompt2'.

   You have to enter your username , and password (in invisible mode & twice for
   security).

   If your ISP requires that you put any other command after identifying, you
   can enter the secuence of prompt (issued by your ISP) and answer in the
   extra commands boxes.
   My ISP prompts me someting like `server1>` , and I have to issue a 'ppp'
   command.
   In this case (or similar) you should enter '>' in the input field labeled
   'Prompt3' and 'ppp' in the Answer3 input field. Of course these inputs
   mustn't be filled in by everybody, only by who need it.

   If you have to dial any # to get outside tone, or anything like this, you
   have to enter this with your phone # in the phone input field (in any way
   that can be understood by an AT -dial- command).
   For example, if you have to dial a 9 to get outside tone, and your ISP # is
   061034346, you should enter : 9,061034346

   Pressing the IP ADDRESSES button you can configurate some IP stuff.
   I have assumed that your ISP assigns you a dynamic IP address, therefore
   the local & remote IP inputs have a default value of '0.0.0.0' (that means
   dynamic IP assignament).
   I also assume that your netmask will be '255.255.255.0', but you can change
   any of the above values if you need to.
   The light button labeled 'No IP default' sets dynamic IP assignament, the
   'Default route' one means that your ISP's address will be added in the
   routing table as default gateway. I assume you will like these settings.
   The pre & post connection options are not implemented still. If you need
   them, just e-mail me.

   By pressing the CONNECTION button, you can set some modem options, like which
   is your modem (/dev/modem, /dev/cua1, /dev/ttyS2, etc), the connection speed,
   tone or pulse dialing, speaker volume, use or not hardware flow control, and
   two options that I do not understand very well, and should not be changed :
   ASYNCMAP, and ESCAPE.

   OK, at this stage, you should have everyting ready to generate the scripts.
   Press OK in the main configuration form, and you will be asked for the name
   of the connection, and the name of a configuration file. You can name them
   however you want, but please keep the .xppprc extension for the config file
   and save it in the default directory ( /usr/local/lib/xdialppp ).

   We are approaching to the end. Back in the first form, press the CONNECT
   button, and watch the connection log. Some messages will appear, and you'll
   get a 'Serial connection established' when ready.

--------------------------------------------------------------------------------

2.DISTRIBUTION:

   -You can get the source code and compile it. See COMPILING(3) for more info.

   -You can get the binaries, and install them. See INSTALLING(4) for more info.

   In both cases you will need xforms library (0.88 or greater).

--------------------------------------------------------------------------------

3.COMPILING:

   This is the list of source files you should have:

		xppp.c
		xppp.h
		xppp_cb.c
		xppp_init.c
		xppp_init.h
		xppp_main.c
		mytokens.h
		mytokens.c
		Makefile

   plus xforms library:

		libforms.so.0.88	(shared)
   or
		libforms.a		(static)

   the header for xforms:

		forms.h

   a directory containing pixmaps:

		./pix/*.xpm

   a connection script to manage multiple ISP's:

		connect

   and these files:

		README			(you are rading it now)
		LICENSE			(GNU General Public License)
		CHANGES			(changes from first release)
		ppp-off			(used to disconnect)
		xdialppp.8		(manual page)

   If you don't have xforms library, you can get it at: 

		http://bragg.phys.uwm.edu/xforms
	or
		via ftp in any mirror.

	In this case, follow the instructions supplied with the library to
	compile and/or install it (and jump to Second step).

   STEPS:
	-First: Once you have all the files, you should install the library and
		the header file, typing:

			make install.xforms

	 	You can edit it to change directory settings, etc.
		(if you have obtained xforms from other place, please follow the
		instructions supplied with the library)

	-Second: Edit the Makefile to fit your settings if needed(not necessary
		in most cases).

	-Third: type:
			make

	-Fourth: type
			make install
			make install.man

	-That's all folks.

--------------------------------------------------------------------------------

4.INSTALLING:

	(installing the binaries)

   These are the files you should have:

		xdialppp
		Makefile

   plus the library:

		libforms.so.0.88	(shared)
	or
		libforms.a		(static)

   a directory containing pixmaps:

		./pix/*.xpm

   a connection script to manage multiple ISP's:

		connect

   and these files:

		README			(you are rading it now)
		LICENSE			(GNU General Public License)
		CHANGES			(changes from first release)
		ppp-off			(used to disconnect)
		xdialppp.8		(manual page)


   Note:
   If you don't have xforms library, you can get it at: 

		http://bragg.phys.uwm.edu/xforms
	or
		via ftp in any mirror.

	In this case, follow the instructions supplied with the library to
	compile and/or install it (and jump to Second step).

   STEPS:
	-First: type:
		make install.xforms

	-Second: type:
		make install
		make install.man

	-That's all!

--------------------------------------------------------------------------------

5.MANAGING MULTIPLE CONNECTIONS

   The file 'connect' is a script written by Andy Wallace in order to manage
   multiple ISP's. The script can be edited through and some variables can
   be changed acording to your system.
   Andy Wallace can be contacted via e-mail for further information.
	Andy Wallace: awallace@isintegration.co.uk

--------------------------------------------------------------------------------

6.COPYRIGHT - DISCLAIMER :

   Programmed by Diego Rodrigo.
   Xdialppp home page : http://www.geocities.com/MotorCity/5501/xdialppp.html

   Built with Xforms library & Form Designer.
   If you need information about xforms, visit http://bragg.phys.uwm.edu/xforms

   Copyright (C) 1998 Diego Rodrigo.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


   If you make any change to the code, please e-mail me, so I can put it in
   new versions.


--------------------------------------------------------------------------------

7.TODO:

   -These two features aren't still operative:
	Pre & Post connection commands

		They should be used to issue any command before & after
		 connecting.
		They will function in a later version.

   -Improve my english (sorry).

--------------------------------------------------------------------------------

8.THANKS TO:

   -Daniel Gandara & Raul Jorja for teaching me the firsts concepts about the 
	Linux world.

   -Marcelo Salinas for his help with ppp scripts.

   -All the people at Linux Users Group Argentina  ->  http://www.linux.org.ar

   -Andy Wallace for writing the multiple ISP connection script.


   Don't hesitate to give me any suggestion or comment.

	Diego Rodrigo
	d.rodrigo@computer.org

	Marcelo T. de Alvear 255 - 9 B
	Cordoba (CBA) - 5000
	ARGENTINA

	http://members.xoom.com/drodrigo/xdialppp.html

	Optional e-mail : d.rodrigo@iname.com

--------------------------------------------------------------------------------
			      MADE IN ARGENTINA
--------------------------------------------------------------------------------
