sg_zone(8)

1SG_ZONE(8)                         SG3_UTILS                        SG_ZONE(8)
2
3
4

NAME

6       sg_zone - send a SCSI ZONE modifying command
7

SYNOPSIS

9       sg_zone   [--all]  [--close]  [--count=ZC]  [--element=EID]  [--finish]
10       [--help] [--open] [--remove] [--sequentialize] [--verbose]  [--version]
11       [--zone=ID] DEVICE
12

DESCRIPTION

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

OPTIONS

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

EXIT STATUS

73       The exit status of sg_zone is 0 when it is  successful.  Otherwise  see
74       the sg3_utils(8) man page.
75

AUTHORS

77       Written by Douglas Gilbert.
78

REPORTING BUGS

80       Report bugs to <dgilbert at interlog dot com>.
81

COPYRIGHT

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