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 on the Fiend, and then
  33 press the rightmouse button on the outer edges of WMiFS and
  34 then enable 'Autolaunch' from the Dock/Fiend popup menu.
  35
  36
  37 Afterstep
  38 --------------------------------------------------------------
  39 Afterstep users put the following in their .steprc
  40 "Wharf wmifs - MaxSwallow "wmifs" wmifs -i eth0 -w &".
  41
  42 Note: the small pixmap placement bug is in Wharf, please
  43       notify the AfterStep developers if you want to see
  44       this fixed!
  45
  46
  47 Other WindowManagers
  48 --------------------------------------------------------------
  49 For other windowmanagers, WMiFS runs nicely as 64x64 pixel
  50 shaped icon on your desktop.
  51
  52 p.s. FVWM can swallow it too, so we've heard ;-)
  53
  54
  55 Dragging WMiFS
  56 --------------------------------------------------------------
  57 Be sure to drag WMIFS on it's outer edges, it's a bit
  58 picky due to the large gfx pixmap it keeps ;-)
  59
  60
  61 Setting up the WMiFS RC file
  62 --------------------------------------------------------------
  63 WMIFS can (optionally) launch your ppp scripts with a simple
  64 left mouse click on the interface statistics display.
  65
  66 You may define your settings in ~/.wmifsrc like:
  67
  68 left: /home/foobar/MyPPP-connect-script
  69 middle: /home/foobar/MyPPP-disconnect-script
  70 right: /home/foobar/MyPPP-reconnect-script
  71
  72 Note: If you run a site where users may not fiddle with the
  73       PPP scripts, read INSTALL > Info For Site Admins!
  74
  75
  76 Creating PPP dialup scripts
  77 --------------------------------------------------------------
  78 Because a very good PPP HowTo already exists,
  79 it's quite pointless for us to explain to you
  80 how you should and can make them...
  81
  82 Read the PPP HowTo, and you'll see that it's
  83 very easy to create your own PPP scripts ;-)
  84
  85
  86 Permissions to allow non-root WMPPP connections
  87 --------------------------------------------------------------
  88 WMiFS will connect just fine when run as root, but if you want
  89 to run WMiFS as a non-root user, there are a few files and
  90 programs to make permissions changes to.
  91
  92 WMiFS needs access to the device file your modem is on, so if
  93 you use COM1, then the modem device file you use is /dev/cua0.
  94 Change the permissions so that it is world read/writable:
  95
  96         chmod 666 /dev/cua0
  97
  98 The pppd daemon also makes calls to the kernel which require root
  99 permissions. The pppd daemon must be owned by root, and then have
 100 it's set-user-id bit turned on. This way, the pppd daemon will
 101 always run as SUID root. Change the owner and SUID bit like:
 102
 103         chown root.root pppd
 104         chmod +s pppd
 105