OS Manuals

/usr/bin/pvscan

Logical Volume Manager 2 utilities

From lvm2 2.03.44-r1 (os), captured 2026-11-08 by running pvscan --help (exit 0) · terse output. permalink

  Failed to find sysfs mount point
  WARNING: Running as a non-root user. Functionality may be unavailable.
  pvscan - List all physical volumes

  Display PV information.
  pvscan
	[ -A|--allpvs ]
	[ -e|--exported ]
	[ -n|--novolumegroup ]
	[ -s|--short ]
	[ -u|--uuid ]
	[    --ignorelockingfailure ]
	[    --reportformat basic|json|json_std ]
	[ COMMON_OPTIONS ]

  Record that a PV is online or offline.
  pvscan --cache
	[ -j|--major Number ]
	[    --ignorelockingfailure ]
	[    --minor Number ]
	[    --noudevsync ]
	[    --reportformat basic|json|json_std ]
	[ COMMON_OPTIONS ]
	[ String|PV ... ]

  Record that a PV is online and autoactivate the VG if complete.
  pvscan --cache -a|--activate ay
	[ -j|--major Number ]
	[    --autoactivation String ]
	[    --ignorelockingfailure ]
	[    --minor Number ]
	[    --noudevsync ]
	[    --reportformat basic|json|json_std ]
	[ COMMON_OPTIONS ]
	[ String|PV ... ]

  Record that a PV is online and list the VG using the PV.
  pvscan --cache --listvg PV
	[    --autoactivation String ]
	[    --checkcomplete ]
	[    --ignorelockingfailure ]
	[    --udevoutput ]
	[    --vgonline ]
	[ COMMON_OPTIONS ]

  Record that a PV is online and list LVs using the PV.
  pvscan --cache --listlvs PV
	[    --checkcomplete ]
	[    --ignorelockingfailure ]
	[    --vgonline ]
	[ COMMON_OPTIONS ]

  List LVs using the PV.
  pvscan --listlvs PV
	[ COMMON_OPTIONS ]

  List the VG using the PV.
  pvscan --listvg PV
	[ COMMON_OPTIONS ]

  Common options for lvm:
	[ -d|--debug ]
	[ -h|--help ]
	[ -q|--quiet ]
	[ -v|--verbose ]
	[ -y|--yes ]
	[ -t|--test ]
	[    --commandprofile String ]
	[    --config String ]
	[    --driverloaded y|n ]
	[    --nolocking ]
	[    --lockopt String ]
	[    --longhelp ]
	[    --profile String ]
	[    --version ]
	[    --devicesfile String ]
	[    --devices PV ]
	[    --nohints ]
	[    --journal String ]

  Use --longhelp to show all options and advanced commands.
Options (12)
OptionDescriptionSource
--cacheScan one or more devices and record that they are online.man
--checkcompleteCheck if all the devices used by a VG or LV are present, and print "complete" or "incomplete" for each listed VG or LV.man
--ignorelockingfailureAllows a command to continue with read-only metadata operations after locking failures.man
--listlvsPrint a list of LVs that use the device.man
--listvgPrint the VG that uses the device.man
--longhelpDisplay long help text.man
--nohintsDo not use the hints file to locate devices for PVs.man
--nolockingDisable locking.man
--noudevsyncDisables udev synchronization.man
--udevoutputCommand output is modified to be imported by a udev rule.man
--versionDisplay version information.man
--vgonlineThe first command to see a complete VG will report it uniquely.man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.