home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / mfsm-1.1 / README < prev    next >
Encoding:
Text File  |  1995-06-23  |  2.8 KB  |  111 lines
  1.         Motif File System Monitor V-1.1 (mfsm)
  2.     
  3. Mfsm is a X-Windows Motif utility that monitors free space and user
  4. quotas of filesystems. The program displays a drive type icon, a usage
  5. bar chart, and an alert bell toggle, which are described below:
  6.  
  7.  
  8. ** !! Where Do You Get It !! **
  9.  
  10. ftp://ftp.x.org/contrib/utilities/mfsm-1.1.tar.gz
  11.  
  12.  
  13. DRIVE ICON:
  14.  
  15.     The drive icon is a label that pictorially describes the type
  16. of file system being monitored. The available drive types are:
  17.  
  18.     1> Floppy disk.
  19.     2> Hard disk.
  20.     3> Network or NFS disk.
  21.     4> User's home directory.
  22.     5> CDROM.
  23.  
  24.  
  25. USAGE BAR CHART:
  26.  
  27.     The usage bar chart is just that. It is a coloured bar that
  28. indicated the percentage use of the filesystem. Displayed in the usage
  29. bar is 20% tic marks, the filesystem path, and the amount of free space
  30. in MegaBytes. The colour of the bar changes depending the percentage
  31. of file system space used. By default the following colours are
  32. defined:
  33.  
  34.     Green        Usage less than 75%.
  35.     Yellow        Usage greater than 75% but less than 95%.
  36.     Red        Usage greater than 95% but less than 99%.
  37.     Panic        Usage greater than 99% to 100%. (Gold3 and
  38.             Black banded colours).
  39.  
  40.  
  41. ALERT BELL TOGGLE:
  42.  
  43.     This is a toggle button that turns the warning bell off or
  44. on. By default, the terminal bell will sound once per second when a
  45. file system is full.
  46.  
  47.  
  48.  
  49.  
  50. ** TO COMPILE **
  51.  
  52. 1> Edit the Imakefile for the following defines:
  53.     a> MACHINE_INFO - Make sure that this define will be set correctly.
  54.  
  55.     b> HAVE_QUOTAS - Enable this if you have quota support.
  56.  
  57.     c> USE_IOCTL - Enable if your quota support is through the
  58.     ioctl(2) function and not the quotactl(2) function.
  59.  
  60.     d> HAVE_XPM - It is recomended that you use the XPM library
  61.     for colour pixmaps. This can be found at the following places:
  62.  
  63.     ftp.x.org:/contrib/libraries/xpm-3.4e.tar.gz
  64.     avahi.inria.fr:/pub/xpm/xpm-3.4e.tar.gz
  65.  
  66.     If you are using XPM, then define the location of the XPM
  67.     library and include files with the variables XPM_LIB and
  68.     XPM_INCLUDE. If you don't want to use XPM support, then change
  69.     the
  70.  
  71.     #define HAVE_XPM
  72.  
  73.     to
  74.  
  75.     #undef HAVE_XPM
  76.  
  77.     e> BINDIR, MANDIR - Define the location for the executable and
  78.     man page respectively.
  79.  
  80. 2> run  xmkmf
  81.     make
  82.     make install
  83.     make install.man
  84.  
  85.  
  86.  
  87. ** System Functions that may be system dependent **
  88.  
  89. Some or all of the functions below may require attention for other
  90. systems. If Mfsm does not work on your system, send me a copy of the
  91. man pages for the following functions and I will modify Mfsm for you.
  92.  
  93. statfs(2):            File system infomation.
  94. setpwent(2), getpwent(2):    Password file entry reading.
  95. df(1):                Report number of free disk
  96.                 blocks. Only used to check device names.
  97. quotactl(2):            Quota information.
  98. ioctl(2):            File system information.
  99.  
  100.  
  101.  
  102. ** Author **
  103.  
  104. Shane D. Hill
  105.  
  106. ** Problems **
  107.  
  108. Send any problems or gripes to:
  109.  
  110.     Shane.Hill@dsto.defence.gov.au
  111.