~ubuntu-branches/ubuntu/saucy/lvm2/saucy

« back to all changes in this revision

Viewing changes to man/blkdeactivate.8.in

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2013-05-30 11:02:10 UTC
  • mfrom: (3.1.28 sid)
  • Revision ID: package-import@ubuntu.com-20130530110210-q8bou4f333ruwhn0
Tags: 2.02.98-1ubuntu1
* Merge from Debian unstable, remaining changes:
  - debian/patches/avoid-dev-block.patch: Prefer any other device name over
    names in /dev/block/ since lvm.conf won't handle this.
  - debian/rules:
    - copy .po file to .pot file for Rosetta (Ubuntu specific).
  - debian/{dmsetup,lvm2}-udeb.install:
    - install initramfs and udev hooks in udebs (Debian bug 504341).
  - auto-start VGs as their PVs are discovered (Ubuntu specific):
    - add debian/tree/lvm2/lib/udev/rules.d/85-lvm2.rules: use watershed plus
      the sledgehammer of vgscan/vgchange to turn on VGs as they come online.
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/hooks/lvm2:
      - add 85-lvm2.rules to the list of udev rules to copy.
      - depend on udev.
    - debian/control:
      - add versioned Depend on watershed in lvm2 for udev rules.
      - add Depends on watershed-udeb in lvm2-udeb for udev rules.
      - add versioned Depend/Breaks on udev in dmsetup for udev rules.
      - add Depend on initramfs-tools in dmsetup so system is not potentially
        rendered unbootable by out-of-order dpkg configuration.
      - In libdevmapper-event1.02.1 add Breaks: dmeventd
        (<< 2.02.95-4ubuntu1) due to debian symbol rename
    - debian/rules:
      - do not install local-top scripts since Ubuntu mounts root using udev.
      - do not install init scripts for lvm2, since udev starts LVM.
      - continue to build clvm support.
    - debian/lvm2.postinst: handle missing lvm2 init script.
    - debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules:
      watch dm devices for changes with inotify
  - add mountroot failure hooks to help fix bad boots (Debian bug 468115):
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/init-premount/lvm2
  - remaining changes to upstream event manager packages (Debian bug 514706):
    - debian/rules:
      - enable dmeventd during configure.
    - debian/dmeventd.{8,manpages}: install dmeventd files.
  - rename debian/clvm.defaults to debian/clvm.default so it is installed
    correctly.
  - debian/control: add dmsetup-udeb to libdevmapper1.02.1-udeb recommends.
  - debian/rules: make sure dmsetup and lvm2 initramfs-tools scripts are
    executable.  When the Ubuntu-specific ones are added with a patch,
    they may lose their executable bit.
  - Add and install clvmd resource agent
  - Add dependency on libudev-dev to libdevmapper-dev so that the .pc file
    works.
  - debian/{clvmd.ra,clvm.init}:
    - create /run/lvm if it doesn't exist.
  - debian/clvm.init:
    - exit 3 if not running on status action.
  - Call dh_installman so that our dmeventd manpage actually gets installed
  - Install the missing fsadm manpage.
  - Complete libdevmapper-dev multiarch:
    - move .so symlinks and pkgconfig files to multiarched locations.
    - mark libdevmapper-dev M-A: same

* Dropped changes, applied upstream:
  - Update Micron PCIe SSD and other device-types to latest available.
  - Cherry pick from upstream, remove unsupported udev_get_dev_path() call.
  - Move thin check to global section.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH "BLKDEACTIVATE" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
 
2
.SH "NAME"
 
3
blkdeactivate \- utility to deactivate block devices
 
4
.SH SYNOPSIS
 
5
.B blkdeactivate
 
6
.RI [ options ]
 
7
.RI [ device... ]
 
8
.sp
 
9
.SH DESCRIPTION
 
10
blkdeactivate utility deactivates block devices. If a device
 
11
is mounted, the utility can unmount it automatically before
 
12
trying to deactivate. The utility currently supports
 
13
\fIdevice-mapper\fP devices, including \fILVM\fP volumes.
 
14
LVM volumes are handled directly using the \fIlvm\fP command.
 
15
Other device-mapper based devices are handled using the
 
16
\fIdmsetup\fP command.
 
17
.SH OPTIONS
 
18
.IP "\fB\-h, \-\-help\fP"
 
19
Display the help text.
 
20
.IP "\fB\-u, \-\-umount\fP"
 
21
Unmount a mounted device before trying to deactivate it.
 
22
Without this option used, a device that is mounted is not deactivated.
 
23
.IP "\fB\-d, \-\-dmoption\fP \fIdm_options\fP"
 
24
Comma separated list of device-mapper specific options.
 
25
.IP "\fB\-l, \-\-lvmoption\fP \fIlvm_options\fP"
 
26
Comma separated list of LVM specific options.
 
27
.SH DM_OPTIONS
 
28
.IP "\fBretry\fP"
 
29
Retry removal several times in case of failure.
 
30
.IP "\fBforce\fP"
 
31
Force device removal. See \fBdmsetup\fP(8) for more information.
 
32
.SH LVM_OPTIONS
 
33
.IP "\fBretry\fP"
 
34
Retry removal several times in case of failure.
 
35
.IP "\fBwholevg\fP"
 
36
Deactivate the whole LVM Volume Group when processing a Logical Volume.
 
37
Deactivating Volume Group as a whole takes less time than deactivating
 
38
each Logical Volume separately.
 
39
 
 
40
.SH EXAMPLES
 
41
.sp
 
42
Deactivate all supported block devices found in the system. If a device
 
43
is mounted, skip its deactivation.
 
44
.sp
 
45
.B blkdeactivate
 
46
 
 
47
Deactivate all supported block devices found in the system. If a device
 
48
is mounted, unmount it first if possible.
 
49
.sp
 
50
.B blkdeactivate \-u
 
51
 
 
52
Deactivate supplied device together with all its holders. If any of the
 
53
devices processed is mounted, unmount it first if possible.
 
54
.sp
 
55
.B blkdeactivate \-u /dev/vg/lvol0
 
56
 
 
57
Deactivate all supported block devices found in the system. Retry deactivation
 
58
of device-mapper devices in case the deactivation fails. Deactivate the whole
 
59
Volume Group at once when processing an LVM Logical Volume.
 
60
.sp
 
61
.B blkdeactivate \-u -d retry -l wholevg
 
62
 
 
63
Deactivate all supported block devices found in the system. Retry deactivation
 
64
of device-mapper devices in case the deactivation fails and force removal.
 
65
.sp
 
66
.B blkdeactivate -d force,retry
 
67
 
 
68
.SH SEE ALSO
 
69
.BR lsblk (8)
 
70
.BR umount (8)
 
71
.BR dmsetup (8)
 
72
.BR lvm (8)