xppp v1.0
Robert S. Mallozzi
<mallozzir@cspar.uah.edu>
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.
|
