SGSAFTE(8)

📦 version 1.6.6, in opensuse-leap 16.0

💅 SGSAFTE(8) — like, the SAF-TE girlie's whole manual, bestie

okay so first things first: this is a page from the System Manager's Manual, and the star of the show is sgsafte. she's iconic, she's useful, and she's about to tell you everything your hotswap backplane is feeling. 🫶

✨ NAME ✨

sgsafte — get SAF-TE status and set disk LEDs 💡

🌸 SYNOPSIS 🌸

sgsafte [-defmnrx]

🦋 DESCRIPTION 🦋

Okay so listen. sgsafte is a program that uses the SCSI Generic interface to send specific SCSI commands so it can obtain the SAF-TE hotswap backplane slot statuses, and also optionally set a disk fault LED. She's basically the group chat admin for your backplane, keeping tabs on every slot. 🔥

Real talk though: the SCSI Generic interface requires that the kernel .config file have CONFIG_CHR_DEV_SG set. No cap, if that's not set, none of this is happening. 😭

And yes, she journals. A log file named sgsafte.log is created in the /var/log directory, which logs the status of the functions and any errors. She's not nosy, she's thorough. 💅

💖 OPTIONS 💖

Command line options are described below. Go off, pick your faves.

  • -? — This option displays a summary of the commands accepted. It's giving "help me help you" energy. 🙈
  • -d — Specifies the drive number to set (0, 1, ...) as displayed in the sgsafte display. So like, pick your fave slot. ✨
  • -e — Causes any file writes to be avoided, such as the log file. Very "touch grass, write nothing" of her. 🌸
  • -m — Use More than 8-byte serial numbers (i.e. 12 bytes). Some disk vendors use longer serial numbers. The default is to detect either 8 or 12 byte serial numbers from the SCSI inquiry response. She'll figure it out herself, but you can insist. 💁‍♀️
  • -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). numbers or letters, both valid, both slay. 🔤
  • -x — Causes extra debug messages to be displayed. For when you simply must know everything. 👑

🎀 SEE ALSO 🎀

sgdiag(8) sgdskfl(8) sgmode(8) sgdefects(8)

(the whole friend group, fr fr 🫶)

⚠️ WARNINGS ⚠️

On some systems with older scsi drivers, the primary defect list cannot be returned without errors.

Not me warning you: check the source. See http://sourceforge.net/projects/scsirastools/ for a bug list and any later versions of this utility. 👀

Copyright (C) 2001-2002 Intel Corp.

This program 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. 📜

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. (she said what she said 💀)

🌈 AUTHOR 🌈

Andy Cress <arcress@users.sourceforge.net> — the main character who made all this happen. 💜

✨ and that's the whole vibe, bestie ✨ — this gorgeous little page is Version 1.1: 09 Nov 2001, and it lives at SGSAFTE(8). now go check those LEDs. 🎀🦋💖

📦 where this page comes from