SG_RTPG(8)

📦
version 1.49 · 3 versions
, in alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ sg_rtpg 💖 SEND SCSI REPORT TARGET PORT GROUPS COMMAND ✨

Okay bestie, this is the manual page for sg_rtpg, the tool that sends a SCSI REPORT TARGET PORT GROUPS command. 🦋

🎀 SYNOPSIS 🎀

sg_rtpg [--decode] [--help] [--hex] [--raw] [--readonly] [--verbose]
[--version] DEVICE

💅 DESCRIPTION 💅

So basically, sg_rtpg sends a SCSI REPORT TARGET PORT GROUPS command to DEVICE and then prints whatever comes back. It's giving main character energy 🌸

Target port group access is described in SPC-3 and SPC-4, which you can find at www.t10.org . 📚 The newest draft of SPC-4 is revision 37, and that's where target port groups live, in section 5.15 . Go read it if you're obsessed 🤓

🌈 OPTIONS 🌈

Quick vibe check: arguments to long options are mandatory for short options as well. Don't forget that one 🫶

  • -d, --decode — decodes the status code and asymmetric access state from each target port group descriptor that comes back. By default it does NOT decode these values, so you have to ask for it 💁‍♀️
  • -e, --extended — uses the extended header format for parameter data. This sets the PARAMETER DATA FORMAT field in the cdb to 1. ✨
  • -h, --help — prints the usage message and then exits. 🧚
  • -H, --hex — shows the response in hex instead of partially or fully decoding it. 🍓
  • -r, --raw — dumps the response as binary to stdout. 💜
  • -R, --readonly — opens the DEVICE read-only (on Unix that's the O_RDONLY flag, for example). The default is read-write, so if you want safety, this is your bestie 🛡️
  • -v, --verbose — cranks up the verbosity, aka more debug output. Lowkey useful when things get weird 🙈
  • -V, --version — prints the version string and then exits. 🌟

🦋 NOTES 🦋

The Report Target Port Groups command should be supported whenever the TPGS bits in a standard INQUIRY response are greater than zero. 🔍 [View with sg_inq utility.] 🎀

👑 EXIT STATUS 👑

The exit status of sg_rtpg is 0 when it works. Otherwise, check out the sg3_utils(8) man page for the rest of the status codes 💀

🫶 AUTHORS 🫶

Written by Douglas Gilbert. Iconic. 🔥

🐛 REPORTING BUGS 🐛

Found a bug? Report it to <dgilbert at interlog dot com>. Don't just vibe with it in silence 😭

Copyright © 2004-2014 Christophe Varoqui and Douglas Gilbert. This software is distributed under a BSD-2-Clause license. There is NO warranty, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Periodt 💅

🔗 SEE ALSO 🔗

sg_inq(sg3_utils) ✨

Okay that's the whole tea, bestie! 🧚 Version sg3_utils-1.39, May 2014. Stay iconic. 💖

📦 where this page comes from