Installation instructions for WMND. 


NOTE!
--------------------------------------------------------------
Installing this program requires root privileges, ask your 
local system/network administrator kindly if she/he wants
to install this software for you ;-)

You can also install the program in your very own bin
directory. You'll have to figure that one out yourself, though,
make install won't do it for you.


Reccomendations
----------------------------------------------------------
- root access

	To be able to complete the installation you'll need
	to make changes in the system's /etc directory,
	as the installation copies the GLOBAL config file
	there. Don't worry, nothing will be overwritten ;-)
	This config file isn't required, but it's nice to have.


Installation
--------------------------------------------------------------
1)  % tar -zxvf wmnd_0.0.1.tar.gz
2)  % cd wmnd
3)  % make 
4)  % su root
5)  # make install
6)* # vi ~/.wmndrc and/or /etc/wmndrc
	set up the paths to your pppd
	start, stop & restart scripts
7)  % wmnd & (or wmnd -h for brief help).

6)* This is optional, WMND also works fine without them,
    it's entirely up to you ;-)


    
Extra Install Info For Site Administrators!
--------------------------------------------------------------
For site administrators who don't want their users messing
up pppd's configuration files, WMND now supports an 
/etc/wmndrc.fixed file. 

The installation will install the normal user and global 
wmndrc files in $HOME and /etc, NOT the fixed one!

WMND scan for 3 files at startup, in the following order:

	1. /etc/wmndrc
	2. $HOME/.wmndrc
	3. /etc/wmndrc.fixed
	
If no .wmndrc file is found in the users home directory,
WMND will use the global one (/etc/wmndrc, if present 
and valid).

When WMND finds a /etc/wmnd.fixed file, all settings
that WMND detected in /etc/wmndrc and/or $HOME/.wmndrc
will be discarted i.e. OVERRIDDEN! 

If you want your users to be able to dialout, but you 
don't want them to mess around, simply move or copy
the default /etc/wmndrc to /etc/wmndrc.fixed :)

Note: When NO wmndrc files are found at all, WMND will
work, but quite obvious, WMND won't launch any scripts.
Make sure there are valid and FULL pathnames in the wmndrc
file(s) if you want WMND to launch your pppd scripts ;-)


Usage
-------------------------------------------------------------
WMND support the following commandline options:

        -h              Help screen
	-b              Scale value by bitwise, read the version
			section 0.1.0 of file CHANGELOGS for detail.
        -display        X server display where wmppp should
                        appear (default = 0:0)
	-i		Interface name, note: 'lo' can ONLY
			be specified with '-i lo' ;-)
			(default = default interface as it
			 appears in /proc/net/route) 
	-w		Draw the statistics graph in waveform
			like mode, try it! (default = normal)
        -v              Print wmnd version number


General Notes
--------------------------------------------------------------
Note 1: If "make install" fails on your system, please edit
        the Makefile to set the paths according to your setup.
        "make install" defaults to /usr/local/bin, $HOME & /etc.

Note 2: Please DO read the HINTS, this file contains some
        very usefull tips about WMND. 

