Module Name: src
Committed By: jnemeth
Date: Thu Oct 24 06:59:03 UTC 2013
Modified Files:
src/sbin/gpt: gpt.8
Log Message:
- markup
- typo; the label command labels partitions, not remove them
- migrate -s isn't applicable to NetBSD
- add information about the space required for migration
- add a "gpt show -l" example
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/sbin/gpt/gpt.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sbin/gpt/gpt.8
diff -u src/sbin/gpt/gpt.8:1.13 src/sbin/gpt/gpt.8:1.14
--- src/sbin/gpt/gpt.8:1.13 Sun Oct 20 21:13:23 2013
+++ src/sbin/gpt/gpt.8 Thu Oct 24 06:59:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: gpt.8,v 1.13 2013/10/20 21:13:23 jnemeth Exp $
+.\" $NetBSD: gpt.8,v 1.14 2013/10/24 06:59:03 jnemeth Exp $
.\"
.\" Copyright (c) 2002 Marcel Moolenaar
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD: src/sbin/gpt/gpt.8,v 1.17 2006/06/22 22:22:32 marcel Exp $
.\"
-.Dd March 9, 2012
+.Dd October 23, 2013
.Dt GPT 8
.Os
.Sh NAME
@@ -42,7 +42,9 @@
The
.Nm
utility provides the necessary functionality to manipulate GUID partition
-tables (GPTs), but see
+tables
+.Pq GPTs ,
+but see
.Sx BUGS
below for how and where functionality is missing.
The basic usage model of the
@@ -209,7 +211,7 @@ option selects the partition with the gi
The
.Fl s Ar count
option selects all partitions that have the given size.
-This can cause multiple partitions to be removed.
+This can cause multiple partitions to be labeled.
.Pp
The
.Fl t Ar type
@@ -217,7 +219,7 @@ option selects all partitions that have
The type is given as an UUID or by the aliases that the
.Ic add
command accepts.
-This can cause multiple partitions to be removed.
+This can cause multiple partitions to be labeled.
.Pp
The
.Fl f Ar file
@@ -259,6 +261,27 @@ option prevents migrating
.Bx
disk labels into GPT partitions by creating
the GPT equivalent of a slice.
+Note that the
+.Fl s
+option isn't applicable to
+.Nx
+partitions.
+.Pp
+The
+.Ic migrate
+command requires space at the beginning and the end of the device outside
+any partitions to store the GPTs.
+Space is required for the GPT header
+.Pq which takes one sector
+and the GPT partition table.
+See the
+.Fl p
+option
+for the size of the GPT partition table.
+By default, just about all devices have a minimum of 62 sectors free at the
+beginning of the device, but don't have any free space at the end.
+For the default GPT partition table size on a 512 byte sector size device,
+33 sectors at the end of the device would need to be freed.
.\" ==== recover ====
.It Nm Ic recover Ar device ...
The
@@ -331,6 +354,15 @@ nas# gpt show wd3
10486258 3896542877
3907029135 32 Sec GPT table
3907029167 1 Sec GPT header
+nas# gpt show -l wd3
+ start size index contents
+ 0 1 PMBR
+ 1 1 Pri GPT header
+ 2 32 Pri GPT table
+ 34 10486224 1 GPT part - "swap_1"
+ 10486258 3896542877
+ 3907029135 32 Sec GPT table
+ 3907029167 1 Sec GPT header
nas#
.Ed
.Sh SEE ALSO
