110 lines
3.5 KiB
Plaintext
110 lines
3.5 KiB
Plaintext
Hints for WMIFS
|
|
|
|
Generic
|
|
--------------------------------------------------------------
|
|
WMiFS supports commandline options, 'wmifs -h' prints help
|
|
about them.
|
|
|
|
WMiFS has a special -i option, this way you can force
|
|
WMiFS to monitor a particular interface like:
|
|
|
|
wmifs -i eth0 &
|
|
wmifs -i ppp0 &
|
|
wmifs -i lo &
|
|
|
|
Without the -i option (wmifs &) WMiFS automagicly
|
|
grabs the default interface and will display the
|
|
name and statistics of that interface.
|
|
|
|
You can cycle in realtime through all available
|
|
active interfaces by simply clicking with the left
|
|
mousebutton on the interface name gadget in the
|
|
upperleft corner of WMiFS...
|
|
|
|
Note: The 'lo' interface is an exception, 'lo' ONLY
|
|
works when invoked from the commandline (wmifs -i lo),
|
|
lo was mainly build in for testing purposes ;-)
|
|
|
|
|
|
WindowMaker
|
|
--------------------------------------------------------------
|
|
WindowMaker users simply drag and drop the WMiFS dock.app on
|
|
the WindowMaker Dock (preferred) or the Clip.
|
|
|
|
Now press the rightmouse button on WMiFS's outer edges and
|
|
select "Settings..." from the popup menu that appears.
|
|
|
|
Enable the 'Start when WindowMaker is started' option, then
|
|
click on the 'OK' button in the Docked Applications Panel.
|
|
|
|
|
|
Afterstep
|
|
--------------------------------------------------------------
|
|
Afterstep users put the following in their .steprc
|
|
"Wharf wmifs - MaxSwallow "wmifs" wmifs -i eth0 -w &".
|
|
|
|
Note: the small pixmap placement bug is in Wharf, please
|
|
notify the AfterStep developers if you want to see
|
|
this fixed!
|
|
|
|
|
|
Other WindowManagers
|
|
--------------------------------------------------------------
|
|
For other windowmanagers, WMiFS runs nicely as 64x64 pixel
|
|
shaped icon on your desktop.
|
|
|
|
p.s. FVWM can swallow it too, so we've heard ;-)
|
|
|
|
|
|
Dragging WMiFS
|
|
--------------------------------------------------------------
|
|
Be sure to drag WMIFS on it's outer edges, it's a bit
|
|
picky due to the large gfx pixmap it keeps ;-)
|
|
|
|
|
|
Setting up the WMiFS RC file
|
|
--------------------------------------------------------------
|
|
WMIFS can (optionally) launch your ppp scripts with a simple
|
|
left mouse click on the interface statistics display.
|
|
|
|
You may define your settings in ~/.wmifsrc like:
|
|
|
|
left: /home/foobar/MyPPP-connect-script
|
|
middle: /home/foobar/MyPPP-disconnect-script
|
|
right: /home/foobar/MyPPP-reconnect-script
|
|
|
|
Note: If you run a site where users may not fiddle with the
|
|
PPP scripts, read INSTALL > Info For Site Admins!
|
|
|
|
|
|
Creating PPP dialup scripts
|
|
--------------------------------------------------------------
|
|
Because a very good PPP HowTo already exists,
|
|
it's quite pointless for us to explain to you
|
|
how you should and can make them...
|
|
|
|
Read the PPP HowTo, and you'll see that it's
|
|
very easy to create your own PPP scripts ;-)
|
|
|
|
|
|
Permissions to allow non-root WMPPP connections
|
|
--------------------------------------------------------------
|
|
WMiFS will connect just fine when run as root, but if you want
|
|
to run WMiFS as a non-root user, there are a few files and
|
|
programs to make permissions changes to.
|
|
|
|
WMiFS needs access to the device file your modem is on, so if
|
|
you use COM1, then the modem device file you use is /dev/cua0.
|
|
Change the permissions so that it is world read/writable:
|
|
|
|
chmod 666 /dev/cua0
|
|
|
|
The pppd daemon also makes calls to the kernel which require root
|
|
permissions. The pppd daemon must be owned by root, and then have
|
|
it's set-user-id bit turned on. This way, the pppd daemon will
|
|
always run as SUID root. Change the owner and SUID bit like:
|
|
|
|
chown root.root pppd
|
|
chmod +s pppd
|
|
|