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] [-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, --dmoption 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, --lvmoption 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.

       -m, --mpathoption 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.

       -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), 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, send it to linux-lvm@redhat.com.  This page was obtained
       from the project's upstream Git repository 
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2017-04-25.  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.02.171(2)-git (2017-04-13)   BLKDEACTIVATE(8)

Pages that refer to this page: lvchange(8)lvconvert(8)lvcreate(8)lvdisplay(8)lvextend(8)lvm(8)lvmconfig(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)vgmerge(8)vgmknodes(8)vgreduce(8)vgremove(8)vgrename(8)vgs(8)vgscan(8)vgsplit(8)