xppp v1.0 Robert S. Mallozzi <email@example.com> http://cspar.uah.edu/~mallozzir/ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * USAGE xppp INTRODUCTION This program is a Motif widget interface to your IP connection. Although it is called xppp, the program will work with any type of protocol connection. The actual connection is made in the shell script ppp-start, which you will have to write for your particular system and IP connection, since there is no standard for IP connection procedures. As a result, it's a fair amount of work to get this program to work. You can start from the scripts I provided, they might even work! I hacked these scripts from the impressive work of Damjan Lango <Damjan.Lango@snet.fer.uni-lj.si> http://ana.fer.uni-lj.si/~langod to make them work with xppp. I have a static IP address; the scripts work in my case, but will need modification for your connection. At the very least, you will have to change the IP account login name. I know very little about dynamic IP, since I have not yet had to use one ;-) Please do not mail me about this, as I will not be able to help. xppp assumes that you must provide a password for your account, and will popup a dialog box to obtain the password during the connection procedure. You can make a list of different phone numbers to which to connect, and then choose from them during the connection procedure. You can also add a list of hosts to ping from a popup menu. See INSTALLATION below for more information. E-mail me any comments, criticisms, bugs, etc. INSTALLATION o You must have the Motif library installed. o Unpack the distribution. o There are three shell scripts and two data files that you must provide for the program: 1. ppp-start This shell script dials your modem and logs you in to your IP account. The script takes two parameters that are passed to it by xppp: the phone number to dial ($1), and the user account password ($2). 2. ppp-stop This shell script hangs up the modem. No parameters. 3. ppp-ping This shell script pings a host. The script takes a single parameter: the IP address of the host to ping. 4. ppp-phone-list ASCII text file that contains names and phone numbers to dial. Format is one name and number per line, separated by white space. The names are used only for display in the widget. 5. ppp-ping-list ASCII text file that contains names and IP addresses of hosts to ping. Format is one name and address per line, separated by white space. The names are used only for display in the widget. o Edit xppp.h to specify the location of your shell scripts. There are also some other parameters there that you can change. o Edit the Makefile if your compiler can't find the libraries -lXm -lXpm -lXext -lXt -lX11 Compile and link: $make o If all goes well, you can remove the object files: $ make clean o Install the app-defaults file (mine are in /usr/X11R6/lib/X11/app-defaults): $ cp ./Xppp.ad /usr/X11R6/lib/X11/app-defaults/Xppp Also, make sure your shell scripts and data files are in the directories you specified in xppp.h o Finally, copy the binary xppp to wherever you keep your executables (mine are in /usr/local/bin), or better yet, put the xppp source wherever you put your programs, e.g. /usr/local/src/xppp, and do $ ln -s /usr/local/src/xppp/xppp /usr/local/bin/xppp LEGAL STUFF Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the author's name and this notice appear in all copies and in supporting documentation. The author's name shall not be otherwise used publicity pertaining to distribution of the software without specific, written prior permission. THE SOFTWARE IS PROVIDED TO YOU "AS-IS", AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO YOU OR ANYONE ELSE FOR ANY DIRECT, SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER, INCLUDING WITHOUT LIMITATION, LOSS OF PROFIT, LOSS OF USE, SAVINGS OR REVENUE, OR THE CLAIMS OF THIRD PARTIES, WHETHER OR NOT THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE POSSESSION, USE OR PERFORMANCE OF THIS SOFTWARE. This software is in no way affiliated with the University of Alabama, or NASA and the US government.