README

   1 1. What is it?
   2
   3 A plugin to indicate the status of the IBM Hard Drive Active
   4 Protection System, or HDAPS.
   5
   6 2. Requirements
   7
   8 As of Linux kernel 2.6.28, a kernel patch is no longer required to
   9 support the HDAPS functionality. As a result, this plugin will only
  10 (officially) support kernels newer than 2.6.28.
  11
  12 It will also only (officially) support the hdaps module provided
  13 by the tp_smapi project. The tp_smapi module is currently recommended
  14 by the hdaps devs, so you should be using it. In the future, the
  15 in-tree module will probably be supported as well.
  16
  17 Finally, you'll need to be running hdapsd (HDAPS daemon) if you'd like
  18 the plugin to do anything. The HDAPS daemon is what updates sysfs with
  19 the readings from the hdaps module. Get it here:
  20
  21   http://repo.or.cz/w/hdapsd.git
  22
  23 3. Installation
  24
  25 I think it builds like most XFCE panel plugins. Git users, run
  26 './autogen.sh' in the project directory, and hopefully it will do
  27 whatever it does to make your project directory look like the tarball
  28 release. If it does (or if you just downloaded the tarball), run,
  29
  30 ./configure
  31 make
  32
  33 With any luck, you will have a libhdaps.so module in your
  34 panel-plugin/.libs/ directory. There should also be an hdaps.desktop
  35 file in the panel-plugin directory.
  36
  37 You need to copy these to the directories where XFCE keeps such
  38 things. For example, the system-wide desktop file location on Gentoo
  39 is /usr/share/xfce4/panel/plugins/, and the module itself goes in
  40 /usr/lib/xfce4/panel/plugins/.
  41
  42 4. Settings
  43
  44 4a. Poll Frequency
  45
  46 This is the frequency with which the plugin checks the status of
  47 HDAPS. If you set it to 500ms (the default), it will check every half
  48 second and update the icon according to what it finds.
  49
  50 4b. Device Name
  51
  52 The name of the device whose HDAPS status you wish to monitor. This
  53 will almost certainly be a hard drive, and will most likely be "sda".
  54 With any luck, the plugin will auto-detect the supported devices on
  55 your system. If you have more than one supported device, you will
  56 need to select it on the configuration dialog.
  57
  58 5. How to report bugs
  59
  60 Email them to me at michael@orlitzky.com.