Document metadata tagging.

man/lvchange.8

@@ -3,8 +3,10 @@
 lvchange \- change attributes of a logical volume
 .SH SYNOPSIS
 .B lvchange
+[\-\-addtag Tag]
 [\-A/\-\-autobackup y/n] [\-a/\-\-available y/n]
-[\-C/\-\-contiguous y/n] [\-d/\-\-debug] [\-h/\-?/\-\-help]
+[\-C/\-\-contiguous y/n] [\-d/\-\-debug] [\-\-deltag Tag]
+[\-h/\-?/\-\-help]
 [\-\-ignorelockingfailure]
 [\-M/\-\-persistent y/n] [\-\-minor minor]
 [\-P/\-\-partial y/n]

man/lvcreate.8

@@ -3,6 +3,7 @@
 lvcreate \- create a logical volume in an existing volume group
 .SH SYNOPSIS
 .B lvcreate
+[\-\-addtag Tag]
 [\-A/\-\-autobackup y/n] [\-C/\-\-contiguous y/n] [\-d/\-\-debug]
 [\-h/\-?/\-\-help]
 [\-i/\-\-stripes Stripes [\-I/\-\-stripesize StripeSize]]

man/lvm.8

@@ -75,11 +75,40 @@ changed with this option. To insert a replacement physical volume
 of the same or large size use \fBpvcreate -u\fP to set the uuid to 
 match the original followed by \fBvgcfgrestore (8)\fP.
 .TP
+\fB-M | --metadatatype type\fP
+Specifies which type of on-disk metadata to use, such as \fBlvm1\fP 
+or \fBlvm2\fP, which can be abbreviated to \fB1\fP or \fB2\fP respectively.
+The default (lvm2) can be changed by setting \fBformat\fP in the \fBglobal\fP
+section of the config file.
+.TP
 \fB--ignorelockingfailure\fP
 This lets you proceed with read-only metadata operations such as
 \fBlvchange -ay\fP and \fBvgchange -ay\fP even if the locking module fails.
 One use for this is in a system init script if the lock directory 
 is mounted read-only when the script runs.
+.TP
+\fB--addtag tag\fP
+Add the tag \fBtag\fP to a PV, VG or LV.  
+A tag is a word that can be used to group LVM2 objects of the same type 
+together. 
+Tags can be given on the command line in place of PV, VG or LV 
+arguments.  Tags should be prefixed with @ to avoid ambiguity.
+Each tag is expanded by replacing it with all objects possessing
+that tag which are of the type expected by its position on the command line.
+PVs can only possess tags while they are part of a Volume Group:
+PV tags are discarded if the PV is removed from the VG.
+As an example, you could tag some LVs as \fBdatabase\fP and others 
+as \fBuserdata\fP and then activate the database ones 
+with \fBlvchange -ay @database\fP.
+Objects can possess multiple tags simultaneously.
+Only the new LVM2 metadata format supports tagging: objects using the
+LVM1 metadata format cannot be tagged because the on-disk format does not
+support it.
+Snapshots cannot be tagged.
+Characters allowed in tags are: A-Z a-z 0-9 _ + . -
+.TP
+\fB--deltag tag\fP
+Delete the tag \fBtag\fP from a PV, VG or LV, if it's present.
 .SH ENVIRONMENT VARIABLES
 .TP
 \fBLVM_SYSTEM_DIR\fP 

man/pvchange.8

@@ -3,7 +3,10 @@
 pvchange \- change attributes of a physical volume
 .SH SYNOPSIS
 .B pvchange
-[\-A/\-\-autobackup y/n] [\-d/\-\-debug] [\-h/\-?/\-\-help]
+[\-\-addtag Tag]
+[\-A/\-\-autobackup y/n] [\-d/\-\-debug] 
+[\-\-deltag Tag]
+[\-h/\-?/\-\-help]
 [\-t/\-\-test]
 [\-v/\-\-verbose] [\-a/\-\-all] [\-x/\-\-allocatable y/n] [PhysicalVolumePath...]
 .SH DESCRIPTION

man/vgchange.8

@@ -3,9 +3,13 @@
 vgchange \- change attributes of a volume group
 .SH SYNOPSIS
 .B vgchange
+.RB [\-\-addtag
+.IR Tag ]
 .RB [\-A | \-\-autobackup " {" y | n }]
 .RB [\-a | \-\-available " {" y | n }]
 .RB [\-d | \-\-debug]
+.RB [\-\-deltag
+.IR Tag ]
 .RB [\-h | \-\-help]
 .RB [\-\-ignorelockingfailure]
 .RB [\-l | \-\-logicalvolume

man/vgcreate.8

@@ -3,6 +3,8 @@
 vgcreate \- create a volume group
 .SH SYNOPSIS
 .B vgcreate
+.RB [ \-\-addtag
+.IR Tag ]
 .RB [ \-A | \-\-autobackup " {" y | n }]
 .RB [ \-d | \-\-debug ]
 .RB [ \-h | \-\-help ]