mirror of
git://sourceware.org/git/lvm2.git
synced 2025-10-29 16:23:49 +03:00
296fcd4c79
Drop misplaced letter 'I'.
Missing articles (a, an, the)
Incorrect prepositions (in/into, to/in)
Subject-verb agreement errors.
Awkward phrasing that needs smoothing.
Fixed prepositions ("prior to" instead of "prior the")
Corrected subject-verb agreement ("are becoming" instead of "is becoming")
Fixed word choices ("represents" instead of "presents")
Used consistent terminology ("environment" instead of "environmental")
Fixed pronoun references ("them" instead of "it" when referring to plural subjects)
Originated-by: warp-terminal
196 lines
4.0 KiB
Plaintext
196 lines
4.0 KiB
Plaintext
.TH "BLKDEACTIVATE" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc." \" -*- nroff -*-
|
|
.
|
|
.de NSY
|
|
. ie t .SY \\$1
|
|
. el \{\
|
|
. ie \\n(.$>1 \{\
|
|
. PD 0
|
|
. TP \\w'\\$1\ 'u
|
|
. \}
|
|
. el .TP
|
|
. B \\$1
|
|
. nh
|
|
. na
|
|
. \}
|
|
..
|
|
.
|
|
.SH NAME
|
|
.
|
|
blkdeactivate \(em utility to deactivate block devices
|
|
.
|
|
.SH SYNOPSIS
|
|
.
|
|
.NSY blkdeactivate 1
|
|
.RB [ -d | --dmoptions\ \c
|
|
.IR dm_options ]
|
|
.RB [ -e | --errors ]
|
|
.RB [ -h | --help ]
|
|
.RB [ -l | --lvmoptions\ \c
|
|
.IR lvm_options ]
|
|
.RB [ -r | --mdraidoptions\ \c
|
|
.IR mdraid_options ]
|
|
.RB [ -m | --mpathoptions\ \c
|
|
.IR mpath_options ]
|
|
.RB [ -u | --umount ]
|
|
.RB [ -o | --vdooptions\ \c
|
|
.IR vdo_options ]
|
|
.RB [ -v | --verbose ]
|
|
.RI [ device ]
|
|
.
|
|
.PD
|
|
.ad
|
|
.hy
|
|
.
|
|
.SH DESCRIPTION
|
|
.
|
|
The blkdeactivate utility deactivates block devices. For mounted
|
|
block devices, it attempts to unmount them 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 \fBlvm\fP(8) command, the rest of device-mapper
|
|
based devices are handled using the \fBdmsetup\fP(8) command.
|
|
MD devices are handled using the \fBmdadm\fP(8) command.
|
|
.
|
|
.SH OPTIONS
|
|
.
|
|
.TP
|
|
\fB-d\fP|\fB--dmoptions\fP \fIdm_options\fP
|
|
Comma separated list of device-mapper specific options.
|
|
.br
|
|
Accepted
|
|
.BR dmsetup (8)
|
|
options are:
|
|
.
|
|
.RS
|
|
.
|
|
.TP
|
|
.B retry
|
|
Retry removal several times in case of failure.
|
|
.
|
|
.TP
|
|
.B force
|
|
Force device removal.
|
|
.
|
|
.RE
|
|
.
|
|
.TP
|
|
.BR -e | --errors
|
|
Show errors reported from tools called by \fBblkdeactivate\fP. Without this
|
|
option, any error messages from these external tools are suppressed and the
|
|
\fBblkdeactivate\fP itself provides only a summary message to indicate
|
|
the device was skipped.
|
|
.
|
|
.TP
|
|
.BR -h | --help
|
|
Display the help text.
|
|
.
|
|
.TP
|
|
\fB-l\fP|\fB--lvmoptions\fP \fIlvm_options\fP
|
|
Comma-separated list of LVM specific options:
|
|
.RS
|
|
.
|
|
.TP
|
|
.B retry
|
|
Retry removal several times in case of failure.
|
|
.
|
|
.TP
|
|
.B 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.
|
|
.RE
|
|
.
|
|
.TP
|
|
\fB-r\fP|\fB--mdraidoptions\fP \fImdraid_options\fP
|
|
Comma-separated list of MD RAID specific options:
|
|
.
|
|
.RS
|
|
.
|
|
.TP
|
|
.B wait
|
|
Wait for MD device's resync, recovery or reshape action to complete
|
|
before deactivation.
|
|
.
|
|
.RE
|
|
.
|
|
.TP
|
|
\fB-m\fP|\fB--mpathoptions\fP \fImpath_options\fP
|
|
Comma-separated list of device-mapper multipath specific options:
|
|
.
|
|
.RS
|
|
.
|
|
.TP
|
|
.B 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.
|
|
.
|
|
.RE
|
|
.
|
|
.TP
|
|
.BR -u | --umount
|
|
Unmount a mounted device before trying to deactivate it.
|
|
Without this option used, a device that is mounted is not deactivated.
|
|
.
|
|
.TP
|
|
\fB-o\fP|\fB--vdooptions\fP \fIvdo_options\fP
|
|
Comma-separated list of VDO specific options:
|
|
.
|
|
.RS
|
|
.
|
|
.TP
|
|
\fBconfigfile\fP=\fIfile\fP
|
|
Use specified VDO configuration file.
|
|
.
|
|
.RE
|
|
.
|
|
.TP
|
|
.BR -v | --verbose
|
|
Run in verbose mode. Use \fB-vv\fP for even more verbose mode.
|
|
.
|
|
.SH EXAMPLES
|
|
.
|
|
Deactivate all supported block devices found in the system, skipping mounted
|
|
devices.
|
|
.br
|
|
.B blkdeactivate
|
|
.P
|
|
Deactivate all supported block devices found in the system, unmounting any
|
|
mounted devices first, if possible.
|
|
.br
|
|
.B blkdeactivate -u
|
|
.P
|
|
Deactivate the device /dev/vg/lvol0 together with all its holders, unmounting
|
|
any mounted devices first, if possible.
|
|
.br
|
|
.na
|
|
.B blkdeactivate -u /dev/vg/lvol0
|
|
.P
|
|
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.
|
|
.br
|
|
.na
|
|
.B blkdeactivate -u -d retry -l wholevg
|
|
.P
|
|
Deactivate all supported block devices found in the system. If the deactivation
|
|
of a device-mapper device fails, retry it and force removal.
|
|
.br
|
|
.B blkdeactivate -d force,retry
|
|
.
|
|
.SH SEE ALSO
|
|
.
|
|
.nh
|
|
.na
|
|
.BR lvm (8),
|
|
.P
|
|
.BR dmsetup (8),
|
|
.P
|
|
.BR lsblk (8),
|
|
.BR mdadm (8),
|
|
.BR multipathd (8),
|
|
.BR vdo (8),
|
|
.BR umount (8)
|