SG\_RESET\_WP(8) SG3\_UTILS SG\_RESET\_WP(8)

# [NAME](#NAME)

sg\_reset\_wp - send SCSI RESET WRITE POINTER command

# [SYNOPSIS](#SYNOPSIS)

**sg\_reset\_wp** \[*--all*] \[*--count=ZC*] \[*--help*] \[*--verbose*] \[*--version*] \[*--zone=ID*] *DEVICE*

# [DESCRIPTION](#DESCRIPTION)

Sends a SCSI RESET WRITE POINTER command to the *DEVICE*. This command is described in ZBC standard (INCITS 536-2016) and the draft ZBC-2 documents at T10 (e.g. zbc2r12.pdf).

# [OPTIONS](#OPTIONS)

Arguments to long options are mandatory for short options as well.

[**-a**, **--all**](#a)

sets the ALL field in the cdb. This causes a reset write pointer operation of all open zones and full zones. When this option is given then the *--zone=ID* option is ignored. Either this option or the *--zone=ID* option is required.

[**-C**, **--count**=*ZC*](#C)

ZC is placed in the Zone Count field in the cdb of the RESET WRITE POINTER command supported by this utility. ZC should be a value from 0 to 65535 (0xffff) inclusive.  
The action that the *DEVICE* takes with this option depends on whether the *--all* option is set. See the RESET WRITE POINTER command description (e.g. section 5.9, table 46 in zbc2r12.pdf).

[**-h**, **--help**](#h)

output the usage message then exit.

[**-v**, **--verbose**](#v)

increase the level of verbosity, (i.e. debug output).

[**-V**, **--version**](#V)

print the version string and then exit.

[**-z**, **--zone**=*ID*](#z)

where *ID* is placed in the cdb's ZONE ID field. A zone id is a zone start logical block address (LBA). This causes a reset write pointer operation on the zone identified by the ZONE ID field. The default value is 0. Either this option or the *--all* option is required. *ID* is assumed to be in decimal unless prefixed with '0x' or has a trailing 'h' which indicate hexadecimal.

# [NOTES](#NOTES)

The Zones Emptied log parameter in the Zoned Block Device Statistics log page counts the number of times the RESET WRITE POINTER command has been (successfully) invoked.

# [EXIT STATUS](#EXIT_STATUS)

The exit status of sg\_reset\_wp is 0 when it is successful. Otherwise see the [sg3\_utils(8)](/man/enterprise-packages/sg3-utils/sg3_utils.8) man page.

# [AUTHORS](#AUTHORS)

Written by Douglas Gilbert.

# [REPORTING BUGS](#REPORTING_BUGS)

Report bugs to <dgilbert at interlog dot com>.

# [COPYRIGHT](#COPYRIGHT)

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.

# [SEE ALSO](#SEE_ALSO)

**sg\_rep\_zones,sg\_zone(sg3\_utils)**

February 2022 sg3\_utils-1.48

---

Document: sg_reset_wp(8) from sg3-utils 1.49-r2 (Chainguard OS)
Source: https://github.com/doug-gilbert/sg3_utils.git