SAS_DISK_BLINK(8)

📦
version 1.12 · 2 versions
  • 1.12 · arch rolling, debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.10 · ubuntu jammy
, in arch rolling, debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

okay bestie, so this is a section 8 manual page (that's the sysadmin-y one) from the sdparm family, and it's literally just: sas_disk_blink — the lil script that makes a SAS disk's LED go blink blink so you can figure out which physical drive you're actually staring at. 🦋

🌸 NAME 🌸

sas_disk_blink — blink the LED on a SAS disk 💡✨

🎀 SYNOPSIS 🎀

sas_disk_blink [--help] [--set NUM] [--verbose] DEVICE

💖 DESCRIPTION 💖

So. This is a bash shell script, and what it does is attempt to blink the LED on the SAS disk that DEVICE is pointing at. By default the LED will blink for 30 seconds. The whole point of this is to help you identify which disk corresponds to a given DEVICE — like, you're standing in a server room with 24 identical drives and you need to know which one is that one. 💅

Under the hood, the script uses the sdparm utility and manipulates the "Ready LED Meaning" (RLM) field in the Protocol specific port mode page in order to blink the LED. That's the whole trick. Iconic behavior, honestly. 👑

✨ OPTIONS ✨

Heads up before we dive in: arguments to long options are mandatory for short options as well. So don't be out here trying to be cute with it. 🙈

  • -h, --help — print out the usage message then exit. Very demure, very mindful. 🎀
  • -s, --set NUM — okay so this one's a choose-your-own-adventure:
    • when NUM is 0 then the RLM field is cleared.
    • when NUM is 1 then the RLM field is set.
    • when NUM > 1 then the SAS disk LED is made to blink for NUM seconds.
    • If this option is not given then the SAS disk LED is made to blink for 30 seconds. (the default! she has a default! 💅)
  • -v, --verbose — increase level or verbosity. More yapping, more info. 🗣️

🫶 EXIT STATUS 🫶

The exit status of this script is 0 when it is successful. Otherwise the exit status is that of the last sdparm utility called. See the sdparm(8) man page. no cap, that's where the real tea is. 🍓

👑 AUTHORS 👑

Written by D. Gilbert. 💜

Copyright © 2013-2016 Douglas Gilbert

This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. (so if it breaks, it's not their problem bestie 😭)

🔥 SEE ALSO 🔥

  • sdparm (sdparm)

sdparm-1.11 · February 2016 — that's the version and the date, mwah, go blink some LEDs, you've got this 💖✨

📦 where this page comes from