lvchange man page on SuSE

Man page or keyword search:  
man Server   14857 pages
apropos Keyword Search (all sections)
Output format
SuSE 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}]  [--alloc	 AllocationPolicy]   [-C|--contiguous	{y|n}]
       [-d|--debug]  [--deltag	Tag] [--discards {ignore|nopassdown|passdown}]
       [--resync] [-h|-?|--help] [--ignorelockingfailure] [--ignoremonitoring]
       [--monitor  {y|n}] [--poll {y|n}] [--sysinit] [--noudevsync] [-M|--per‐
       sistent {y|n}] [--minor minor] [-P|--partial] [-p|--permission  {r|rw}]
       [-r|--readahead	{ReadAheadSectors|auto|none}]  [--refresh] [-t|--test]
       [-v|--verbose]	[-Z|--zero   {y|n}]   LogicalVolumePath	  [LogicalVol‐
       umePath...]

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.  Autoactiva‐
	      tion 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.

       -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.

       --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.

       --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.98(2) (2012-10-15)	   LVCHANGE(8)
[top]

List of man pages available for SuSE

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