From 12da72adeb4e9d04467324b665e2cc877eab4478 Mon Sep 17 00:00:00 2001
From: Alasdair Kergon <agk@redhat.com>
Date: Mon, 22 Mar 2004 15:08:50 +0000
Subject: [PATCH] Document metadata tagging.

---
 man/lvchange.8 |  4 +++-
 man/lvcreate.8 |  1 +
 man/lvm.8      | 29 +++++++++++++++++++++++++++++
 man/pvchange.8 |  5 ++++-
 man/vgchange.8 |  4 ++++
 man/vgcreate.8 |  2 ++
 6 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/man/lvchange.8 b/man/lvchange.8
index f5fa1a42a..1ed59bcb3 100644
--- a/man/lvchange.8
+++ b/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]
diff --git a/man/lvcreate.8 b/man/lvcreate.8
index e4e3c008b..d2dff1598 100644
--- a/man/lvcreate.8
+++ b/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]]
diff --git a/man/lvm.8 b/man/lvm.8
index e9882567a..8259d4e58 100644
--- a/man/lvm.8
+++ b/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 
diff --git a/man/pvchange.8 b/man/pvchange.8
index e18cb8903..f8b6f702b 100644
--- a/man/pvchange.8
+++ b/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
diff --git a/man/vgchange.8 b/man/vgchange.8
index e48efd21e..4e3c9475b 100644
--- a/man/vgchange.8
+++ b/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
diff --git a/man/vgcreate.8 b/man/vgcreate.8
index 6916bebf3..9a617625f 100644
--- a/man/vgcreate.8
+++ b/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 ]