shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-22 17:35:59 +03:00
Code Releases Activity
95df06d721
lvm2/man/blkdeactivate.8.in

90 lines
2.7 KiB
Groff
Raw Normal View History

scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
.TH "BLKDEACTIVATE" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
.SH "NAME"
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
blkdeactivate \(em utility to deactivate block devices
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
.SH SYNOPSIS
.B blkdeactivate
.RI [ options ]
.RI [ device... ]
.sp
.SH DESCRIPTION
blkdeactivate utility deactivates block devices. If a device
is mounted, the utility can unmount it automatically before
trying to deactivate. The utility currently supports
\fIdevice-mapper\fP devices, including \fILVM\fP volumes.
LVM volumes are handled directly using the \fIlvm\fP command.
Other device-mapper based devices are handled using the
\fIdmsetup\fP command.
.SH OPTIONS
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-e ", " \-\-errors
blkdeactivate: change the way blkdeactivate reports status The blkdeactivate now suppresses error messages from external tools that are called. Instead, only a summary message "done" or "skipped" is issued by blkdeactivate as any error in calling the external tool (e.g. unmounting or deactivating a device) causes the device to be skipped and the blkdeactivate continues with the next device in the tree. Add new -e/--errors switch to display any error messages from external tools. Also, suppress any output given by the external tools and add new -v/--verbose switch to display it including the verbose output of the tools called (this will enable error reporting as well). Also add blkdeactivate -vv for even more debug (the script's debug).
2013-08-13 19:17:25 +04:00
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.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-h ", " \-\-help
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Display the help text.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-u ", " \-\-umount
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Unmount a mounted device before trying to deactivate it.
Without this option used, a device that is mounted is not deactivated.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-v ", " \-\-verbose
blkdeactivate: change the way blkdeactivate reports status The blkdeactivate now suppresses error messages from external tools that are called. Instead, only a summary message "done" or "skipped" is issued by blkdeactivate as any error in calling the external tool (e.g. unmounting or deactivating a device) causes the device to be skipped and the blkdeactivate continues with the next device in the tree. Add new -e/--errors switch to display any error messages from external tools. Also, suppress any output given by the external tools and add new -v/--verbose switch to display it including the verbose output of the tools called (this will enable error reporting as well). Also add blkdeactivate -vv for even more debug (the script's debug).
2013-08-13 19:17:25 +04:00
Run in verbose mode.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-d ", " \-\-dmoption " " \fIdm_options
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Comma separated list of device-mapper specific options.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.BR \-l ", " \-\-lvmoption " " \fIlvm_options
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Comma separated list of LVM specific options.
.SH DM_OPTIONS
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.B retry
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Retry removal several times in case of failure.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.B force
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Force device removal. See \fBdmsetup\fP(8) for more information.
.SH LVM_OPTIONS
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.B retry
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Retry removal several times in case of failure.
man: more compliant
2014-06-10 21:32:39 +04:00
.TP
.B wholevg
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
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.
.SH EXAMPLES
.sp
Deactivate all supported block devices found in the system. If a device
is mounted, skip its deactivation.
.sp
.B blkdeactivate
Deactivate all supported block devices found in the system. If a device
is mounted, unmount it first if possible.
.sp
.B blkdeactivate \-u
Deactivate supplied device together with all its holders. If any of the
devices processed is mounted, unmount it first if possible.
.sp
.B 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.
.sp
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
.B blkdeactivate \-u \-d retry \-l wholevg
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
Deactivate all supported block devices found in the system. Retry deactivation
of device-mapper devices in case the deactivation fails and force removal.
.sp
man: properly escape - Dash should be using '\' to be typographically correct.
2014-06-11 13:06:30 +04:00
.B blkdeactivate \-d force,retry
scripts: introduce blkdeactivate blkdeactivate - utility to deactivate block devices Traverses the tree of block devices and tries to deactivate them. Currently, it supports device-mapper-based devices together with LVM. See man/blkdeactivate.8 for more info. It is targeted for use during shutdown to properly deactivate the whole block device stack - systemd and init scripts are provided as well. However, it might be used directly on command line too. Please, see the commentary at the top of the blkdeactivate script for dependencies and versions of other utilities required.
2012-10-12 16:37:57 +04:00
.SH SEE ALSO
.BR lsblk (8)
.BR umount (8)
.BR dmsetup (8)
.BR lvm (8)
Copy Permalink