README 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. ------------------------------------------------------------------------------
  2. File Monitor plugin for GKrellM
  3. Copyright (C) 2001 Anatoly Asviyan
  4. aanatoly@linuxmail.org
  5. This program is free software which I release under the GNU General Public
  6. License. You may redistribute and/or modify this program under the terms
  7. of that license as published by the Free Software Foundation; either
  8. version 2 of the License, or (at your option) any later version.
  9. This program is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. GNU General Public License for more details.
  13. To get a copy of the GNU General Puplic License, write to the
  14. Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  15. ------------------------------------------------------------------------------
  16. This plugin monitors a file and displays its contens in gkrellm. File can have
  17. multiple rows of the form 'name : value : [flag]'. If flag non-empty then
  18. for WARNING value - the orange led will light up and for ALERT value - red.
  19. For example
  20. CPU:50.8:ALERT
  21. SBr:33.4:WARNING
  22. Fan1:4560:
  23. or
  24. Temp:31 C:
  25. Hum:49 %:
  26. Plugin can monitor multiple files and for each file, you can specify
  27. the following:
  28. Label - label of gkrellm panel
  29. File to monitor - as is :) - file to monitor. It would be checked every 5 sec
  30. Update program - the program to update a monitored file.
  31. Warning command - any shell command to run whenever warning flag is set.
  32. Alert command - any shell command to run whenever alert flag is set.
  33. I'm using it to monitor my HW state from via686a sensor chip. For this purpose
  34. I wrote sensors.tcl script that periodicaly run 'sensors' utility, processes
  35. its output and writes results to ~/.sensors in the above format.
  36. sensors.tcl has its own documentation at the beginning of file.
  37. Here is sensor's configuration
  38. label <Sensors>
  39. file <~/.sensors>
  40. Update command <sensors.tcl>
  41. Warning command <mpg123 ~/mp3/cpu2hot.mp3>
  42. Alert command <sudo shutdown -h now>
  43. INSTALL
  44. tar zxvf fmonitor-xxx.tar.gz
  45. cd fmonitor-xxx
  46. # to install fmonitor.so
  47. make
  48. make install
  49. # to install sensors.tcl
  50. 0. read documentation
  51. 1. edit it!
  52. 2. put it somewhere in your bin path
  53. 3. edit preferences of fmonitor in gkrellm configuration menu
  54. CREDITS
  55. Plugin is based on Bill Willson (bill@gkrellm.net) demo programs
  56. and on fileread plugin by Henry Palonen (h@yty.net)
  57. Modified for GKrellM 2 by Jindrich Makovicka (makovick@kmlinux.fjfi.cvut.cz).
  58. Some bugfixes by Geoff Kuenning (geoff@cs.hmc.edu)