lvchange man page on Mageia

Man page or keyword search:  
man Server   17783 pages
apropos Keyword Search (all sections)
Output format
Mageia logo
[printable version]

LVCHANGE(8)							   LVCHANGE(8)

NAME
       lvchange - change attributes of a logical volume

SYNOPSIS
       lvchange	  [--addtag   Tag]   [-A|--autobackup	{y|n}]	[-a|--activate
       [a|e|l]{y|n}] [-k|--setactivationskip{y|n}] [-K|--ignoreactivationskip]
       [--alloc	  AllocationPolicy]   [-C|--contiguous	 {y|n}]	  [-d|--debug]
       [--deltag Tag] [--profile  ProfileName]	[--detachprofile]  [--discards
       {ignore|nopassdown|passdown}]  [--resync] [-h|-?|--help] [--ignorelock‐
       ingfailure]  [--ignoremonitoring]  [--ignoreskippedcluster]  [--monitor
       {y|n}] [--poll {y|n}] [--[raid]maxrecoveryrate Rate] [--[raid]minrecov‐
       eryrate Rate] [--[raid]syncaction {check|repair}]  [--[raid]writebehind
       IOCount]	  [--[raid]writemostly	PhysicalVolume[:{t|n|y}]]  [--sysinit]
       [--noudevsync] [-M|--persistent {y|n}] [--minor	minor]	[-P|--partial]
       [-p|--permission	 {r|rw}] [-r|--readahead {ReadAheadSectors|auto|none}]
       [--refresh] [-t|--test] [-v|--verbose]  [-Z|--zero  {y|n}]  LogicalVol‐
       umePath [LogicalVolumePath...]

DESCRIPTION
       lvchange	 allows	 you  to  change  the  attributes  of a logical volume
       including making them known to the kernel ready for use.

OPTIONS
       See lvm(8) for common options.

       -a, --activate [a|e|l]{y|n}
	      Controls the availability of the logical volumes for use.	  Com‐
	      municates	 with the kernel device-mapper driver via libdevmapper
	      to activate (-ay) or deactivate (-an) the	 logical  volumes.  If
	      autoactivation  option  is  used	(-aay),	 the logical volume is
	      activated	 only  if  it  matches	an   item   in	 the   activa‐
	      tion/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.

	      If clustered locking is enabled, -aey will activate  exclusively
	      on  one  node and -aly will activate only on the local node.  To
	      deactivate only on the local node	 use  -aln.   Logical  volumes
	      with  single-host	 snapshots  are	 always	 activated exclusively
	      because they can only be used on one node at once.

       -k, --setactivationskip {y|n}
	      Controls	whether Logical Volumes are persistently flagged to be
	      skipped during activation. By default, thin snapshot volumes are
	      flagged for activation skip.  To activate such volumes, an extra
	      -K/--ignoreactivationskip	 option must be used.  The flag is not
	      applied  during  deactivation.  To  see  whether	the  flag   is
	      attached,	 use  lvs  command  where  the	state  of  the flag is
	      reported within lv_attr bits.

       -K, --ignoreactivationskip
	      Ignore the flag to skip Logical Volumes during activation.

       -C, --contiguous {y|n}
	      Tries to set or reset the contiguous allocation policy for logi‐
	      cal volumes. It's only possible to change a non-contiguous logi‐
	      cal volume's allocation policy to	 contiguous,  if  all  of  the
	      allocated physical extents are already contiguous.

       --detachprofile
	      Detach any configuration profiles attached to given Logical Vol‐
	      umes.  See also lvm(8)  and  lvm.conf(5)	for  more  information
	      about configuration profiles.

       --discards {ignore|nopassdown|passdown}
	      Set  this	 to  ignore  to ignore any discards received by a thin
	      pool Logical Volume.  Set to nopassdown to process such discards
	      within  the  thin	 pool  itself  and  allow the no-longer-needed
	      extents to be overwritten by new data.   Set  to	passdown  (the
	      default) to process them both within the thin pool itself and to
	      pass them down the underlying device.

       --resync
	      Forces the complete resynchronization of a  mirror.   In	normal
	      circumstances  you  should not need this option because synchro‐
	      nization happens automatically.  Data is read from  the  primary
	      mirror  device and copied to the others, so this can take a con‐
	      siderable amount of time - and during this time you are  without
	      a complete redundant copy of your data.

       --minor minor
	      Set the minor number.

       --monitor {y|n}
	      Start  or	 stop monitoring a mirrored or snapshot logical volume
	      with dmeventd, if it is installed.  If a device used by a	 moni‐
	      tored  mirror  reports  an  I/O  error,  the  failure is handled
	      according to mirror_image_fault_policy and mirror_log_fault_pol‐
	      icy set in lvm.conf.

       --poll {y|n}
	      Without  polling	a logical volume's backgrounded transformation
	      process will never complete.  If there is an  incomplete	pvmove
	      or  lvconvert  (for  example,  on	 rebooting after a crash), use
	      --poll y to restart the process from its last checkpoint.	  How‐
	      ever,  it	 may  not be appropriate to immediately poll a logical
	      volume when it is activated, use --poll  n  to  defer  and  then
	      --poll y to restart the process.

       --[raid]maxrecoveryrate Rate[bBsSkKmMgG]
	      Sets  the maximum recovery rate for a RAID logical volume.  Rate
	      is specified as an amount per second  for	 each  device  in  the
	      array.   If  no suffix is given, then kiB/sec/device is assumed.
	      Setting the recovery rate to 0 means it will be unbounded.

       --[raid]minrecoveryrate Rate[bBsSkKmMgG]
	      Sets the minimum recovery rate for a RAID logical volume.	  Rate
	      is  specified  as	 an  amount  per second for each device in the
	      array.  If no suffix is given, then kiB/sec/device  is  assumed.
	      Setting the recovery rate to 0 means it will be unbounded.

       --[raid]syncaction {check|repair}
	      This  argument  is used to initiate various RAID synchronization
	      operations.  The check and repair options provide a way to check
	      the  integrity  of  a  RAID logical volume (often referred to as
	      "scrubbing").  These options cause the RAID  logical  volume  to
	      read  all	 of  the data and parity blocks in the array and check
	      for any discrepancies (e.g. mismatches between mirrors or incor‐
	      rect  parity  values).  If check is used, the discrepancies will
	      be counted but not repaired.  If repair is used, the  discrepan‐
	      cies  will be corrected as they are encountered.	The 'lvs' com‐
	      mand can be used to show the number of  discrepancies  found  or
	      repaired.

       --[raid]writebehind IOCount
	      Specify  the  maximum  number  of	 outstanding  writes  that are
	      allowed to devices in a RAID1 logical volume that are marked  as
	      write-mostly.   Once  this value is exceeded, writes become syn‐
	      chronous (i.e. all writes to the constituent devices  must  com‐
	      plete  before  the array signals the write has completed).  Set‐
	      ting the value to zero clears the preference and allows the sys‐
	      tem to choose the value arbitrarily.

       --[raid]writemostly PhysicalVolume[:{t|y|n}]
	      Mark  a  device  in a RAID1 logical volume as write-mostly.  All
	      reads to these drives will be avoided unless  absolutely	neces‐
	      sary.   This keeps the number of I/Os to the drive to a minimum.
	      The default behavior is to set the  write-mostly	attribute  for
	      the specified physical volume in the logical volume.  It is pos‐
	      sible to also remove the write-mostly flag by appending  a  ":n"
	      to  the  physical	 volume	 or  to toggle the value by specifying
	      ":t".  The --writemostly argument can be specified more than one
	      time  in	a  single  command;  making  it possible to toggle the
	      write-mostly attributes for all the physical volumes in a	 logi‐
	      cal volume at once.

       --sysinit
	      Indicates	 that  lvchange(8)  is being invoked from early system
	      initialisation scripts (e.g. rc.sysinit or  an  initrd),	before
	      writeable filesystems are available. As such, some functionality
	      needs to be disabled and this option acts as  a  shortcut	 which
	      selects an appropriate set of options. Currently this is equiva‐
	      lent  to	using	 --ignorelockingfailure,   --ignoremonitoring,
	      --poll n and setting LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES envi‐
	      ronment variable.

	      If --sysinit is used in conjunction with lvmetad(8) enabled  and
	      running,	autoactivation is preferred over manual activation via
	      direct lvchange call.  Logical volumes are autoactivated accord‐
	      ing to auto_activation_volume_list set in lvm.conf(5).

       --noudevsync
	      Disable  udev  synchronisation.  The  process  will not wait for
	      notification from udev.  It will continue	 irrespective  of  any
	      possible udev processing in the background.  You should only use
	      this if udev is not running or has rules that ignore the devices
	      LVM2 creates.

       --ignoremonitoring
	      Make  no	attempt	 to interact with dmeventd unless --monitor is
	      specified.  Do not use this if dmeventd is already monitoring  a
	      device.

       -M, --persistent {y|n}
	      Set to y to make the minor number specified persistent.

       -p, --permission {r|rw}
	      Change access permission to read-only or read/write.

       -r, --readahead {ReadAheadSectors|auto|none}
	      Set  read ahead sector count of this logical volume.  For volume
	      groups with metadata in  lvm1  format,  this  must  be  a	 value
	      between  2  and  120 sectors.  The default value is "auto" which
	      allows the kernel to  choose  a  suitable	 value	automatically.
	      "None" is equivalent to specifying zero.

       --refresh
	      If  the  logical volume is active, reload its metadata.  This is
	      not necessary in normal operation, but may be  useful  if	 some‐
	      thing  has  gone	wrong  or  if you're doing clustering manually
	      without a clustered lock manager.

       -Z, --zero {y|n}
	      Set zeroing mode for thin pool. Note: already provisioned blocks
	      from  pool  in  non-zero mode are not cleared in unwritten parts
	      when setting zero to y.

Examples
       Changes the permission on volume lvol1 in volume group vg00 to be read-
       only:

       lvchange -pr vg00/lvol1

SEE ALSO
       lvm(8), lvcreate(8), vgchange(8)

Sistina Software UK   LVM TOOLS 2.02.103(2) (2013-10-04)	   LVCHANGE(8)
[top]

List of man pages available for Mageia

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net