Hints for WMND

Generic
--------------------------------------------------------------
WMND supports commandline options, 'wmnd -h' prints help
about them.

WMND has a special -i option, this way you can force
WMND to monitor a particular interface like:

wmnd -i eth0 &
wmnd -i ppp0 &
wmnd -i lo &

Without the -i option (wmnd &) WMND 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 WMND...

Note: The 'lo' interface is an exception, 'lo' ONLY
works when invoked from the commandline (wmnd -i lo),
lo was mainly built in for testing purposes ;-)


WindowMaker
--------------------------------------------------------------
WindowMaker users simply drag and drop the WMND dock.app on
the WindowMaker Dock (preferred) or on the Fiend, and then 
press the rightmouse button on the outer edges of WMND and
then enable 'Autolaunch' from the Dock popup menu.


Afterstep
--------------------------------------------------------------
Afterstep users put the following in their .steprc
"Wharf wmnd - MaxSwallow "wmnd" wmnd -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, WMND runs nicely as 64x64 pixel
shaped icon on your desktop.

p.s. FVWM can swallow it too, so we've heard ;-)


Dragging WMND 
--------------------------------------------------------------
Be sure to drag WMND on it's outer edges, it's a bit 
picky due to the large gfx pixmap it keeps ;-). You can also
use a mouse+keyboard shortcut in your window manager to drag
it around.


Setting up the WMND RC file
--------------------------------------------------------------
WMND can (optionally) launch your scripts with a simple
mouse click on the rate-meter of interface statistics display. 

You may define your settings in ~/.wmndrc 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! 

Obviously the PPP script needs to be runnable by the user
running wmnd.
      
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
--------------------------------------------------------------
WMND will connect just fine when run as root, but if you want
to run WMND as a non-root user, there are a few files and 
programs to make permissions changes to.

WMND 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
