1BLKDEACTIVATE(8)                                              BLKDEACTIVATE(8)
2
3
4

NAME

6       blkdeactivate — utility to deactivate block devices
7

SYNOPSIS

9       blkdeactivate     [-d dm_options]     [-e]     [-h]    [-l lvm_options]
10       [-m mpath_options] [-u] [-v] [device]
11

DESCRIPTION

13       blkdeactivate  utility  deactivates  block  devices.  If  a  device  is
14       mounted,  the  utility  can  unmount  it automatically before trying to
15       deactivate. The utility currently supports device-mapper devices  (DM),
16       including  LVM  volumes  and  software RAID MD devices. LVM volumes are
17       handled directly using the lvm(8) command, the  rest  of  device-mapper
18       based devices are handled using the dmsetup(8) command.  MD devices are
19       handled using the mdadm(8) command.
20

OPTIONS

22       -d, --dmoption dm_options
23              Comma  separated  list  of   device-mapper   specific   options.
24              Accepted dmsetup(8) options are:
25
26              retry  Retry removal several times in case of failure.
27
28              force  Force device removal.
29
30       -e, --errors
31              Show errors reported from tools called by blkdeactivate. Without
32              this option, any error messages from these  external  tools  are
33              suppressed  and the blkdeactivate itself provides only a summary
34              message about device being skipped or not.
35
36       -h, --help
37              Display the help text.
38
39       -l, --lvmoption lvm_options
40              Comma separated list of LVM specific options:
41
42              retry  Retry removal several times in case of failure.
43
44              wholevg
45                     Deactivate the whole LVM Volume Group when  processing  a
46                     Logical  Volume.   Deactivating  Volume  Group as a whole
47                     takes less time than  deactivating  each  Logical  Volume
48                     separately.
49
50       -m, --mpathoption mpath_options
51              Comma   separated   list  of  device-mapper  multipath  specific
52              options:
53
54              disablequeueing
55                     Disable queueing on all multipath  devices  first  before
56                     deactivation.   This  avoids a situation where blkdeacti‐
57                     vate may end up waiting if all paths are unavailable  for
58                     any underlying device-mapper multipath device.
59
60       -u, --umount
61              Unmount  a mounted device before trying to deactivate it.  With‐
62              out this option used, a device that is mounted  is  not  deacti‐
63              vated.
64
65       -v, --verbose
66              Run in verbose mode. Use --vv for even more verbose mode.
67

EXAMPLES

69       Deactivate all supported block devices found in the system. If a device
70       is mounted, skip its deactivation.
71
72       blkdeactivate
73
74       Deactivate all supported block devices found in the system. If a device
75       is mounted, unmount it first if possible.
76
77       blkdeactivate -u
78
79       Deactivate supplied device together with all its holders. If any of the
80       devices processed is mounted, unmount it first if possible.
81
82       blkdeactivate -u /dev/vg/lvol0
83
84       Deactivate all supported block devices found in the system. Retry deac‐
85       tivation of device-mapper devices in case the deactivation fails. Deac‐
86       tivate the whole Volume Group at once when processing  an  LVM  Logical
87       Volume.
88
89       blkdeactivate -u -d retry -l wholevg
90
91       Deactivate all supported block devices found in the system. Retry deac‐
92       tivation of device-mapper devices in case the  deactivation  fails  and
93       force removal.
94
95       blkdeactivate -d force,retry
96
97

SEE ALSO

99       dmsetup(8), lsblk(8), lvm(8), mdadm(8), multipathd(8), umount(8)
100
101
102
103Red Hat, Inc       LVM TOOLS 2.02.143(2)-RHEL6 (2016-12-13)   BLKDEACTIVATE(8)