**********************************************************************
*                                                                    *
*               Motif-PPP for Linux, Version 1.03 Beta               *
*          Copyright (C) 1997 Seiji Eto, All Rights Reserved.        *
*                                                                    *
********************************************************************** 

						Written by Seiji Eto
						seto@Slip.Net
						7-5-97

0. Introduction

	Motif-PPP is an X-based dial-up ppp connection setup utility
program that is capable of automatically configuring and triggering for
the ppp daemon to be executed. Inspite of configuring ppp connection
manually, which causes some people a trouble, this utility allows users
to avoid such troublesome and to configure the settings automatically.

1. Compile Motif-PPP

	Motif-PPP is written with the OSF/Motif 2.0 toolkit, therefore,
you need to have it installed and usable in your system.
	Modify the Makefile to make suitable to your environment and
issue the command, make. A bunch of warning messages may appear during
the compilation. If it bothers you, gcc's -w option will help. You
will get a binary executable file called, Motif-PPP.

2. Compile your Kernel with ppp Support

	If you do not have the ppp compiled in your kernel, you must
compile your kernel with ppp support. You can check for kernel
support with:

    % dmesg|grep -i ppp

which gives the following message:

    PPP: version 0.2.7 (4 channels) NEW_TTY_DRIVERS OPTIMIZE_FLAGS
    PPP line discipline registered.

	If you do not get a message like the above, check the following
site to get information of how to compile your kernel and follow the
direction to compile your kernel:

    http://sunsite.unc.edu/mdw/HOWTO/Kernel-HOWTO.html

3. Installing ppp Daemon

	Prior to the execution of Motif-PPP, you must have the ppp
daemon installed in your system. You can get the latest ppp package
on the following site and read the README or/and related documents in
the package for installation details:

    ftp.funet.fi:/pub/Linux/BETA/ppp/ppp-2.x.x

4. Backing Up Existing Files

	This program will creates (overwrites) the following files
before the ppp daemon executes. Therefore, if there already exits
those files, you should back them up. And if those files exist in a
different format that the program normally creates, the program reads
parameters differently. So, you should delete those files after you
back them up, or clear the wrongly-entered parameters in entry boxes.
The files are:

	/etc/ppp/options
	/etc/ppp/chat
	/etc/resolv.conf

5. Setup and Execution

	From command line, type the following command to run Motif-PPP:

    % Motif-PPP

	The pixmap file, phone3.xpm, must be in the directory:
             /usr/include/X11/pixmaps
	In order to run the ppp daemon, the following parameters must
be specified. In other words, you have to input an appropriate infor-
mation in every single text box on the main panel and the configuration
dialog. However, you may leave blank for the nameserver input box if
there exists something in its list box. The parameters are:

   Phone Number:   Phone number for the ppp server you want to connect
		   to. (e.g. 1-800-555-1212)
   Login Name:     Your login name.
   Password:       Your password for the account.
   Speed:	   Modem speed.
   Device:	   The device port to which modem is connected.
   pppd directory: The directory where pppd resides. (e.g. /usr/sbin)
   Domain Name:    The domain name of your system. (e.g. foo.foo.com)
   Nameserver:	   Nameserver's IP address. (e.g. 127.0.0.1)

	After you specify those items, press the connect button. The ppp
daemon should be running if you setup correctly.

6. Script File for pppd Termination

	A script file named ppp-off is needed for the ppp daemon
termination in the directory where pppd resides. Usually this file
comes with ppp package. In case you do not have one, make it as follows:

#!/bin/sh

DEVICE=ppp0

#
# If the ppp0 pid file is present then the program is running. Stop it.
if [ -r /var/run/$DEVICE.pid ]; then
        kill -INT `cat /var/run/$DEVICE.pid`
#
# If unsuccessful, ensure that the pid file is removed.
#
        if [ ! "$?" = "0" ]; then
                echo "removing stale $DEVICE pid file."
                rm -f /var/run/$DEVICE.pid
                exit 1
        fi
#
# Success. Terminate with proper status.
#
        echo "$DEVICE link terminated"
        exit 0
fi
#
# The link is not active
#
echo "$DEVICE link is not active"
exit 1

7. phone.xpm for Motif Iconification

	A pixmap file, phone.xpm, is provided for Motif iconification.
The following statement should be included in the .Xdefaults file or
other resource file:

   Mwm*Motif-PPP*iconImage: DIRECTORY/phone.xpm

8. Useful Documents

    /usr/doc/faq/howto/PPP-HOWTO.gz
    /usr/src/ppp-2.2/README.linux
    % man pppd
    http://sunsite.unc.edu/mdw/HOWTO/PPP-HOWTO.html

9. Acknowledgments

    Special thanks to:

    * Jerry Hall @ Adobe Systems Inc. for giving me some idea to
      write Motif-PPP and consulting me how to connect to a ppp
      server using pppd.
    * Dan Sween @ Adobe Systems Inc. for providing a beautiful
      network environment.

10. Bug Report

	For bug report, write to: seto@Slip.Net.
