huschi.net

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.14(2)-RHEL8 (2021-10-20)   BLKDEACTIVATE(8)