lvm2/man/vgcreate.8_des

vgcreate creates a new VG on block devices. If the devices were not
previously initialized as PVs with \fBpvcreate\fP(8), vgcreate will
inititialize them, making them PVs. The pvcreate options for initializing
devices are also available with vgcreate.
.P
When vgcreate uses an existing PV, that PV's existing values for metadata
size, PE start, etc, are used, even if different values are specified in
the vgcreate command.  To change these values, first use pvremove on the
device.
generate man pages 2017-02-10 16:20:19 -06:00			`vgcreate creates a new VG on block devices. If the devices were not`
all: fix typos 2020-10-03 11:52:37 +00:00			`previously initialized as PVs with \fBpvcreate\fP(8), vgcreate will`
generate man pages 2017-02-10 16:20:19 -06:00			`inititialize them, making them PVs. The pvcreate options for initializing`
			`devices are also available with vgcreate.`
man: replace empty lines 2021-04-16 15:57:01 +02:00			`.P`
Place the first PE at 1 MiB for all defaults . When using default settings, this commit should change nothing. The first PE continues to be placed at 1 MiB resulting in a metadata area size of 1020 KiB (for 4K page sizes; slightly smaller for larger page sizes.) . When default_data_alignment is disabled in lvm.conf, align pe_start at 1 MiB, based on a default metadata area size that adapts to the page size. Previously, disabling this option would result in mda_size that was too small for common use, and produced a 64 KiB aligned pe_start. . Customized pe_start and mda_size values continue to be set as before in lvm.conf and command line. . Remove the configure option for setting default_data_alignment at build time. . Improve alignment related option descriptions. . Add section about alignment to pvcreate man page. Previously, DEFAULT_PVMETADATASIZE was 255 sectors. However, the fact that the config setting named "default_data_alignment" has a default value of 1 (MiB) meant that DEFAULT_PVMETADATASIZE was having no effect. The metadata area size is the space between the start of the metadata area (page size offset from the start of the device) and the first PE (1 MiB by default due to default_data_alignment 1.) The result is a 1020 KiB metadata area on machines with 4KiB page size (1024 KiB - 4 KiB), and smaller on machines with larger page size. If default_data_alignment was set to 0 (disabled), then DEFAULT_PVMETADATASIZE 255 would take effect, and produce a metadata area that was 188 KiB and pe_start of 192 KiB. This was too small for common use. This is fixed by making the default metadata area size a computed value that matches the value produced by default_data_alignment. 2018-11-13 15:00:11 -06:00			`When vgcreate uses an existing PV, that PV's existing values for metadata`
			`size, PE start, etc, are used, even if different values are specified in`
			`the vgcreate command. To change these values, first use pvremove on the`
			`device.`