* IMPORTANT *
* If you use devfs, you can skip the device creation as this will be
  automatically done for you by the kernel *

Create /dev/sysmon

  /dev/sysmon is a misc character special device, major 10, minor 253

  csh:/dev # mknod sysmon c 10 253
  is what you should type in /dev unless you use devfs.  Incase you do use
  devfs, you shouldn't need to do anything, as /dev/misc/sysmon will be
  created automatically, and the program should be able to find the file
  in either location (/dev/sysmon or /dev/misc/sysmon) without any
  extra parameters.
---------------------------------------------------------------------

1. vi Makefile

2. If you run Blackbox or twm, you should probably uncomment the line
   -DBLACKBOX.  If you run twm, you should also uncomment -DTWM
   -DTWM is not required for use with twm, but adding that option will
   allow you to specify x,y coordinates of a completely borderless
   tcsysmon window which will come up if compiled with -DTWM enabled.
   This is useful on any window manager, if you want to make tcsysmon
   completely borderless, without any dock crap around it, so that it's
   "embedded" into the root window.  Anyway, the default of both
   commented out should be good for just about everyone.
   
2a.If you have a Pentium MMX, K6 with that 3DNow shit, or a pII(III), you
   can uncomment the MMX define, for a marginal performance boost.  You
   definitely need GCC for this, and probably a recent version of binutils.
   Obviously, if you have an Alpha box, you should probably uncomment HIGHIRQ
   and not enable MMX :)  Note, I only tested this on a K6 so if you get
   "illegal instruction" with this it means your CPU doesn't work with the
   MMX code.  Just comment it out in the Makefile and recompile.

3. If you run 2.3 or 2.4 kernels, you can specify whether to total all
   drives activity for read/write I/O, or to monitor a specific device.
   If you chose to monitor all, comment out -DIOMAJOR=3 line.  Else, decide
   which device you want to monitor (ls -l /dev/hd? or /dev/sd?), get the major
   number from ls listing, and replace 3 with it.  3 is the major for /dev/hda.
   Example:
   brw-r-----   1 root     disk       3,   0 Apr 28  1995 /dev/hda
                                      ^ this is the major.

4. If you run RedHat, chances are the compile will fail missing X11 and/or
   Xpm headers.  First you will need to make sure that development packages
   of X11, X11-libs, and Xpm are installed, and if they are, try uncommenting
   -I/usr/X11R6/include next to the REDHAT line in Makefile.  It might work.
   Do NOT email me regarding problems with RedHat installations.  I warned
   you.

5. Choose one of the "look and feel" defines, which set different display
   modes, or enable 24 IRQ support which could be useful on SMP and Alpha
   systems.  See README for complete description.  The default should be
   good enough for almost everyone.  There is also a special and weird EQ-like
   mode which some people think is good, you can try it by uncommenting the
   appropriate define, but to disable it requires a recompile.

6. Most likely at this point you made some changes, so save the Makefile,
   and exit vi.

7. make

8. You can display the commands used during "make install" process by running
   "make -n install", which will echo them, without actually executing
   anything, and you can do the same things by yourself, or you can trust
   the automatic install and run "make install" (as root).

After this, you should check out README if you haven't already, and if you
use Devfs, you should already be emailing me right at this moment.

You can arrange module.o to be loaded during system boot, then you can run
/usr/local/bin/sysmon directly, as any user.  Alternatively, you can run
the /usr/local/bin/tcsysmon script as root, which will load the module for you
and run sysmon, also as root, which could potentially be a bad idea, so it's
probably easier to have monitor.o loaded in your startup scripts.  Even though
I tried to follow safe programming practice, and most of the string operations
are used with a limit on the amount of data copied or read, there is always a
very unlikely chance that some moron will find a way to exploit something.
Quick hint:  Don't run tcsysmon as root unless you really have to.  If you
RTFM, you shouldn't need to run the dockapp itself with any special privileges.

9. (tc)sysmon &

If it doesn't crash, and if you like it, add it to your window manager startup
files (If you know how, but see the note below).

Note, however, that I will not provide support to people asking me how to make
tcsysmon work with "KDE" "Gnome" "Fvwm95" or "RedHat".  If it works, good.
If it doesn't, even better.

pretty easy.  See README for instructions... instructions?.. how to read the
lights and bars, and about some information on the programming involved.

timecop [timecop@japan.co.jp]
