96 lines
3 KiB
Text
96 lines
3 KiB
Text
Installation instructions for WMiFS.
|
|
|
|
|
|
NOTE!
|
|
--------------------------------------------------------------
|
|
Installing this program requires root privileges, ask your
|
|
local system/network administrator kindly if she/he wants
|
|
to install this software for you ;-)
|
|
|
|
|
|
Requirements
|
|
----------------------------------------------------------
|
|
- root access
|
|
|
|
To be able to complete the installation you'll need
|
|
to make changes in the system's /etc directory,
|
|
the installation copies the GLOBAL config file
|
|
there, don't worry, nothing will be overwritten ;-)
|
|
|
|
Make sure libdockapp (at least version 0.7.0) is installed. It
|
|
may be obtained at
|
|
http://windowmaker.org/dockapps/?name=libdockapp
|
|
|
|
Installation
|
|
--------------------------------------------------------------
|
|
1) % make
|
|
2) % su root
|
|
3) # make install
|
|
4)* # vi ~/.wmifsrc and/or /etc/wmifsrc
|
|
set up the paths to your pppd
|
|
start, stop & restart scripts
|
|
5) % wmifs & (or wmifs -h for brief help).
|
|
|
|
4)* This is optional, WMiFS 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, WMiFS now supports an
|
|
/etc/wmifsrc.fixed file.
|
|
|
|
The installation will install the normal user and global
|
|
wmifsrc files in $HOME and /etc, NOT the fixed one!
|
|
|
|
WMiFS scan for 3 files at startup, in the following order:
|
|
|
|
1. /etc/wmifsrc
|
|
2. $HOME/.wmifsrc
|
|
3. /etc/wmifsrc.fixed
|
|
|
|
If no .wmifsrc file is found in the users home directory,
|
|
WMiFS will use the global one (/etc/wmifsrc, if present
|
|
and valid).
|
|
|
|
When WMiFS finds a /etc/wmifs.fixed file, all settings
|
|
that WMiFS detected in /etc/wmifsrc and/or $HOME/.wmifsrc
|
|
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/wmifsrc to /etc/wmifsrc.fixed :)
|
|
|
|
Note: When NO wmifsrc files are found at all, WMiFS will
|
|
work, but quite obvious, WMiFS won't launch any scripts.
|
|
Make sure there are valid and FULL pathnames in the wmifsrc
|
|
file(s) if you want WMiFS to launch your pppd scripts ;-)
|
|
|
|
|
|
Usage
|
|
-------------------------------------------------------------
|
|
WMiFS support the following commandline options:
|
|
|
|
-h helpscreen
|
|
-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 wmifs 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 WMiFS.
|
|
|