blkdeactivate8
Utility to deactivate block devices
Usage
blkdeactivate-
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]
Overview
The blkdeactivate utility deactivates block devices. For mounted block devices, it attempts to unmount them 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|--dmoptionsdm_options-
Comma separated list of device-mapper specific options.
Accepted dmsetup(8) options are:retry-
Retry removal several times in case of failure.
force-
Force device removal.
-e|--errors-
Show errors reported from tools called by
blkdeactivate. Without this option, any error messages from these external tools are suppressed and theblkdeactivateitself provides only a summary message to indicate the device was skipped.
-h|--help-
Display the help text.
-l|--lvmoptionslvm_options-
Comma-separated list of LVM specific options:
retry-
Retry removal several times in case of failure.
wholevg-
Deactivate the whole LVM Volume Group when processing a Logical Volume. Deactivating the Volume Group as a whole is quicker than deactivating each Logical Volume separately.
-r|--mdraidoptionsmdraid_options-
Comma-separated list of MD RAID specific options:
wait-
Wait for MD device's resync, recovery or reshape action to complete before deactivation.
-m|--mpathoptionsmpath_options-
Comma-separated list of device-mapper multipath specific options:
disablequeueing-
Disable queueing on all multipath devices before deactivation. This avoids a situation where blkdeactivate may end up waiting if all the paths are unavailable for any underlying device-mapper multipath device.
-u|--umount-
Unmount a mounted device before trying to deactivate it. Without this option, a device that is mounted is not deactivated.
-o|--vdooptionsvdo_options-
Comma-separated list of VDO specific options:
configfile=file-
Use specified VDO configuration file.
-v|--verbose-
Run in verbose mode. Use
-vvfor 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
Releases
6 releases since Debian 9 (Stretch); the text changed 5 times.
--dmoption until Debian 9 (Stretch);
--dmoptions until Debian 11 (Bullseye);
--errors until Debian 11 (Bullseye);
--help until Debian 11 (Bullseye);
--lvmoption until Debian 9 (Stretch);
--lvmoptions until Debian 11 (Bullseye);
--mdraidoptions until Debian 11 (Bullseye);
--mpathoption until Debian 9 (Stretch);
--mpathoptions until Debian 11 (Bullseye);
--umount until Debian 11 (Bullseye);
--vdooptions until Debian 11 (Bullseye);
--verbose until Debian 13 (Trixie);
-d until Debian 11 (Bullseye);
-e until Debian 11 (Bullseye);
-h until Debian 11 (Bullseye);
-l until Debian 11 (Bullseye);
-m until Debian 11 (Bullseye);
-o until Debian 11 (Bullseye);
-r until Debian 11 (Bullseye);
-u until Debian 11 (Bullseye);
-v until Debian 13 (Trixie).