# blkdeactivate

## NAME



           blkdeactivate — utility to deactivate block devices
    


## SYNOPSIS



           **blkdeactivate**[**-d** _dm_options_] [**-e**] [**-h**] [**-l** _lvm_options_] [**-m**
           _mpath_options_] [**-r** _mdraid_options_] [**-o** _vdo_options_] [**-u**] [**-v**]
           [_device_]
    


## DESCRIPTION



           The  blkdeactivate  utility deactivates block devices. For mounted
           block devices, it attempts to unmount it automatically before try‐
           ing 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:
    
                  **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 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:
    
                  **retry** Retry removal several times in case of failure.
    
                  **wholevg**
                         Deactivate the whole LVM Volume Group when process‐
                         ing a Logical Volume.  Deactivating the Volume Group
                         as a whole is quicker than deactivating each Logical
                         Volume separately.
    
           **-r** |**--mdraidoptions** _mdraid_options_
                  Comma-separated list of MD RAID specific options:
    
                  **wait** Wait MD device's resync, recovery or reshape action
                         to complete before deactivation.
    
           **-m** |**--mpathoptions** _mpath_options_
                  Comma-separated list of device-mapper multipath specific
                  options:
    
                  **disablequeueing**
                         Disable queueing on all multipath devices before de‐
                         activation.  This avoids a situation where blkdeac‐
                         tivate may end up waiting if all the paths are un‐
                         available for any underlying device-mapper multipath
                         device.
    
           **-o** |**--vdooptions** _vdo_options_
                  Comma-separated list of VDO specific options:
    
                  **configfile** =_file_
                         Use specified VDO configuration file.
    
           **-u** |**--umount**
                  Unmount a mounted device before trying to deactivate it.
                  Without this option used, a device that is mounted is not
                  deactivated.
    
           **-v** , **--verbose**
                  Run in verbose mode. Use **-vv** for even more verbose mode.
    


## EXAMPLES



           Deactivate all supported block devices found in the system, skip‐
           ping mounted devices.
           # **blkdeactivate**
    
           Deactivate all supported block devices found in the system, un‐
           mounting 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 Vol‐
           ume.
           # **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**
    


* * *