README: 08/29/94 IMPORTANT NOTE: On line 537 of disktool.c change from: exit(); to: exit(0); This change did not get into the distributed source code. Sorry for any inconvenience. ====================================================================== This has proved to be quite an experience for me with all the feedback I have received from all over the world! Keep it up! Disktool has evolved from a simple program for my own use, to a very important tool for many sysadmins out there on the InfoBan. I have been driven by user requests and about 75% of this release is due to them. Notes ===== 08/29/94 Version 2.0 - What's New ================================== o Can now add filesystem on the fly On the Properties pop-up window, the Filesystem item is now an editable field where a new filesystem can be typed in and the threshold and units can be adjusted before pressing the "Add Filesystem" button. o Can now remove filesystem on the fly A delete button has been added to the Properties pop-up window to remove the current selected filesystem from the disktool main gauge window. o Allow action after x number of polls Previous to this release, disktool would only signal a critical condition once for each filesystem and would only reset if the filesystem re-gained available disk space and went above critical. Now through the cmdline option, "-r", or the properties pop-up window, a value can be specified as to how often a signal will be sent. A value of "0" is the default and specifies the old method of only one signal when the filesystem first goes critical. Any other positive integer value specifies the number of polls before the signal is repeated. This will happen indefinately until the filesystem rises above the critical condition. o Force a filesystem poll with middle mouse button click o Added deltas If "-d" cmdline option is specified, disktool will continually display a delta since the last poll. The color will reflect whether there was a gain or a loss. By default, green for gain and red for loss. o Added keyboard accelerators +,- Respectively, increase & decrease the polling interval by 10 seconds with each keypress. = Display polling interval in the left footer for 1 second before returning to the timestamp display. h,v Respectively, change to horizontal or vertical layout. p Force an immediate filesystem poll. q,x Quit disktool. o Added -cmd cmdline option Can now specify the command to be executed when a filesystem being monitored goes critical from the disktool command line. o Added KB parsing of cmdline args Any threshold value containing a 'K' will be understood to be KB's, anything else will default to MB's. o Now checks for more than MAX_GAUGES filesystems Now will not crash if more then MAX_GAUGES filesystems are specified. o Now has a Min. width No longer truncates the timestamp in the footer if only one filesystem is specified with a short name (ie. /) in horizontal layout. o Added -used cmdline option Reverses the function of the gauge displays to show disk space used instead of the default, disk space avail. ------------------------------- The MIN and MAX polling intervals can be adjusted by changing the values of MIN_POLL_INT and MAX_POLL_INT, respectively, in common.h The "OK" and "Critical" colors can be adjusted by changing the value of OKCOLOR and CRITCOL, respectively, in common.h Autocalc of spacing takes place if the spacing value is below 50(pixels). This can be adjusted by changing the value of MINSPACING in common.h Description =========== `disktool' is an XView program to monitor up to 64 filesystems simultaneously and alert you when a particular filesystem is low on space. disktool is set-up to "un-iconify" when a filesystem it is monitoring has reached its' user-definable "critical threshold". A unix command can also be initiated when this threshold is reached. The command and un-iconifying can be repeated every so many polls, configurable from the cmdline or from the Properties pop-up. The properties pop-up is obtained by selecting any gauge with the right mouse button. The middle mouse button has also been mapped to force a filesystem poll to update the displayed data. `disktool' is a good sysadmin tool for monitoring diskfull situations to avoid datafile corruption. This program is Copyright(c)1993,1994 Shaun Finn sfinn@astro.ge.com but please feel free to e-mail me any suggestions for improvements or bugs. Compilation =========== A makefile has been supplied that works under SunOS 4.1.3, Solaris 2.x, and HP-UX(I hope) using the XView3.x libraries. There are some configurable options, well marked, at the top of the Makefile for OS configuration. A copy has also been supplied (Makefile.orig) in case you modify the original and you haven't got a clue where you started (I've done this). Installation ============ Move `disktool' to where you normally keep your binaries and move disktool.man to where you normally keep your man pages.