SG_RESET_WP(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_RESET_WP(8) ✨

okay bestie, this is the SG_RESET_WP(8) manual page from SG3_UTILS 💖 it's the guide for the sg_reset_wp tool, and it's honestly so useful 🫶

🎀 NAME 🎀

sg_reset_wp — send a SCSI RESET WRITE POINTER command 🦋

🌸 SYNOPSIS 🌸

sg_reset_wp [--all] [--count=ZC] [--help] [--verbose] [--version]
[--zone=ID] DEVICE

💅 DESCRIPTION 💅

okay so this tool sends a SCSI RESET WRITE POINTER command to your DEVICE 🔥 the command is described in the ZBC standard (INCITS 536-2016) and in the draft ZBC-2 documents over at T10, like zbc2r12.pdf. literally the source of truth, no cap ✨

✨ OPTIONS ✨

quick heads up: arguments to long options are mandatory for short options as well 🙈

  • -a, --all — this sets the ALL field in the cdb, so the reset hits every open zone and every full zone 💜 if you use this, then any --zone=ID you pass gets ignored (rude, but that's the rule). you need either this or --zone=ID, one of them is required, periodt 👑
  • -C, --count=ZC — ZC goes into the Zone Count field of the cdb for the RESET WRITE POINTER command. ZC should be somewhere from 0 to 65535 (0xffff), inclusive 🍓 what the DEVICE actually does with it depends on whether --all is set too. for the full tea, check the RESET WRITE POINTER command description (section 5.9, table 46 in zbc2r12.pdf) 🧚
  • -h, --help — prints the usage message and then exits 💀
  • -v, --verbose — bumps up the verbosity level, so you get extra debug output 🔍
  • -V, --version — prints the version string and then exits 🌈
  • -z, --zone=ID — ID gets placed in the cdb's ZONE ID field. a zone id is a zone start logical block address (LBA), and this triggers a reset write pointer on whatever zone has that ZONE ID ✨ the default value is 0. you need either this or --all, so don't forget 🫶 ID is decimal by default, but if you prefix it with 0x or stick a trailing h on it, it's read as hexadecimal instead 🦋

📝 NOTES 📝

the Zones Emptied log parameter in the Zoned Block Device Statistics log page keeps count of how many times RESET WRITE POINTER has been (successfully) invoked 📊 so it's basically the scoreboard 😭

🚪 EXIT STATUS 🚪

the exit status of sg_reset_wp is 0 when it works 💖 otherwise, go check the sg3_utils(8) man page 🫶

👩‍💻 AUTHORS 👩‍💻

written by Douglas Gilbert, the legend himself 👑

🐛 REPORTING BUGS 🐛

if something's broken, report it to <dgilbert at interlog dot com> 💌

Copyright © 2014-2022 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, so use your best judgment 💅

🔗 SEE ALSO 🔗

sg_rep_zones,sg_zone(sg3_utils) ✨

okay that's the whole tea, bestie 🫶 from sg3_utils-1.48, February 2022, with SG_RESET_WP(8) energy forever 💖🦋🌈

📦 where this page comes from