wmppp.app/INSTALL

   1 Installation instructions for WMPPP.
   2
   3
   4 NOTE!
   5 --------------------------------------------------------------
   6 Installing this program requires root privileges, ask your
   7 local system/network administrator kindly if she/he wants
   8 to install this software for you ;-)
   9
  10
  11 Requirements
  12 ----------------------------------------------------------
  13 - root access
  14
  15         To be able to complete the installation you'll need
  16         to make changes in the system's /etc/ directory,
  17         the installation copies the GLOBAL config files
  18         there, don't worry, nothing will be overwritten ;-)
  19
  20
  21 Installation
  22 --------------------------------------------------------------
  23 1) % tar -zxvf wmppp-1.x.x-tar.gz
  24 2) % cd wmppp.app/
  25 3) % make all
  26 4) % su root
  27 5) # make install
  28 6) # vi ~/.wmppprc
  29          set up the paths to your ppp start,
  30          stop & restart scripts
  31
  32 7) % wmppp & (try 'wmppp -h &' for help)
  33
  34
  35 Extra Install Info For Site Administrators!
  36 --------------------------------------------------------------
  37 For site administrators who don't want their users messing
  38 up pppd's configuration files, but do want them to be able
  39 to make a dialup connection, a sample system.rc file is
  40 included (system.wmppprc), please take a look at it!
  41
  42 The installation will install standard rc files in $HOME
  43 and /etc/ WITHOUT the 'force' option!
  44
  45 How it works:
  46
  47 WMPPP first scans /etc/ if there is a wmppprc present.
  48
  49 If true, it will scan if the keyword 'force' is trailing
  50 a command, for example 'forceleft' instead of 'left'.
  51
  52 If the keywords 'force' are indeed trailing the 'normal'
  53 commands, all user .wmppprc files will be ignored i.e.
  54 OVERRIDDEN ;-)
  55
  56 If the 'force' keyword is not found in /etc/wmppprc,
  57 WMPPP will scan the users home directory to see if
  58 there is a valid .wmppprc available.
  59
  60 When a valid ~/.wmppprc is found, and no 'force' keyword
  61 is present in /etc/wmppprc, WMPPP will use the users
  62 .wmppprc file instead.
  63
  64 If no wmppprc file is found in the users home directory,
  65 WMPPP will use the global one (/etc/wmppprc).
  66
  67 If NO wmppprc files are found at all, WMPPP will work,
  68 but quite obvious, WMPPP won't launch your scripts.
  69
  70 Make sure there are valid and FULL pathnames in wmppprc
  71 if you want WMPPP to launch your pppd scripts ;-)
  72
  73
  74 General Notes
  75 --------------------------------------------------------------
  76 Note 1: If "make install" fails on your system, please edit
  77         the Makefile to set the paths according to your setup.
  78         Make install defaults to /usr/local/bin & /etc/ppp/.
  79
  80 Note 2: Please DO read the HINTS, this file contains some
  81         very usefull tips and hints about WMPPP.
  82