wmifs/HINTS

   1 Hints for WMIFS
   2
   3 Generic
   4 --------------------------------------------------------------
   5 WMiFS supports commandline options, 'wmifs -h' prints help
   6 about them.
   7
   8 WMiFS has a special -i option, this way you can force
   9 WMiFS to monitor a particular interface like:
  10
  11 wmifs -i eth0 &
  12 wmifs -i ppp0 &
  13 wmifs -i lo &
  14
  15 Without the -i option (wmifs &) WMiFS automagicly
  16 grabs the default interface and will display the
  17 name and statistics of that interface.
  18
  19 You can cycle in realtime through all available
  20 active interfaces by simply clicking with the left
  21 mousebutton on the interface name gadget in the
  22 upperleft corner of WMiFS...
  23
  24 Note: The 'lo' interface is an exception, 'lo' ONLY
  25 works when invoked from the commandline (wmifs -i lo),
  26 lo was mainly build in for testing purposes ;-)
  27
  28
  29 WindowMaker
  30 --------------------------------------------------------------
  31 WindowMaker users simply drag and drop the WMiFS dock.app on
  32 the WindowMaker Dock (preferred) or the Clip.
  33
  34 Now press the rightmouse button on WMiFS's outer edges and
  35 select "Settings..." from the popup menu that appears.
  36
  37 Enable the 'Start when WindowMaker is started' option, then
  38 click on the 'OK' button in the Docked Applications Panel.
  39
  40
  41 Afterstep
  42 --------------------------------------------------------------
  43 Afterstep users put the following in their .steprc
  44 "Wharf wmifs - MaxSwallow "wmifs" wmifs -i eth0 -w &".
  45
  46 Note: the small pixmap placement bug is in Wharf, please
  47       notify the AfterStep developers if you want to see
  48       this fixed!
  49
  50
  51 Other WindowManagers
  52 --------------------------------------------------------------
  53 For other windowmanagers, WMiFS runs nicely as 64x64 pixel
  54 shaped icon on your desktop.
  55
  56 p.s. FVWM can swallow it too, so we've heard ;-)
  57
  58
  59 Dragging WMiFS
  60 --------------------------------------------------------------
  61 Be sure to drag WMIFS on it's outer edges, it's a bit
  62 picky due to the large gfx pixmap it keeps ;-)
  63
  64
  65 Setting up the WMiFS RC file
  66 --------------------------------------------------------------
  67 WMIFS can (optionally) launch your ppp scripts with a simple
  68 left mouse click on the interface statistics display.
  69
  70 You may define your settings in ~/.wmifsrc like:
  71
  72 left: /home/foobar/MyPPP-connect-script
  73 middle: /home/foobar/MyPPP-disconnect-script
  74 right: /home/foobar/MyPPP-reconnect-script
  75
  76 Note: If you run a site where users may not fiddle with the
  77       PPP scripts, read INSTALL > Info For Site Admins!
  78
  79
  80 Creating PPP dialup scripts
  81 --------------------------------------------------------------
  82 Because a very good PPP HowTo already exists,
  83 it's quite pointless for us to explain to you
  84 how you should and can make them...
  85
  86 Read the PPP HowTo, and you'll see that it's
  87 very easy to create your own PPP scripts ;-)
  88
  89
  90 Permissions to allow non-root WMPPP connections
  91 --------------------------------------------------------------
  92 WMiFS will connect just fine when run as root, but if you want
  93 to run WMiFS as a non-root user, there are a few files and
  94 programs to make permissions changes to.
  95
  96 WMiFS needs access to the device file your modem is on, so if
  97 you use COM1, then the modem device file you use is /dev/cua0.
  98 Change the permissions so that it is world read/writable:
  99
 100         chmod 666 /dev/cua0
 101
 102 The pppd daemon also makes calls to the kernel which require root
 103 permissions. The pppd daemon must be owned by root, and then have
 104 it's set-user-id bit turned on. This way, the pppd daemon will
 105 always run as SUID root. Change the owner and SUID bit like:
 106
 107         chown root.root pppd
 108         chmod +s pppd
 109