Initial import of binutils 2.22 on the new vendor branch
[dragonfly.git] / contrib / lvm2 / dist / man / vgcfgrestore.8
1 .\"    $NetBSD: vgcfgrestore.8,v 1.2 2009/02/18 12:16:13 haad Exp $
2 .\"
3 .TH VGCFGRESTORE 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Sistina Software UK" \" -*- nroff -*-
4 .SH NAME
5 vgcfgrestore \- restore volume group descriptor area
6 .SH SYNOPSIS
7 .B vgcfgrestore
8 .RB [ \-d | \-\-debug ]
9 .RB [ \-f | \-\-file " filename" ]
10 .RB [ \-l[l] | \-\-list ]
11 .RB [ \-h | \-\-help ]
12 .RB [ \-M | \-\-Metadatatype 1|2]
13 .RB [ \-t | \-\-test ]
14 .RB [ \-v | \-\-verbose ]
15 .RI \fIVolumeGroupName\fP
16 .SH DESCRIPTION
17 .B vgcfgrestore
18 allows you to restore the metadata of \fIVolumeGroupName\fP from a text 
19 backup file produced by \fBvgcfgbackup\fP.  You can specify a backup file 
20 with \fP--file\fP.  If no backup file is specified, the most recent
21 one is used.  Use \fB--list\fP for a list of the available
22 backup and archive files of \fIVolumeGroupName\fP.
23 .SH OPTIONS
24 .TP
25 \fB-l | --list\fP \(em List files pertaining to \fIVolumeGroupName\fP
26 List metadata backup and archive files pertaining to \fIVolumeGroupName\fP.
27 May be used with the \fB-f\fP option.  Does not restore \fIVolumeGroupName\fP.
28 .TP
29 \fB-f | --file\fP filename \(em Name of LVM metadata backup file
30 Specifies a metadata backup or archive file to be used for restoring 
31 VolumeGroupName.  Often this file has been created with \fBvgcfgbackup\fP.
32 .TP
33 See \fBlvm\fP for common options.
34 .SH REPLACING PHYSICAL VOLUMES
35 \fBvgdisplay --partial --verbose\fP will show you the UUIDs and sizes of
36 any PVs that are no longer present.
37 If a PV in the VG is lost and you wish to substitute 
38 another of the same size, use 
39 \fBpvcreate --restorefile filename --uuid uuid\fP (plus additional 
40 arguments as appropriate) to initialise it with the same UUID as 
41 the missing PV.  Repeat for all other missing PVs in the VG. 
42 Then use \fBvgcfgrestore --file filename\fP to restore the volume
43 group's metadata.
44 .SH SEE ALSO
45 .BR lvm (8),
46 .BR vgcreate (8)