mirror of
git://sourceware.org/git/lvm2.git
synced 2024-10-28 03:27:58 +03:00
8dbe767340
If pvscan is run with device path instead of major:minor pair and this device still exists in the system and the device is not visible anymore (due to a filter that is applied), notify lvmetad properly about this. This makes it more consistent with respect to existing pvscan with major:minor which already notifies lvmetad about device that is gone due to filters. However, if the device is not in the system anymore, we're not able to translate the original device path into major:minor pair which lvmetad needs for its action (lvmetad_pv_gone fn). So in this case, we still need to use major:minor pair only, not device path. But at least make "pvscan --cache DevicePath" as near as possible to "pvscan --cahce <major>:<minor>" functionality. Also add a note to pvscan man page about this difference when using pvscan --cache with DevicePath and major:minor pair.
83 lines
2.9 KiB
Groff
83 lines
2.9 KiB
Groff
.TH PVSCAN 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
pvscan \(em scan all disks for physical volumes
|
|
.SH SYNOPSIS
|
|
.B pvscan
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-\-help ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RB [ \-\-ignorelockingfailure ]
|
|
.RB [ \-e | \-\-exported ]
|
|
.RB [ \-n | \-\-novolumegroup ]
|
|
.RB [ \-s | \-\-short ]
|
|
.RB [ \-u | \-\-uuid ]
|
|
.BR
|
|
|
|
.B pvscan
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-\-help ]
|
|
.B \-\-cache
|
|
.RB [ \-a | \-\-activate " " \fIay ]
|
|
.RB [ \-b | \-\-background ]
|
|
.RB [ \-\-major
|
|
.I major
|
|
.B \-\-minor
|
|
.I minor
|
|
|
|
|
.IR DevicePath
|
|
|
|
|
.IR major:minor ]...
|
|
.SH DESCRIPTION
|
|
pvscan scans all supported LVM block devices in the system for
|
|
physical volumes.
|
|
.SH OPTIONS
|
|
See \fBlvm\fP(8) for common options.
|
|
.TP
|
|
.BR \-e ", " \-\-exported
|
|
Only show physical volumes belonging to exported volume groups.
|
|
.TP
|
|
.BR \-n ", " \-\-novolumegroup
|
|
Only show physical volumes not belonging to any volume group.
|
|
.TP
|
|
.BR \-s ", " \-\-short
|
|
Short listing format.
|
|
.TP
|
|
.BR \-u ", " \-\-uuid
|
|
Show UUIDs (Uniform Unique Identifiers) in addition to device special names.
|
|
.TP
|
|
.BR \-a ", " \-\-activate " " \fIay
|
|
Together with the information already cached in lvmetad, automatically activate
|
|
any logical volumes that become activatable after the scan done on one or more devices.
|
|
The logical volume to autoactivate is matched against the
|
|
activation/auto_activation_volume_list set in lvm.conf. If this list is not set, then
|
|
all volumes are considered for autoactivation. The autoactivation is not yet
|
|
supported for logical volumes that are part of partial or clustered volume groups.
|
|
.TP
|
|
.BR \-b ", " \-\-background
|
|
Run the command in the background.
|
|
.TP
|
|
.BR \-\-cache " [" \-\-major " " \fImajor " " \-\-minor " " \fIminor " | " \fIDevicePath " | " \fImajor:minor " ]..."
|
|
Scan one or more devices and instruct the lvmetad daemon to update its cached
|
|
state accordingly. Called internally by udev rules.
|
|
All devices listed explicitly are processed \fBregardless\fP of any device
|
|
filters set using \fBdevices/filter\fP configuration setting. To filter
|
|
devices even in this case, the \fBdevices/global_filter\fP must be used.
|
|
If lvmetad has not yet cached any metadata or the filters have recently been
|
|
changed, then all devices may be scanned, effectively ignoring the rest of
|
|
the command line. Otherwise, if all the devices referenced on the command line
|
|
contain metadata in the default lvm2 format, other devices are not accessed.
|
|
If metadata written using the obsolete GFS pool or lvm1 format is encountered,
|
|
this is ignored and so lvmetad should not be used.
|
|
To notify lvmetad about a device that is not present in the system anymore,
|
|
\fB\-\-major\fP and \fB\-\-minor\fP pair of that device must be always supplied,
|
|
not \fBDevicePath\fP as pvscan is not able to translate the \fBDevicePath\fP
|
|
into major and minor pair which lvmetad requires.
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR lvmetad (8),
|
|
.BR pvcreate (8),
|
|
.BR pvdisplay (8)
|