{
    "mode": "man",
    "parameter": "SG_ZONE",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/SG_ZONE/8/json",
    "generated": "2026-06-13T20:07:28Z",
    "synopsis": "sgzone  [--all]  [--close]  [--count=ZC] [--element=EID] [--finish] [--help] [--open] [--re‐\nmove] [--sequentialize] [--verbose] [--version] [--zone=ID] DEVICE",
    "sections": {
        "NAME": {
            "content": "sgzone - send a SCSI ZONE modifying command\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "sgzone  [--all]  [--close]  [--count=ZC] [--element=EID] [--finish] [--help] [--open] [--re‐\nmove] [--sequentialize] [--verbose] [--version] [--zone=ID] DEVICE\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE, REMOVE ELEMENT AND MODIFY ZONES  or  SEQUEN‐\nTIALIZE  ZONE  command to the DEVICE. All but the last two are found in the ZBC standard (IN‐\nCITS 536-2016). The REMOVE ELEMENT AND MODIFY ZONES command was added in  zbc2r07  while  the\nSEQUENTIALIZE ZONE command was added in zbc2r01b.\n\nOne  and  only one of the --open, --close, --finish, --remove and --sequentialize options can\nbe chosen.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "Arguments to long options are mandatory for short options as well.\n",
            "subsections": [
                {
                    "name": "-a --all",
                    "content": "sets the ALL field in the cdb.\n",
                    "flag": "-a",
                    "long": "--all"
                },
                {
                    "name": "-c --close",
                    "content": "causes the CLOSE ZONE command to be sent to the DEVICE.\n",
                    "flag": "-c",
                    "long": "--close"
                },
                {
                    "name": "-C --count",
                    "content": "ZC is placed in the Zone Count field in the cdb of all four commands supported by this\nutility. ZC should be a value from 0 to 65535 (0xffff) inclusive.\n",
                    "flag": "-C",
                    "long": "--count"
                },
                {
                    "name": "-e --element",
                    "content": "where EID is an element identifier which is a 32 bit unsigned integer starting at one.\nThis field is used by the REMOVE ELEMENT AND MODIFY  ZONES  command  and  its  default\nvalue  is zero (which is invalid). So the user needs to supply a valid element identi‐\nfier when --remove is used.\n",
                    "flag": "-e",
                    "long": "--element"
                },
                {
                    "name": "-f --finish",
                    "content": "causes the FINISH ZONE command to be sent to the DEVICE.\n",
                    "flag": "-f",
                    "long": "--finish"
                },
                {
                    "name": "-h --help",
                    "content": "output the usage message then exit.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-o --open",
                    "content": "causes the OPEN ZONE command to be sent to the DEVICE.\n",
                    "flag": "-o",
                    "long": "--open"
                },
                {
                    "name": "-r --remove",
                    "content": "causes the REMOVE ELEMENT AND MODIFY ZONES command to be sent to the DEVICE. In  prac‐\ntice, --element=EID needs to be also given.\n",
                    "flag": "-r",
                    "long": "--remove"
                },
                {
                    "name": "-S --sequentialize",
                    "content": "causes the SEQUENTIALIZE ZONE command to be sent to the DEVICE.\n",
                    "flag": "-S",
                    "long": "--sequentialize"
                },
                {
                    "name": "-v --verbose",
                    "content": "increase the level of verbosity, (i.e. debug output).\n",
                    "flag": "-v",
                    "long": "--verbose"
                },
                {
                    "name": "-V --version",
                    "content": "print the version string and then exit.\n",
                    "flag": "-V",
                    "long": "--version"
                },
                {
                    "name": "-z --zone",
                    "content": "where ID is placed in the cdb's ZONE ID field. A zone id is a zone start logical block\naddress (LBA). The default value is 0. ID is assumed to be in decimal unless  prefixed\nwith '0x' or has a trailing 'h' which indicate hexadecimal.\n",
                    "flag": "-z",
                    "long": "--zone"
                }
            ]
        },
        "EXIT STATUS": {
            "content": "The  exit  status  of  sgzone is 0 when it is successful. Otherwise see the sg3utils(8) man\npage.\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Written by Douglas Gilbert.\n",
            "subsections": []
        },
        "REPORTING BUGS": {
            "content": "Report bugs to <dgilbert at interlog dot com>.\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright © 2014-2021 Douglas Gilbert\nThis software is distributed under a FreeBSD license. There is NO warranty; not even for MER‐\nCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "sgrepzones,sgresetwp(sg3utils)\n\n\n\nsg3utils-1.43                              January 2021                                  SGZONE(8)",
            "subsections": []
        }
    },
    "summary": "sgzone - send a SCSI ZONE modifying command",
    "flags": [
        {
            "flag": "-a",
            "long": "--all",
            "arg": null,
            "description": "sets the ALL field in the cdb."
        },
        {
            "flag": "-c",
            "long": "--close",
            "arg": null,
            "description": "causes the CLOSE ZONE command to be sent to the DEVICE."
        },
        {
            "flag": "-C",
            "long": "--count",
            "arg": null,
            "description": "ZC is placed in the Zone Count field in the cdb of all four commands supported by this utility. ZC should be a value from 0 to 65535 (0xffff) inclusive."
        },
        {
            "flag": "-e",
            "long": "--element",
            "arg": null,
            "description": "where EID is an element identifier which is a 32 bit unsigned integer starting at one. This field is used by the REMOVE ELEMENT AND MODIFY ZONES command and its default value is zero (which is invalid). So the user needs to supply a valid element identi‐ fier when --remove is used."
        },
        {
            "flag": "-f",
            "long": "--finish",
            "arg": null,
            "description": "causes the FINISH ZONE command to be sent to the DEVICE."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "output the usage message then exit."
        },
        {
            "flag": "-o",
            "long": "--open",
            "arg": null,
            "description": "causes the OPEN ZONE command to be sent to the DEVICE."
        },
        {
            "flag": "-r",
            "long": "--remove",
            "arg": null,
            "description": "causes the REMOVE ELEMENT AND MODIFY ZONES command to be sent to the DEVICE. In prac‐ tice, --element=EID needs to be also given."
        },
        {
            "flag": "-S",
            "long": "--sequentialize",
            "arg": null,
            "description": "causes the SEQUENTIALIZE ZONE command to be sent to the DEVICE."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "increase the level of verbosity, (i.e. debug output)."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "print the version string and then exit."
        },
        {
            "flag": "-z",
            "long": "--zone",
            "arg": null,
            "description": "where ID is placed in the cdb's ZONE ID field. A zone id is a zone start logical block address (LBA). The default value is 0. ID is assumed to be in decimal unless prefixed with '0x' or has a trailing 'h' which indicate hexadecimal."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "sgresetwp",
            "section": "sg3utils",
            "url": "https://www.chedong.com/phpMan.php/man/sgresetwp/sg3utils/json"
        }
    ]
}