BLKDEACTIVATE(8)                                              BLKDEACTIVATE(8)

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 trying to deac‐
       tivate. The utility currently supports device‐mapper devices (DM),  in‐
       cluding  LVM volumes and software RAID MD devices. LVM volumes are han‐
       dled directly using the lvm(8) command, the rest of device‐mapper based
       devices are handled using the dmsetup(8) command.  MD devices are  han‐
       dled using the mdadm(8) command.

OPTIONS
       -d|--dmoptions dm_options
              Comma separated list of device‐mapper specific options.  Accept‐
              ed 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 processing a
                     Logical Volume.  Deactivating the Volume Group as a whole
                     is quicker than deactivating each  Logical  Volume  sepa‐
                     rately.

       -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  op‐
              tions:

              disablequeueing
                     Disable  queueing on all multipath devices before deacti‐
                     vation.  This avoids a situation where blkdeactivate  may
                     end  up  waiting if all the paths are unavailable 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.   With‐
              out this option used, a device that is mounted is not deactivat‐
              ed.

       -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, un‐
       mounting any mounted devices first, if possible.
       # blkdeactivate -u /dev/vg/lvol0

       Deactivate all supported block devices found in the system. If the  de‐
       activation  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  de‐
       activation of a device‐mapper device fails, retry it and force removal.
       # blkdeactivate -d force,retry

SEE ALSO
       dmsetup(8), lsblk(8), lvm(8), mdadm(8), multipathd(8), vdo(8),
       umount(8)

Red Hat, Inc           LVM TOOLS 2.03.21(2) (2023‐04‐21)      BLKDEACTIVATE(8)