OS Manuals

/usr/bin/vgchange

Logical Volume Manager 2 utilities

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

  Failed to find sysfs mount point
  WARNING: Running as a non-root user. Functionality may be unavailable.
  vgchange - Change volume group attributes

  Change a general VG attribute.
  For options listed in parentheses, any one is
  required, after which the others are optional.
  vgchange
	( -l|--logicalvolume Number,
	  -p|--maxphysicalvolumes Number,
	  -s|--physicalextentsize Size[m|UNIT],
	  -u|--uuid,
	  -x|--resizeable y|n,
	     --addtag Tag,
	     --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit,
	     --deltag Tag,
	     --detachprofile,
	     --metadataprofile String,
	     --pvmetadatacopies 0|1|2,
	     --setautoactivation y|n,
	     --vgmetadatacopies all|unmanaged|Number )

	[ -A|--autobackup y|n ]
	[ -f|--force ]
	[ -S|--select String ]
	[    --ignoremonitoring ]
	[    --noudevsync ]
	[    --poll y|n ]
	[    --reportformat basic|json|json_std ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Start or stop monitoring LVs from dmeventd.
  vgchange --monitor y|n
	[ -A|--autobackup y|n ]
	[ -f|--force ]
	[ -S|--select String ]
	[    --ignorelockingfailure ]
	[    --ignoremonitoring ]
	[    --noudevsync ]
	[    --poll y|n ]
	[    --reportformat basic|json|json_std ]
	[    --sysinit ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Start or stop processing LV conversions.
  vgchange --poll y|n
	[ -A|--autobackup y|n ]
	[ -f|--force ]
	[ -S|--select String ]
	[    --ignorelockingfailure ]
	[    --ignoremonitoring ]
	[    --noudevsync ]
	[    --reportformat basic|json|json_std ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Activate or deactivate LVs.
  vgchange -a|--activate y|n|ay
	[ -A|--autobackup y|n ]
	[ -f|--force ]
	[ -K|--ignoreactivationskip ]
	[ -P|--partial ]
	[ -S|--select String ]
	[    --activationmode partial|degraded|complete ]
	[    --autoactivation String ]
	[    --ignorelockingfailure ]
	[    --ignoremonitoring ]
	[    --monitor y|n ]
	[    --noudevsync ]
	[    --persist String ]
	[    --poll y|n ]
	[    --readonly ]
	[    --reportformat basic|json|json_std ]
	[    --sysinit ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Reactivate LVs using the latest metadata.
  vgchange --refresh
	[ -A|--autobackup y|n ]
	[ -f|--force ]
	[ -S|--select String ]
	[    --ignorelockingfailure ]
	[    --ignoremonitoring ]
	[    --noudevsync ]
	[    --poll y|n ]
	[    --reportformat basic|json|json_std ]
	[    --sysinit ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Change the system ID of a VG.
  vgchange --systemid String VG|Tag|Select
	[ -S|--select String ]
	[    --majoritypvs ]
	[    --persist String ]
	[    --removekey String ]
	[ COMMON_OPTIONS ]

  Set or clear flags to control persistent reservation behavior.
  vgchange --setpersist String VG|Tag|Select
	[ -S|--select String ]
	[    --persist start ]
	[ COMMON_OPTIONS ]

  Perform persistent reservation commands on devices.
  vgchange --persist String VG|Tag|Select
	[ -f|--force ]
	[ -S|--select String ]
	[    --majoritypvs ]
	[    --removekey String ]
	[ COMMON_OPTIONS ]

  Set or clear lock_args flags to control lock manager behavior.
  vgchange --setlockargs String VG|Tag|Select
	[ -S|--select String ]
	[ COMMON_OPTIONS ]

  Start the lockspace of a shared VG in lvmlockd.
  vgchange --lockstart
	[ -S|--select String ]
	[    --persist start ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Stop the lockspace of a shared VG in lvmlockd.
  vgchange --lockstop
	[ -S|--select String ]
	[    --persist stop ]
	[ COMMON_OPTIONS ]
	[ VG|Tag|Select ... ]

  Change the lock type for a shared VG.
  vgchange --locktype none VG
	[    --setlockargs String ]
	[ 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 (20)
OptionDescriptionSource
--addtag Taghelp
--allochelp
--deltag Taghelp
--detachprofileDetaches a metadata profile from a VG or LV.help + man
--metadataprofile Stringhelp
--pvmetadatacopies 0|1|2help
--setautoactivation y|nhelp
--ignorelockingfailureAllows a command to continue with read-only metadata operations after locking failures. (in the manual page but not in --help)man
--ignoremonitoringDo not interact with dmeventd unless --monitor is specified. (in the manual page but not in --help)man
--lockstartStart the lockspace of a shared VG in lvmlockd. (in the manual page but not in --help)man
--lockstopStop the lockspace of a shared VG in lvmlockd. (in the manual page but not in --help)man
--longhelpDisplay long help text. (in the manual page but not in --help)man
--majoritypvsChange the VG system ID if the majority of PVs in the VG are present (one more than half). (in the manual page but not in --help)man
--nohintsDo not use the hints file to locate devices for PVs. (in the manual page but not in --help)man
--nolockingDisable locking. (in the manual page but not in --help)man
--noudevsyncDisables udev synchronization. (in the manual page but not in --help)man
--readonlyPrevent the command from making changes, including activation and metadata updates. (in the manual page but not in --help)man
--refreshIf the LV is active, reload its metadata. (in the manual page but not in --help)man
--sysinitIndicates that vgchange/lvchange is being invoked from early system initialisation scripts (e.g. rc.sysinit or an initrd), before writable filesystems are available. (in the manual page but not in --help)man
--versionDisplay version information. (in the manual page but not in --help)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.