summaryrefslogtreecommitdiffstats
path: root/sbin/geom
diff options
context:
space:
mode:
authormaxim <maxim@FreeBSD.org>2011-01-13 06:18:00 +0000
committermaxim <maxim@FreeBSD.org>2011-01-13 06:18:00 +0000
commitae845ad3a878c098d138101a2e26b34612a105ec (patch)
treefc2557a4e4b4589cdc60af61dab819eb59704067 /sbin/geom
parent2c0b3b2277e59b364062a3053589da5117fc4874 (diff)
downloadFreeBSD-src-ae845ad3a878c098d138101a2e26b34612a105ec.zip
FreeBSD-src-ae845ad3a878c098d138101a2e26b34612a105ec.tar.gz
o Start each sentence on a new line. No content changes.
Suggested by: jhb MFC after: 1 week
Diffstat (limited to 'sbin/geom')
-rw-r--r--sbin/geom/class/part/gpart.844
1 files changed, 25 insertions, 19 deletions
diff --git a/sbin/geom/class/part/gpart.8 b/sbin/geom/class/part/gpart.8
index 4128211..0f70fcd 100644
--- a/sbin/geom/class/part/gpart.8
+++ b/sbin/geom/class/part/gpart.8
@@ -422,8 +422,9 @@ about its use.
.It Cm restore
Restore the partition table from backup previously created by
.Cm backup
-action and given from standard input. Only partition table
-may be restored. This action does not affect content of partitions.
+action and given from standard input.
+Only partition table may be restored.
+This action does not affect content of partitions.
This mean that you should copy your data from backup after restoring
partition table and write bootcode again if it is needed.
.Pp
@@ -703,20 +704,23 @@ action.
.Sh RECOVERING
The GEOM class PART supports recovering of partition tables only for GPT.
The GUID partition table has a primary and secondary (backup) copy of
-metadata for redundance. They are stored in the begining and in the end
-of device respectively. Therefore it is acceptable to have some corruptions
-in the metadata that are not fatal to work with GPT. When kernel detects
-corrupt metadata it marks this table as corrupt and reports about corruption.
+metadata for redundance.
+They are stored in the begining and in the end of device respectively.
+Therefore it is acceptable to have some corruptions in the metadata that
+are not fatal to work with GPT.
+When kernel detects corrupt metadata it marks this table as corrupt and
+reports about corruption.
Any changes in corrupt table are prohibited except
.Cm destroy
and
.Cm recover .
.Pp
In case when only first sector is corrupt kernel can not detect GPT even
-if partition table is not corrupt. You can write protective MBR with
+if partition table is not corrupt.
+You can write protective MBR with
.Xr dd 1
-command to restore ability of GPT detection. The copy of protective MBR is
-usually located in the
+command to restore ability of GPT detection.
+The copy of protective MBR is usually located in the
.Pa /boot/pmbr
file.
.Pp
@@ -743,25 +747,27 @@ and
will report about corrupt table.
.Pp
In case when the size of device has changed (e.g. volume expansion) the
-secondary GPT header will become located not in the last sector. This is
-not a metadata corruption, but it is dangerous because any corruption of
-the primary GPT will lead to lost of partition table. Kernel reports about
-this problem with message:
+secondary GPT header will become located not in the last sector.
+This is not a metadata corruption, but it is dangerous because any
+corruption of the primary GPT will lead to lost of partition table.
+Kernel reports about this problem with message:
.Bd -literal -offset indent
GEOM: provider: the secondary GPT header is not in the last LBA.
.Ed
.Pp
A corrupt table can be recovered with
.Cm gpart recover
-command. This command does reconstruction of corrupt metadata using
-known valid metadata. Also it can relocate secondary GPT to the end of
-device.
+command.
+This command does reconstruction of corrupt metadata using
+known valid metadata.
+Also it can relocate secondary GPT to the end of device.
.Pp
.Pa NOTE :
The GEOM class PART can detect the same partition table on different GEOM
-providers and some of them will be marked as corrupt. Be careful when choosing
-a provider for recovering. If you choose incorrectly you can destroy the
-metadata of another GEOM class, e.g. GEOM MIRROR or GEOM LABEL.
+providers and some of them will be marked as corrupt.
+Be careful when choosing a provider for recovering.
+If you choose incorrectly you can destroy the metadata of another GEOM class,
+e.g. GEOM MIRROR or GEOM LABEL.
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
OpenPOWER on IntegriCloud