NAME

blkdeactivate — utility to deactivate block devices

SYNOPSIS

blkdeactivate

[-d|--dmoptions dm_options] [-e|--errors] [-h|--help] [-l|--lvmoptions lvm_options] [-r|--mdraidoptions mdraid_options] [-m|--mpathoptions mpath_options] [-u|--umount] [-o|--vdooptions vdo_options] [-v|--verbose] [device]

DESCRIPTION

The blkdeactivate utility deactivates block devices. For mounted block devices, it attempts to unmount it automatically before trying to deactivate. The utility currently supports device-mapper devices (DM), including LVM volumes and software RAID MD devices. LVM volumes are handled directly using the lvm(8) command, the rest of device-mapper based devices are handled using the dmsetup(8) command. MD devices are handled using the mdadm(8) command.

OPTIONS

-d|--dmoptions dm_options

Comma separated list of device-mapper specific options.
Accepted dmsetup(8) options are:

-e|--errors

Show errors reported from tools called by blkdeactivate. Without this option, any error messages from these external tools are suppressed and the blkdeactivate itself provides only a summary message to indicate the device was skipped.

-h|--help

Display the help text.

-l|--lvmoptions lvm_options

Comma-separated list of LVM specific options:

-r|--mdraidoptions mdraid_options

Comma-separated list of MD RAID specific options:

-m|--mpathoptions mpath_options

Comma-separated list of device-mapper multipath specific options:

-u|--umount

Unmount a mounted device before trying to deactivate it. Without this option used, a device that is mounted is not deactivated.

-o|--vdooptions vdo_options

Comma-separated list of VDO specific options:

-v|--verbose

Run in verbose mode. Use -vv for even more verbose mode.

EXAMPLES

Deactivate all supported block devices found in the system, skipping mounted devices.
blkdeactivate

Deactivate all supported block devices found in the system, unmounting any mounted devices first, if possible.
blkdeactivate -u

Deactivate the device /dev/vg/lvol0 together with all its holders, unmounting any mounted devices first, if possible.
blkdeactivate -u /dev/vg/lvol0

Deactivate all supported block devices found in the system. If the deactivation of a device-mapper device fails, retry it. Deactivate the whole Volume Group at once when processing an LVM Logical Volume.
blkdeactivate -u -d retry -l wholevg

Deactivate all supported block devices found in the system. If the deactivation of a device-mapper device fails, retry it and force removal.
blkdeactivate -d force,retry

SEE ALSO

lvm(8),

dmsetup(8),

lsblk(8), mdadm(8), multipathd(8), vdo(8), umount(8)