NAME¶
mfsm - file system and disk quota monitor for X-Motif
SYNOPSIS¶
mfsm [ -a ] [ -df df_command ] [ -fs
filesystem[:filesystem ...] ] [ -fn font ] [ -fnbold font ] [
-int seconds ] [ -bellint seconds ] [ -gacol colour ] [
-yacol colour ] [ -racol colour ] [ -pacol colour ] [
-pafg colour ] [ -scale ] [ -scroll ] [ -yalim %
] [ -ralim % ] [ -paniclim % ] [ -t ] [ -u ] [
-v ] [ -width pixels ]
DESCRIPTION¶
Mfsm is a X-Windows Motif utility that monitors freespace and user
quotas of filesystems. The program displays a drive icon, a usage bar chart,
and an alert bell toggle. The drive icon displays the type of filesystem
being monitored (e.g. floppy, disk, cdrom, user account). The usage bar
gives a display of the percentage use of the filesystem and displays the
amount of space remaining in megabytes. If the file system is a user account
with quotas enabled, then the usage bar will display remaining quota space
available. A "(Q)" will be displayed if quotas are being processed
via the quotactl command. A "(q)" will be displayed if quotas are
being processed via the quota system command. The usage bar changes colour
depending the amount of file system use. The alert bell toggle is used to
disable the alert bell that sounds when the file system is full.
Also added to each usage bar is a white file system size marker.
This marker is positioned as a percentage of the maximum file system size.
The marker gives a relative indication of the difference in file system size
for all usage bars. The marker does not appear if usage bar scaling is
used.
OPTIONS¶
-a
This option causes all mounted file systems to be
monitored. The option can be used inconjunction with the -fs option.
One or either must be specified.
-df df_command
This is the df command to use to identify file systems
for the -a flag (e.q. "df --type nfs"). Ignored if -a flag not
used.
-fs filesystem[:filesystem ...]
filesystem denotes a mounted file system (e.g. /usr or
/tmp), or user account (e.g. /home/guest). This option can be used
inconjunction with the
-fn font
This option overrides the default font used to display
file system information within the usage bar. The default is
8x13.
-fnbold font
This option overrides the bold font used to display file
system information within the usage bar. The default is 8x13bold.
-int seconds
This option sets the usage bar refresh rate in seconds.
Fractions of seconds may be used (e.g. 0.5). The default is 1
second.
-bell
This flag turns the file system bell option off.
-bellint seconds
This option sets the rate at which the alert bell will
sound when a file system becomes full. The default is 1 second.
-gacol colour
This option sets the colour of the usage bar when the
percentage use of the file system is below the value set by the yellow alert
limit yalim. The default colour is green.
-yacol colour
This option sets the colour of the usage bar when the
percentage use of the file system is below the value set by the red alert
limit ralim. The default colour is yellow.
-racol colour
This option sets the colour of the usage bar when the
percentage use of the file system is below the value set by the panic alert
limit paniclim. The default colour is red.
-pacol colour
This option sets the colour of the usage bar when the
file system is full. The default is colour is gold3.
-pafg colour
This option sets the colour of the usage bar text when
the file system is full. The default is colour is Yellow.
-scale
This option scales the usage bars as a function of the
file system size.
-scroll
This option includes scroll bars to the usage bar
view.
-yalim %
This option sets the file system usage limit in % for the
yellow alert coloured usage bar. The usage bar will change to colour
yacol when this limit is reached. The default is 75.
-ralim %
This option sets the file system usage limit in % for the
red alert coloured usage bar. The usage bar will change to colour racol
when this limit is reached. The default is 95.
-paniclim %
This option sets the file system usage limit in % for the
panic alert coloured usage bar. The usage bar will change to colour
pacol when this limit is reached. The default is 99.
-t
This option removes the window manager's title bar from
the window.
-u
This option displays file system usage rather than free
space. This may be selected at run-time by pressing the u key. Free
space can be displayed by pressing the f key.
-v
This option produces verbose comment to stdout about the
mfsm monitoring system. Good for debugging perposes.
-width pixels
This option sets the width of the usage bar in pixels.
The default is 400.
EXAMPLES¶
mfsm -a
Tells mfsm
to monitor all mounted file systems.
mfsm -a -df "df --type nfs"
Tells mfsm
to monitor all mounted nfs file systems using the modified df command. Note
that this example uses a Linux version of the df command. See your local
systems df command manual to see what options are available.
mfsm -fs /home/guest:/tmp
Tells mfsm to monitor the user account /home/guest
and the temporary file system space /tmp. If quotas are enabled for
guest, then quota information will be used.
KEYBOARD COMMANDS¶
A number of keyboard keys are associated with display functions.
These are:
a
This key will display the about dialog window.
f
This key will set the display to show free space in
MegaBytes.
i
This key will iconify the Mfsm program.
q
This key will quit the Mfsm program.
s
This key will set the display to show file system size in
MegaBytes.
u
This key will set the display to show file system usage
in MegaBytes.
v
This key will toggle the verbose information support on
and off.
XDEFAULTS¶
This program understands the core resource names and classes as
well as:
bellInterval (class BellInterval)
Float that specifies the alert bell interval. The default
is 1.
fileSystem (class FileSystem)
String that specifies the default files systems to
monitor. The default is NULL.
greenAlertColor (class GreenAlertColor)
String that specifies the colour of the green alert usage
bar. The default is green.
interval (class Interval)
Float that specifies the refresh interval for the usage
bar. The default is 1.
panicAlertColor (class PanicAlertColor)
String that specifies the colour of the panic alert usage
bar. The default is gold3.
panicAlertLimit (class PanicAlertLimit)
Integer that specifies the percentage limit of the panic
alert usage bar. The default is 99.
redAlertColor (class RedAlertColor)
String that specifies the colour of the red alert usage
bar. The default is red.
redAlertLimit (class RedAlertLimit)
Integer that specifies the percentage limit of the red
alert usage bar. The default is 95.
showAllDrives (class ShowAllDrives)
Boolean that specifies if all mounted file systems will
be monitored. Default is False.
showDiskUsed (class ShowDiskUsed)
Boolean that specifies if file system (disk) usage is to
be displayed rather than free space. The default is False.
showTitleBar (class ShowTitleBar)
Boolean that specifies whether or not the window manager
will display the title bar. The default is True.
verbose (class Verbose)
Boolean that specifies whether or not the verbose comment
mode will be used. The default is False.
yellowAlertColor (class YellowAlertColor)
String that specifies the colour of the yellow alert
usage bar. The default is yellow.
yellowAlertLimit (class YellowAlertLimit)
Integer that specifies the percentage limit of the yellow
alert usage bar. The default is 75.
COPYRIGHT¶
Copyright 1995 by Shane D. Hill. All rights reserved.
AUTHOR¶
Shane D. Hill (Shane.Hill@dsto.defence.gov.au)