sgpio(1)

✨ sgpio — bestie's guide to making your backplane LEDs behave ✨

okay so like. hi. you found sgpio(1), which is a USER COMMAND, and honestly? she's a little niche but she's so useful. this is the captive backplane LED control utility. let's get into it 🫶

---

💖 NAME 💖

sgpio — captive backplane LED control utility

no cap, that's literally what she is. she controls LEDs. in a backplane. captive-ly. iconic behavior honestly 👑

---

🌸 SYNOPSIS 🌸

sgpio [-h] [-V] [[-d|--disk <device>[,<device>...]] | [-p|--port
<port>[,<port>...]]] [-s|--status <status>] [-f|--freq <frequency>]

okay the brackets are giving "choose your own adventure" and yes, you do have to read them. the -d and -p situation is an either/or (that's what the | is doing, she's a lil drama queen). everything else is optional. slay 💅

---

🦋 DESCRIPTION 🦋

Serial General Purpose Input Output — say that three times fast, or just say SGPIO like a normal person — is a communication method used between a main board and a variety of internal and external hard disk drive bay enclosures.

this utility can be used to control the LEDs in an enclosure. that's it. that's the job. little lights, big feelings ✨

for more information about SGPIO, please consult the SFF-8485 Specification. iykyk 📚

---

💅 OPTIONS 💅

• -h, --help — displays a short help text. she's brief, she's helpful, she's your girl 🙈
• -V, --version — displays the utility and AHCI SGPIO specification. receipts, basically 🧾
• -d, --disk — disk name of LED location. Names are sda,sdb,sdc,... Multiple names can be provided in a comma-delimited list. so like sda,sdb,sdc and so on — go off, collect them all 🌈
• -p, --port — SATA port number of LED location, can be used if a disk name is no longer valid. 0,1,2,3,... Multiple ports can be provided in a comma-delimited list. this is your backup plan when the disk names ghost you 😭
• -s, --status — status of the LED to set. LED status is: locate, fault, rebuild, off. four moods, pick one 💜
• -f, --freq — Set the frequency at which the LED should blink (in Hz). Frequency should be an integer between 1 and 10. so like, keep it in range bestie, don't get weird with it ⭐

---

🎀 EXAMPLES 🎀

Set the locate LED on SDA with an Intel Intelligent backplane:

sgpio -d sda -s locate

Set the locate LED on SDA to flash at 3 Hz for non-intelligent backplanes:

sgpio -d sda -s locate -f 3

Set SATA port 2 with fault at a 3 Hz flash rate:

sgpio -p 2 -s fault -f 3

Set disks sda through sdf to fault:

sgpio -d sda,sdb,sdc,sdd,sde,sdf -s fault

see how they're all just variations on a vibe? main character energy from start to finish 💖

---

🌟 EXIT STATUS 🌟

sgpio should return zero when successful. It will return with a non-zero value if there was a failure.

so like, 0 = we ate, non-zero = we did NOT eat. check your exit codes, bestie, they're literally telling you how it went 🔥

---

👑 AUTHOR 👑

Eric R. Hall <Eric.R.Hall@intel.com>

respect the architect 🫶

---

and that's the whole page!! version 0.3, dated December 2007 — she's a lil vintage but she still serves. go blink some LEDs responsibly, mwah 💋✨