Sponsor:

Your company here ā€” click to reach over 10,000 unique daily visitors

dmzadm - Man Page

manage zoned block device format for use with the dm-zoned device mapper target

Synopsis

dmzadm -h | --help

dmzadm --version

dmzadm operation [ regular-block-device ] zoned-block-device-0 [ zoned-block-device-1 [...] ] [ options ]

Description

dmzadm is used to format, check and repair block devices used with the dm-zoned device mapper. zoned-block-device-0 specifies the device node of the zoned block device to use (e.g. /dev/sdX).

regular-block-device is an optional device node corresponding to a regular block device to be used together with the zoned block device to store metadata and to act as the conventional zone storage space for the zoned device.

When regular-block-device is used, more than one zoned block device can be specified (zoned-block-device-1 etc). If multiple zoned block devices are specified, all devices must have the same zone size.

operation specifies the action to be taken on the device.

dmzadm returns 0 on success and 1 on failure.

Operations

dmzadm defines the following operations.

-h, ā€‰--help

Print a short usage description of dmzadm.

--version

Print the current version number and exit dmzadm.

--format

Write to the zoned block device(s) and optional regular block device dm-zoned metadata, whiping clean all data that was stored on the device(s).

--check

Check the device(s) metadata consistency. No repair action is taken. Metadata corruptions are not corrected with this operation. For repairing incorrect metadata, the --repair operation must be used.

--repair

Check the consistency of the device(s) metadata and try to repair any error detected.

--relabel

Change the label (DM device name) of a formatted dm-zoned device.

--start

Load the metadata information from the block device(s) and activate the dm-zoned device.

--stop

Deactivate the dm-zoned device associated with the block device(s).

Common Options

The following options can be used with all operations.

--verbose

Verbose output detailing actions taken.

--vverbose

Very detailed output of actions taken.

Format Operation Options

The following options can be used when the --format operation is specified.

--seq=num

Specify the number of sequential zones to be reserved for reclaim (default: 16 per zoned block device).

--label=str

Define the label of the device-mapper device. If not specified, the label defaults to dmz-serial, where serial is the serial number of the block device storing the metadata (the first block device specified). If the serial number for the metadata block device is not available, the label defaults to dmz-bdevname where bdevname is the name of the metadata block device.

Relabel Operation Options

The following options can be used when the --relabel operation is specified.

--label=str

Define the new label of the device-mapper device. If not specified, the new label defaults to dmz-serial, where serial is the serial number of the block device storing the metadata (the first block device specified). If the serial number for the metadata block device is not available, the label defaults to dmz-bdevname where bdevname is the name of the metadata block device.

Authors

This version of dmzadm was written by Damien Le Moal <damien.lemoal@wdc.com> and Albert H. Chen <albert.chen@wdc.com> with contributions from Hannes Reinecke <hare@suse.de>.

Availability

dmzadm is available from the dm-zoned-tools project hosted on github at https://github.com/westerndigitalcorporation/dm-zoned-tools

See Also

dmsetup(8)

Info

May 20 2020