SMP_REP_GENERAL(8)

💖 SMP_REP_GENERAL 💖

okay bestie, welcome to the smp_utils corner of the manual, where we're talking about smp_rep_general(8) — the little tool that yells REPORT GENERAL at your SAS expander and gets the tea back. she's 8th-section, she's a sysadmin situation, and she absolutely ate.

---

✨ NAME ✨

smp_rep_general — invoke REPORT GENERAL SMP function

---

🦋 SYNOPSIS 🦋

smp_rep_general [--brief] [--changecount] [--help] [--hex]
[--interface=PARAMS] [--raw] [--sa=SAS_ADDR] [--verbose] [--version]
[--zero] SMP_DEVICE[,N]

---

🌸 DESCRIPTION 🌸

So basically, this thing sends a SAS Serial Management Protocol (SMP) REPORT GENERAL function request to an SMP target. That's the whole vibe. 💅

The SMP target is identified by the SMP_DEVICE and the SAS_ADDR. Depending on which interface you're rolling with, the SAS_ADDR may just be deduced from the SMP_DEVICE — no extra effort required, slay.

But heads up: the mpt interface uses SMP_DEVICE to identify a HBA (that's an SMP initiator, bestie) and it needs the additional ,N to tell the HBAs apart if there's more than one hanging around. not optional, fr fr.

---

🎀 OPTIONS 🎀

quick note before we dive in: mandatory arguments to long options are mandatory for short options as well. the rules apply to everyone, no exceptions, periodt. 👑

• -b, --brief — reports (prints to stdout) only a few important fields from the response. just the highlights, the tl;dr, the main character moments only. ✨
• -c, --changecount — reports (prints to stdout) the value of the expander change count field from the response. The value is printed in decimal and is in the range 0 to 65535. Only expanders compliant with SAS-1.1 (and earlier) should yield 0. [Expanders compliant with SAS-2 (and later) should set the "long response" bit in the REPORT GENERAL response to 1.] 🌀
• -h, --help — output the usage message then exit. she's helpful like that. 🫶
• -H, --hex — output the response (less the CRC field) in hexadecimal. hex girlies rise up. 🔥
• -I, --interface=PARAMS — interface specific parameters. In this case "interface" refers to the path through the operating system to the SMP initiator. See the smp_utils man page for more information. 🛣️
• -r, --raw — send the response (less the CRC field) to stdout in binary. All error messages are sent to stderr. clean binary out, messy drama elsewhere. 💀
• -s, --sa=SAS_ADDR — specifies the SAS address of the SMP target device. Typically this is an expander. This option may not be needed if the SMP_DEVICE has the target's SAS address within it. The SAS_ADDR is in decimal but most SAS addresses are shown in hexadecimal. To give a number in hexadecimal either prefix it with '0x' or put a trailing 'h' on it. iykyk 🎯
• -v, --verbose — increase the verbosity of the output. Can be used multiple times. stack it like accessories, bestie. 🌈
• -V, --version — print the version string and then exit. 👑
• -z, --zero — zero the Allocated Response Length field in the request. This is required for strict SAS-1.1 compliance. However this option should not be given in SAS-2 and later; if it is given an abridged response may result.

⚠️ bestie listen — -z is a strict-SAS-1.1-compliance situation. do NOT bring it to a SAS-2-and-later party. if you do, you might get an abridged response and nobody wants that. 🙈

---

🧚 EXAMPLES 🧚

See "Examples" section in http://sg.danny.cz/sg/smp_utils.html

(yeah she's sending you off-site for the examples, iconic behavior honestly ✨)

---

💜 CONFORMING TO 💜

The SMP REPORT GENERAL function was introduced in SAS-1, with small additions in SAS-1.1 . There have been a large number of additions in SAS-2 . she's been through some eras, and honestly? she's thriving. 🌱

---

🌟 AUTHORS 🌟

Written by Douglas Gilbert. 🫡

---

😭 REPORTING BUGS 😭

Report bugs to <dgilbert at interlog dot com>.

---

⭐ COPYRIGHT ⭐

Copyright © 2006-2011 Douglas Gilbert

This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

no cap, zero warranty. she's giving what she's giving, as-is. 💅

---

🌈 SEE ALSO 🌈

• smp_utils
• smp_discover(smp_utils)

---

okay that's the whole page, bestie 🫶 this was smp_utils-0.96, dated May 2011 — yes she's vintage, yes she still serves. mwah. 💖✨🎀