NAME¶

zbc_write_zone - Write sectors to a zone of a ZBC or ZAC device

SYNOPSIS¶

zbc_write_zone [options] device zone_number IO_size

DESCRIPTION¶

zbc_write_zone is used to write sectors to a zone of a ZBC or ZAC device. By default, the target zone will be written starting from the first sector of the zone for conventional zones and from the zone write pointer position for sequential zones. The default behavior is to write up to the last sector of the target zone.

The device argument must be the pathname to the target device block device file (e.g., /dev/sdb), or to the target device SG node file (e.g., /dev/sg3). On old kernels lacking ZBC and ZAC support, only the device SG node file will be available. The target device may also be a regular block device set to emulate zones with the zbc_set_zones utility.

OPTIONS¶

The following options can be specified.

-h, --help

Display a usage help message and exit.

-v

Verbose mode (for debugging problems).

-dio

Use direct IO operations.

-vio num

Use vectored I/Os with num buffers of IO_size bytes, resulting in an actual I/O size of num x IO_size bytes.

-nio num

Limit the number of I/O executed to num.

-p num

Set the byte values to write to num. If this option is not used, zeroes are written to the target zone.

-f file

Write the content of file to the target zone.

-loop

If a file is specified with the option -f, repeatedly write the content of the file to the zone until the zone is full.

-ofst ofst

Write the target zone starting from the sector offset ofst instead of from the start of the zone. This option should be used only with conventional zones.

AUTHOR¶

Damien Le Moal <damien.lemoal@wdc.com>

SEE ALSO¶

sg_dd(8)

AVAILABILITY¶

The zbc_write_zone utility is part of the libzbc library available from https://github.com/westerndigitalcorporation/libzbc.