1SG_ZONE(8) SG3_UTILS SG_ZONE(8)
2
3
4
6 sg_zone - send a SCSI ZONE modifying command
7
9 sg_zone [--all] [--close] [--count=ZC] [--element=EID] [--finish]
10 [--help] [--open] [--remove] [--sequentialize] [--verbose] [--version]
11 [--zone=ID] DEVICE
12
14 Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE, REMOVE ELEMENT AND
15 MODIFY ZONES or SEQUENTIALIZE ZONE command to the DEVICE. All but the
16 last two are found in the ZBC standard (INCITS 536-2016). The REMOVE
17 ELEMENT AND MODIFY ZONES command was added in zbc2r07 while the SEQUEN‐
18 TIALIZE ZONE command was added in zbc2r01b.
19
20 One and only one of the --open, --close, --finish, --remove and --se‐
21 quentialize options can be chosen.
22
24 Arguments to long options are mandatory for short options as well.
25
26 -a, --all
27 sets the ALL field in the cdb.
28
29 -c, --close
30 causes the CLOSE ZONE command to be sent to the DEVICE.
31
32 -C, --count=ZC
33 ZC is placed in the Zone Count field in the cdb of all four com‐
34 mands supported by this utility. ZC should be a value from 0 to
35 65535 (0xffff) inclusive.
36
37 -e, --element=EID
38 where EID is an element identifier which is a 32 bit unsigned
39 integer starting at one. This field is used by the REMOVE ELE‐
40 MENT AND MODIFY ZONES command and its default value is zero
41 (which is invalid). So the user needs to supply a valid element
42 identifier when --remove is used.
43
44 -f, --finish
45 causes the FINISH ZONE command to be sent to the DEVICE.
46
47 -h, --help
48 output the usage message then exit.
49
50 -o, --open
51 causes the OPEN ZONE command to be sent to the DEVICE.
52
53 -r, --remove
54 causes the REMOVE ELEMENT AND MODIFY ZONES command to be sent to
55 the DEVICE. In practice, --element=EID needs to be also given.
56
57 -S, --sequentialize
58 causes the SEQUENTIALIZE ZONE command to be sent to the DEVICE.
59
60 -v, --verbose
61 increase the level of verbosity, (i.e. debug output).
62
63 -V, --version
64 print the version string and then exit.
65
66 -z, --zone=ID
67 where ID is placed in the cdb's ZONE ID field. A zone id is a
68 zone start logical block address (LBA). The default value is 0.
69 ID is assumed to be in decimal unless prefixed with '0x' or has
70 a trailing 'h' which indicate hexadecimal.
71
73 The exit status of sg_zone is 0 when it is successful. Otherwise see
74 the sg3_utils(8) man page.
75
77 Written by Douglas Gilbert.
78
80 Report bugs to <dgilbert at interlog dot com>.
81
83 Copyright © 2014-2021 Douglas Gilbert
84 This software is distributed under a FreeBSD license. There is NO war‐
85 ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
86 POSE.
87
89 sg_rep_zones,sg_reset_wp(sg3_utils)
90
91
92
93sg3_utils-1.43 January 2021 SG_ZONE(8)