blkdeactivate(8) — Linux manual page

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 deactivate. The utility currently supports device-map‐
       per devices (DM), including LVM volumes and software RAID MD  de‐
       vices. 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 exter‐
              nal tools are suppressed and the blkdeactivate itself pro‐
              vides 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
                     deactivation.  This avoids a situation where blkde‐
                     activate may end up waiting if all the paths are
                     unavailable for any underlying device-mapper multi‐
                     path 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 hold‐
       ers, 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. Deac‐
       tivate the whole Volume Group at once when processing an LVM Log‐
       ical 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

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

COLOPHON

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for
       this manual page, see ⟨https://github.com/lvmteam/lvm2/issues⟩.
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Red Hat, Inc      LVM TOOLS 2.03.15(2)-git (2021-10-20) BLKDEACTIVATE(8)

Pages that refer to this page: lvchange(8), lvconvert(8), lvcreate(8), lvdisplay(8), lvextend(8), lvm(8), lvmconfig(8), lvmdevices(8), lvmdiskscan(8), lvm-fullreport(8), lvm-lvpoll(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8), pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8), vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgconvert(8), vgcreate(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8)

---