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

       blkdeactivate utility deactivates block devices. If a device is
       mounted, the utility can 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 about device being skipped or not.

       -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 Volume Group as a whole
                     takes less time 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 first before
                     deactivation.  This avoids a situation where
                     blkdeactivate may end up waiting if all 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. If a
       device is mounted, skip its deactivation.

       blkdeactivate

       Deactivate all supported block devices found in the system. If a
       device is mounted, unmount it first if possible.

       blkdeactivate -u

       Deactivate supplied device together with all its holders. If any of
       the devices processed is mounted, unmount it first if possible.

       blkdeactivate -u /dev/vg/lvol0

       Deactivate all supported block devices found in the system. Retry
       deactivation of device-mapper devices in case the deactivation fails.
       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. Retry
       deactivation of device-mapper devices in case the deactivation fails
       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 
       ⟨https://git.fedorahosted.org/git/lvm2.git⟩ on 2017-03-13.  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.169(2)-git (2016-11-30)   BLKDEACTIVATE(8)