The zoned block device (ZBD) interface that supports ZBC and ZAC disks was added to Linux® in kernel version 4.10. All Linux kernel versions since 4.10 include the ZBD interface.
Linux kernels prior to version 4.10 do not implement the ZBD interface. If you use a kernel older than kernel 4.10, you can access and manage ZBC and ZAC disks, but only in a limited way. This is discussed in more detail in the Linux Support document.
To verify that the zoned device has been discovered and correctly initalized, several user utilities must be installed on the test system. These utilities are discussed in more detail in the section called User Utilities.
We recommend only systems with Linux kernels that are version 4.10 or higher for use with ZBC and ZAC hard disks. If you intend to follow the examples in this Quick Start Guide, we recommend that you use a Linux distribution that includes ZBD support. More information on recommended Linux distributions can be found here.
ZNS SSDs require zone capacity support, which was introduced in Linux kernel version 5.9. More information on ZNS SSDs can be found here.
Advanced users might want to compile and install a specific Linux kernel version instead of using the default kernel. If this is the case, you must enable ZBD support in that kernel. An explanation of how to enable ZBD support in the kernel configuration is provided here. We recommend that you always use the highest available stable kernel version or a long term stable kernel version higher than 4.10. Information on available kernel versions can be found here.
Two conditions must be met to ensure that a system's Linux kernel supports the ZBD interface.
The kernel version must be 4.10.0 or higher,
The kernel compilation configuration option CONFIG_BLK_DEV_ZONED must be enabled.
uname makes it possible to check the version of the
kernel running on a system. For example, on a Fedora 29
distribution, this command and its output is as follows.
Zoned block device support might not be enabled by default in the
running kernel. The kernel configuration option that is used to enable
zoned block device support is
There are several methods that can be used to determine whether the
CONFIG_BLK_DEV_ZONED option has been enabled in the kernel. Not all
of these methods work for every Linux distribution. In some
distributions, the configuration file for the running kernel can be
found in the
/boot directory or in the directory containing the
The following commands test whether your installed kernel supports zoned block devices.
If the output of one of these commands is
then zoned block devices are supported by the kernel. If the output is
CONFIG_BLK_DEV_ZONED=n, then block device support is disabled and
the kernel must be recompiled in order to enable block device support.
For kernels older than kernel version 4.10, the output of these commands is always empty.
If your kernel exports its configuration through the proc file
system, use one of the following sets of commands to retreive the
By default, the Linux kernel does not guarantee the order in which
commands are delivered to a block device. This means that an
application that writes sequentially to a disk might have its write
commands delivered to the disk in a different order than the order
sent by the application. This might cause write errors if the
application is writing to a zoned device over sequential zones.
To avoid this problem, a "zone write lock mechanism" that serializes writes to sequential zones is implemented by all kernels that support zoned block devices. For kernel versions between 4.10 and 4.15 (inclusive) no special configuration is necessary and the kernel guarantees the delivery of write commands to the device in the same order as the order of write requests issued by the application.
However, in kernel version 4.16, the implementation of zone write locking was moved to the deadline and mq-deadline block I/O scheduler. Therefore, in kernels of version 4.16 and higher, you must use this scheduler with zoned block devices in order to make the kernel guarantee the order of write commands.
The mq-deadline block I/O scheduler is enabled only if the SCSI multi-queue (scsi-mq) infrastructure is enabled. This feature use can be controlled by using the kernel boot argument scsi_mod.use_blk_mq. The default has been scsi-mq since kernel version 5.0 and the legacy single-queue SCSI command path is no longer supported.
To see which block I/O scheduler a zoned disk uses, run the following command:
If the disk block I/O scheduler that has been selected is not mq-deadline as in the example above, use the following command to change the scheduler:
Various user level tools should also be installed in order to verify the correct operation of zoned block devices and to troubleshoot problems.
lsblk command in Linux lists block devices. This includes zoned block
devices. This utility is usually included in the util-linux
package, which is installed by default on most Linux distributions.
lsblk usage examples are provided here.
blkzone utility lists (reports) the zones of a zoned block device and
makes it possible to reset the write pointer position of a range of zones in
the device. This utility is usually included in the util-linux package, which
is installed by default on most Linux distributions.
blkzone usage examples are provided here.
The lsscsi command lists information about the SCSI devices connected to a Linux system. lsscsi is generally available as a package in most Linux distributions. Refer to your distribution documentation to find the name of the package that provides the lsscsi utility.
The linux utilities page provides more
lssci as well as usage examples.
The sg3_utils package is a collection of command line tools that send SCSI commands to a SCSI device.
In Linux, all disks are exposed as SCSI disks. This includes ATA
sg3_utils can be used to manage SAS ZBC disks as well as
SATA ZAC disks. When dealing with SATA disks connected to SATA ports
(for example, an AHCI adapter), the kernel ATA subsystem (libata)
translates SCSI commands into ATA commands.
sg3_utils includes three command line tools specific to ZBC disks:
|Utility Name||SCSI Command Invoked||Description|
|sg_rep_zones||REPORT ZONES||Get the ZBC disk's zone information|
|sg_reset_wp||RESET WRITE POINTER||Reset one zone or all zones of the ZBC disk|
|sg_zone||CLOSE ZONE, FINISH ZONE, OPEN ZONE||Sends one of these commands to the given ZBC disk|
This section shows some examples of these utilities execution.
libzbc is a user-space library that provides functions that are used to manipulate ZBC and ZAC disks. The libzbc project is hosted on GitHub. Documentation is provided in the project README file. The API documentation can be generated using doxygen.
libzbc provides a set of command-line utilities that are
functionally similar to both the
blkzone utility and the sg3_utils
For more information on how to compile and install libzbc, as well as usage examples of the command line utilities provided by libzbc, see libzbc User Library in the Tools and Libraries documentation.