207 lines
5.4 KiB
HTML
207 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of BLKDEACTIVATE</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>BLKDEACTIVATE</H1>
|
|
Section: (8)<BR>Updated: LVM TOOLS <A HREF="/cgi-bin/man/man2html?2+2.03.07">2.03.07</A>(2) (2019-11-30)<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
blkdeactivate --- utility to deactivate block devices
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>blkdeactivate</B>
|
|
|
|
[<B>-d</B> <B></B><I>dm_options</I>]
|
|
|
|
[<B>-e</B>]
|
|
|
|
[<B>-h</B>]
|
|
|
|
[<B>-l</B> <B></B><I>lvm_options</I>]
|
|
|
|
[<B>-m</B> <B></B><I>mpath_options</I>]
|
|
|
|
[<B>-r</B> <B></B><I>mdraid_options</I>]
|
|
|
|
[<B>-u</B>]
|
|
|
|
[<B>-v</B>]
|
|
|
|
[<I>device</I>]
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
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 <B><A HREF="/cgi-bin/man/man2html?8+lvm">lvm</A></B>(8) command, the rest of device-mapper
|
|
based devices are handled using the <B><A HREF="/cgi-bin/man/man2html?8+dmsetup">dmsetup</A></B>(8) command.
|
|
MD devices are handled using the <B><A HREF="/cgi-bin/man/man2html?8+mdadm">mdadm</A></B>(8) command.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--dmoptions</B> <I>dm_options</I>
|
|
|
|
<DD>
|
|
Comma separated list of device-mapper specific options.
|
|
Accepted <B><A HREF="/cgi-bin/man/man2html?8+dmsetup">dmsetup</A></B>(8) options are:
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<DL COMPACT>
|
|
<DT id="3"><I>retry</I><DD>
|
|
Retry removal several times in case of failure.
|
|
<DT id="4"><I>force</I><DD>
|
|
Force device removal.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="5"><B>-e</B>, <B>--errors</B>
|
|
|
|
<DD>
|
|
Show errors reported from tools called by <B>blkdeactivate</B>. Without this
|
|
option, any error messages from these external tools are suppressed and the
|
|
<B>blkdeactivate</B> itself provides only a summary message to indicate
|
|
the device was skipped.
|
|
<DT id="6"><B>-h</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Display the help text.
|
|
<DT id="7"><B>-l</B>, <B>--lvmoptions</B> <I>lvm_options</I>
|
|
|
|
<DD>
|
|
Comma-separated list of LVM specific options:
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<DL COMPACT>
|
|
<DT id="9"><I>retry</I><DD>
|
|
Retry removal several times in case of failure.
|
|
<DT id="10"><I>wholevg</I><DD>
|
|
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.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="11"><B>-m</B>, <B>--mpathoptions</B> <I>mpath_options</I>
|
|
|
|
<DD>
|
|
Comma-separated list of device-mapper multipath specific options:
|
|
<DL COMPACT><DT id="12"><DD>
|
|
<DL COMPACT>
|
|
<DT id="13"><I>disablequeueing</I><DD>
|
|
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.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="14"><B>-r</B>, <B>--mdraidoptions</B> <I>mdraid_options</I>
|
|
|
|
<DD>
|
|
Comma-separated list of MD RAID specific options:
|
|
<DL COMPACT><DT id="15"><DD>
|
|
<DL COMPACT>
|
|
<DT id="16"><I>wait</I><DD>
|
|
Wait MD device's resync, recovery or reshape action to complete
|
|
before deactivation.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="17"><B>-u</B>, <B>--umount</B>
|
|
|
|
<DD>
|
|
Unmount a mounted device before trying to deactivate it.
|
|
Without this option used, a device that is mounted is not deactivated.
|
|
<DT id="18"><B>-v</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Run in verbose mode. Use --vv for even more verbose mode.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
Deactivate all supported block devices found in the system, skipping mounted
|
|
devices.
|
|
|
|
#
|
|
<B>blkdeactivate</B>
|
|
|
|
|
|
<P>
|
|
|
|
Deactivate all supported block devices found in the system, unmounting any
|
|
mounted devices first, if possible.
|
|
|
|
#
|
|
<B>blkdeactivate -u</B>
|
|
|
|
|
|
<P>
|
|
|
|
Deactivate the device /dev/vg/lvol0 together with all its holders, unmounting
|
|
any mounted devices first, if possible.
|
|
|
|
#
|
|
<B>blkdeactivate -u /dev/vg/lvol0</B>
|
|
|
|
|
|
<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.
|
|
|
|
#
|
|
<B>blkdeactivate -u -d retry -l wholevg</B>
|
|
|
|
|
|
<P>
|
|
|
|
Deactivate all supported block devices found in the system. If the deactivation
|
|
of a device-mapper device fails, retry it and force removal.
|
|
|
|
#
|
|
<B>blkdeactivate -d force,retry</B>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+dmsetup">dmsetup</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+lsblk">lsblk</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+lvm">lvm</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mdadm">mdadm</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+multipathd">multipathd</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+umount">umount</A></B>(8)
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="19"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="20"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="21"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="23"><A HREF="#lbAF">EXAMPLES</A><DD>
|
|
<DT id="24"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|