From Linux Man Pages
sgraidmon - SCSI Generic RAID Monitor
sgraidmon [-bermnx -t time]
DESCRIPTION
Sgraidmon is a program that uses the SCSI Generic interface to monitor SCSI devices which may be part of a soft-
ware RAID, so that hot-removal and hot-insertion events can be detected and acted upon. It also queries the hot-
swap backplane, if present, with SAF-TE commands to detect hot-insertions. If an insertion or removal event
occurs, this utility invokes a script (/sbin/mdevt). For Insert, mdevt partitions the new disk and remirrors the
Linux partitions. The mdevt script can be customized as desired. The SCSI Generic interface requires that the
kernel .config file have CONFIG_CHR_DEV_SG set.
A log file, named /var/log/sgraidmon.log, is created which logs the status of the sgraidmon functions and any
errors. A separate log file, named /var/log/mdevents, logs messages and errors from the mdevt action script.
OPTIONS
Command line options are described below.
-? This option displays a summary of the commands accepted by sgraidmon
-b Causes this utility to run in background as a daemon.
-e Causes any file writes to be avoided, such as the log file.
-m Max serial number length of 12 instead of 8 (default). This may be needed if you have Fujistu drives.
-n Naming. By default, the device names are displayed as numeric sequences (/dev/sg0). This option shows
the device names as alphabetic sequences (/dev/sga).
-r Run once. By default, this utility runs in a continuous loop. This option causes it to only run one
pass.
-t Time interval. The default polling interval is 5 seconds. This option can set the interval to a differ-
ent number of seconds.
-x Causes extra debug messages to be displayed.
ERRORS
Please supply the contents of the /var/log/sgraidmon.log and /var/log/mdevents files with any problem report.
Note that sgraidmon has an option for additional debug output (-x). See http://scsirastools.sourceforge.net for
a bug list, ChangeLog, and any later versions of sgraidmon. There are some unique error codes defined in sgraid-
mon as follows:
-1 is an error from a generic system function, check errno value.
-2 means that the SCSI request returned a check condition (sense error)
-3 means that the SCSI request failed while writing the command.
-4 means that the SCSI request failed while reading the response.
-5 means that the device did not respond to basic SCSI ioctl functions.
-6 means that the SCSI Inquiry returned an invalid size, so that device may be an impostor (failed).
RELATED
sgdiag(8) sgdskfl(8) sgmode(8)
WARNINGS
See http://sourceforge.net/projects/scsirastools/ for a bug list and any later versions of this utility.
COPYRIGHT
Copyright (C) 2001-2002 Intel Corp.
sgraidmon is open source software. You can redistribute it and/or modify it under the terms of the BSD License.
See the COPYING file included with this software package for more details regarding distribution.
sgraidmon is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.
CATEGORY