SGRAIDMON(8)

📦 version 1.6.6, in opensuse-leap 16.0

sgraidmon — SCSI Generic RAID Monitor 💅

okay bestie, this is the sgraidmon(8) manual — the SCSI Generic RAID Monitor page. It is giving certified sysadmin main-character energy, and we are gonna go through it together, no cap. ✨

🌸 NAME 🌸

sgraidmon — SCSI Generic RAID Monitor

🦋 SYNOPSIS 🦋

sgraidmon [-bermnx -t time]

That is the whole summoning spell, iykyk. 🪄

🔥 DESCRIPTION 🔥

Sgraidmon is a program that uses the SCSI Generic interface to monitor SCSI devices which may be part of a software 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.

quick vibe check: no CONFIG_CHR_DEV_SG, no SCSI Generic interface. Please do not skip that part, bestie. 😭

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 — yeah bestie, here is the whole menu. 💅

  • -? — displays a summary of the commands accepted by sgraidmon.
  • -b — causes this utility to run in the 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 (the 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 different 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 sgraidmon 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).

🫶 SEE ALSO 🫶

Go check out these other manual pages too, bestie: sgdiskmon(8), 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 (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.

🎀 AUTHOR 🎀

Andy Cress <arcress@users.sourceforge.net>

Ok that is the whole page, bestie — final vibe check: this is Version 1.3: 23 Oct 2003, from the System Manager's Manual (SGRAIDMON(8)). Bye, love u, and remember to check CONFIG_CHR_DEV_SG! 💖✨

📦 where this page comes from