scripts/README

   1 This directory contains a set of scripts which have been used on Linux
   2 systems to initiate or maintain a connection with PPP.  The files in
   3 this directory were contributed by Al Longyear (longyear@netcom.com).
   4
   5 ------------------------------------------------------------------------
   6
   7 1. README
   8
   9 This file. You are reading it. It is just documentation.
  10
  11 ------------------------------------------------------------------------
  12
  13 2. ppp-on
  14
  15 This script will initiate a connection to the PPP system. It will run
  16 the chat program with the connection script as a parameter. This is a
  17 possible security hole. However, it is simple. It is meant to replace
  18 the previous version of ppp-on which was not very functional.
  19
  20 The ppp-on script has entries for the account name, password, IP
  21 addresses, and telephone numbers. The parameters are passed to the
  22 pppd process and, then in turn, to the second part of the connect
  23 script, as a set of environment variables.
  24
  25 Please make sure that you put the full path name to the ppp-on-dialer
  26 script in the reference to it in ppp-on.
  27
  28 ------------------------------------------------------------------------
  29
  30 3. ppp-on-dialer
  31
  32 This is the second part to the simple calling script, ppp-on.  It
  33 executes the chat program to connect the user with a standard UNIX
  34 style getty/login connection sequence.
  35
  36 ------------------------------------------------------------------------
  37
  38 4. callback
  39
  40 This script may be used in lieu of the ppp-on-dialer to permit the
  41 common modem callback sequence. You may need to make changes to the
  42 expected prompt string for the modem.
  43
  44 The script works by disabling the system's detection of the DCD
  45 condition and working on the modem status message "NO CARRIER" which
  46 is generated when the modem disconnects.
  47
  48 It is crude. It does work for my modem connection. Use as you see fit.
  49
  50 ------------------------------------------------------------------------
  51
  52 5. redialer
  53
  54 The redialer script is a replacement for the ppp-on-dialer script.  It
  55 will do 'attack dialing' or 'demon dialing' of one or more telephone
  56 numbers. The first number which responds will be used for a
  57 connection.
  58
  59 There is a limit of ten attempts and a 15 second delay between dialing
  60 attempts. Both values are set in the script.
  61
  62 ------------------------------------------------------------------------
  63
  64 6. ppp-off
  65
  66 This is a script which will terminate the active ppp connection. Use
  67 as either "ppp-off" to terminate ppp0, or "ppp-off <device>" to
  68 terminate the connection on <device>. For example, "ppp-off ppp2" will
  69 terminate the ppp2 connection.
  70
  71 ------------------------------------------------------------------------
  72
  73 7. secure-card
  74
  75 This script was written by Jim Isaacson <jcisaac@crl.com>. It is a script
  76 for the 'expect' programming language used with Tcl. You need to have
  77 expect and Tcl installed before this script may be used.
  78
  79 This script will operate with a device marketed under the name "SecureCARD".
  80 This little device is mated with its controller. On the credit card size
  81 device, there is a sequence number which changes on a random basis. In order
  82 for you to connect you need to enter a fixed portion of your account name
  83 and the number which is displayed on this card device. The number must match
  84 the value at the controller in order for the account name to be used.
  85
  86 The problem is that chat uses fixed response strings. In addition, the
  87 timing for running the script may prevent the use of a script that reads the
  88 value before it starts the dial sequence. What was needed was a script which
  89 asked the user at the user's console at the time that it is needed.
  90
  91 This led to the use of expect.