blkdeactivate(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | COLOPHON

BLKDEACTIVATE(8)                                        BLKDEACTIVATE(8)

NAME         top

       blkdeactivate — utility to deactivate block devices

SYNOPSIS         top

       blkdeactivate [-d dm_options] [-e] [-h] [-l lvm_options] [-m
       mpath_options] [-r mdraid_options] [-o vdo_options] [-u] [-v]
       [device]

DESCRIPTION         top

       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-
       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         top

       -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
                     processing 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
                     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.
              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         top

       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

SEE ALSO         top

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

COLOPHON         top

       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 2023-12-22.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-12-06.)  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)