diff options
Diffstat (limited to 'man/pvcreate.8.in')
-rw-r--r-- | man/pvcreate.8.in | 210 |
1 files changed, 0 insertions, 210 deletions
diff --git a/man/pvcreate.8.in b/man/pvcreate.8.in deleted file mode 100644 index 97a9909a4..000000000 --- a/man/pvcreate.8.in +++ /dev/null @@ -1,210 +0,0 @@ -.TH PVCREATE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*- -.SH NAME -pvcreate \(em initialize a disk or partition for use by LVM -.SH SYNOPSIS -.B pvcreate -.RB [ \-\-commandprofile -.IR ProfileName ] -.RB [ \-d | \-\-debug ] -.RB [ \-h | \-\-help ] -.RB [ \-t | \-\-test ] -.RB [ \-v | \-\-verbose ] -.RB [ \-\-version ] -.RB [ \-f [ f ]| \-\-force -.RB [ \-\-force ]] -.RB [ \-y | \-\-yes ] -.RB [ \-\-labelsector ] -.RB [ \-\-bootloaderareasize -.IR size ] -.RB [ \-M | \-\-metadatatype -.IR type ] -.RB [ \-\- [ pv ] metadatacopies -.IR NumberOfCopies ] -.RB [ \-\-metadatasize -.IR size ] -.RB [ \-\-metadataignore -.RI { y | n }] -.RB [ \-\-dataalignment -.IR alignment ] -.RB [ \-\-dataalignmentoffset -.IR alignment_offset ] -.RB [ \-\-restorefile -.IR file ] -.RB [ \-\-norestorefile ] -.RB [ \-\-reportformat -.RB { basic | json }] -.RB [ \-\-setphysicalvolumesize -.IR size ] -.RB [ \-u | \-\-uuid -.IR uuid ] -.RB [ \-Z | \-\-zero -.RI { y | n }] -.I PhysicalVolume -.RI [ PhysicalVolume ...] -.SH DESCRIPTION -pvcreate initializes -.I PhysicalVolume -for later use by the Logical Volume Manager (LVM). Each -.I PhysicalVolume -can be a disk partition, whole disk, meta device, or loopback file. -For DOS disk partitions, the partition id should be set to 0x8e using -.BR fdisk (8), -.BR cfdisk (8), -or a equivalent. For GUID Partition Table (GPT), the id is -E6D6D379-F507-44C2-A23C-238F2A3DF928. For -.B whole disk devices only -the partition table must be erased, which will effectively destroy all -data on that disk. This can be done by zeroing the first sector with: -.sp -.BI "dd if=/dev/zero of=" PhysicalVolume " bs=512 count=1" -.sp -Continue with -.BR vgcreate (8) -to create a new volume group on -.IR PhysicalVolume , -or -.BR vgextend (8) -to add -.I PhysicalVolume -to an existing volume group. -.SH OPTIONS -See \fBlvm\fP(8) for common options. -.TP -.BR \-f ", " \-\-force -Force the creation without any confirmation. You can not recreate -(reinitialize) a physical volume belonging to an existing volume group. -In an emergency you can override this behaviour with \fB-ff\fP. -.TP -.BR \-u ", " \-\-uuid " " \fIuuid -Specify the uuid for the device. -Without this option, \fBpvcreate\fP(8) generates a random uuid. -All of your physical volumes must have unique uuids. -You need to use this option before restoring a backup of LVM metadata -onto a replacement device - see \fBvgcfgrestore\fP(8). As such, use of -\fB\-\-restorefile\fP is compulsory unless the \fB\-\-norestorefile\fP is -used. -.TP -.BR \-y ", " \-\-yes -Answer yes to all questions. -.TP -.BR \-Z ", " \-\-zero " {" \fIy | \fIn } -Whether or not the first 4 sectors (2048 bytes) of the device should be -wiped. -If this option is not given, the -default is to wipe these sectors unless either or both of the -\fB\-\-restorefile\fP or \fB\-\-uuid\fP options were specified. -.SH NEW METADATA OPTIONS -LVM2 introduces a new format for storing metadata on disk. -This new format is more efficient and resilient than the format the -original version of LVM used and offers the advanced user greater -flexibility and control. -.P -The new format may be selected on the command line with \fB\-M2\fP or by -setting \fBformat = "lvm2"\fP in the \fBglobal\fP section of \fBlvm.conf\fP(5). -Each physical volume in the same volume group must use the same format, but -different volume groups on a machine may use different formats -simultaneously: the tools can handle both formats. -Additional formats can be added as shared libraries. -.P -Additional tools for manipulating the locations and sizes of metadata areas -will be written in due course. Use the verbose/debug options on the tools -to see where the metadata areas are placed. -.TP -.B \-\-metadatasize \fIsize -The approximate amount of space to be set aside for each metadata area. -(The size you specify may get rounded.) -.TP -.B \-\-dataalignment \fIalignment -Align the start of the data to a multiple of this number. -You should also specify an appropriate \fIPhysicalExtentSize\fP when creating -the Volume Group with \fBvgcreate\fP. -.sp -To see the location of the first Physical Extent of an existing Physical Volume -use \fBpvs \-o +pe_start\fP . It will be a multiple of the requested -alignment. In addition it may be shifted by \fIalignment_offset\fP from -\fIdata_alignment_offset_detection\fP (if enabled in \fBlvm.conf\fP(5)) or -\fB\-\-dataalignmentoffset\fP. -.TP -.B \-\-dataalignmentoffset \fIalignment_offset -Shift the start of the data area by this additional \fIalignment_offset\fP. -.TP -.BR \-\- [ pv ] metadatacopies " " \fINumberOfCopies -The number of metadata areas to set aside on each PV. Currently -this can be 0, 1 or 2. -If set to 2, two copies of the volume group metadata -are held on the PV, one at the front of the PV and one at the end. -If set to 1 (the default), one copy is kept at the front of the PV -(starting in the 5th sector). -If set to 0, no copies are kept on this PV - you might wish to use this -with VGs containing large numbers of PVs. But if you do this and -then later use \fBvgsplit\fP(8) you must ensure that each VG is still going -to have a suitable number of copies of the metadata after the split! -.TP -.BR \-\-metadataignore " {" \fIy | \fIn } -Ignore or un-ignore metadata areas on this physical volume. -The default is "n". This setting can be changed with \fBpvchange\fP. -If metadata areas on a physical volume are ignored, LVM will -not store metadata in the metadata areas present on this Physical -Volume. Metadata areas cannot be created or extended after Logical -Volumes have been allocated on the device. If you do not want to store -metadata on this device, it is still wise always to allocate a metadata -area in case you need it in the future and to use this option to instruct -LVM2 to ignore it. -.TP -.B \-\-restorefile \fIfile -In conjunction with \fB\-\-uuid\fP, this extracts the location and size -of the data on the PV from the file (produced by \fBvgcfgbackup\fP) -and ensures that the metadata that the program produces is consistent -with the contents of the file i.e. the physical extents will be in -the same place and not get overwritten by new metadata. This provides -a mechanism to upgrade the metadata format or to add/remove metadata -areas. Use with care. See also \fBvgconvert\fP(8). -.TP -.B \-\-norestorefile -In conjunction with \fB\-\-uuid\fP, this allows a \fIuuid\fP to be specified -without also requiring that a backup of the metadata be provided. -.TP -.B \-\-labelsector \fIsector -By default the PV is labelled with an LVM2 identifier in its second -sector (sector 1). This lets you use a different sector near the -start of the disk (between 0 and 3 inclusive - see LABEL_SCAN_SECTORS -in the source). Use with care. -.TP -.B \-\-bootloaderareasize \fIsize -Create a separate bootloader area of specified size besides PV's data -area. The bootloader area is an area of reserved space on the PV from -which LVM2 will not allocate any extents and it's kept untouched. This is -primarily aimed for use with bootloaders to embed their own data or metadata. -The start of the bootloader area is always aligned, see also \fB\-\-dataalignment\fP -and \fB\-\-dataalignmentoffset\fP. The bootloader area size may eventually -end up increased due to the alignment, but it's never less than the -size that is requested. To see the bootloader area start and size of -an existing Physical Volume use \fBpvs \-o +pv_ba_start,pv_ba_size\fP. -.TP -.B \-\-setphysicalvolumesize \fIsize -Overrides the automatically-detected size of the PV. Use with care. -.SH Examples -Initialize partition #4 on the third SCSI disk and the entire fifth -SCSI disk for later use by LVM: -.sp -.B pvcreate /dev/sdc4 /dev/sde - -If the 2nd SCSI disk is a 4KiB sector drive that compensates for windows -partitioning (sector 7 is the lowest aligned logical block, the 4KiB -sectors start at LBA -1, and consequently sector 63 is aligned on a 4KiB -boundary) manually account for this when initializing for use by LVM: -.sp -.B pvcreate \-\-dataalignmentoffset 7s /dev/sdb - -.SH SEE ALSO -.BR lvm.conf (5), -.BR lvm (8), -.BR vgcreate (8), -.BR vgextend (8), -.BR lvcreate (8), -.BR cfdisk (8), -.BR fdisk (8), -.BR losetup (8), -.BR mdadm (8), -.BR vgcfgrestore (8), -.BR vgconvert (8) |