lvchange(8) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
LVCHANGE(8)                                                        LVCHANGE(8)




NAME

       lvchange - change attributes of a logical volume


SYNOPSIS

       lvchange   [--addtag   Tag]   [-A|--autobackup   y|n]   [-a|--available
       y|n|ey|en|ly|ln]  [--alloc  AllocationPolicy]   [-C|--contiguous   y|n]
       [-d|--debug] [--deltag Tag] [--resync] [-h|-?|--help] [--ignorelocking-
       failure] [--ignoremonitoring] [--monitor {y|n}]  [-M|--persistent  y|n]
       [--minor  minor]  [-P|--partial] [-p|--permission r|rw] [-r/--readahead
       ReadAheadSectors|auto|none] [--refresh] [-t|--test] [-v|--verbose] Log-
       icalVolumePath [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 for common options.

       -a, --available y|n|ey|en|ly|ln
              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 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.

       --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
              Controls whether or not a mirrored logical volume  is  monitored
              by  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.

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

Examples
       "lvchange  -pr  vg00/lvol1"  changes  the permission on volume lvol1 in
       volume group vg00 to be read-only.



SEE ALSO

       lvm(8), lvcreate(8), vgchange(8)



Sistina Software UK    LVM TOOLS 2.02.44-cvs (02-17-09)            LVCHANGE(8)