summaryrefslogtreecommitdiffstats
path: root/sbin
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2009-10-19 15:50:59 +0000
committerru <ru@FreeBSD.org>2009-10-19 15:50:59 +0000
commit85b92382975dcce3c4e75db4f6d039ac9c2ce510 (patch)
tree36b0b1869c16a5f6bb1c445c4ff4e3f600d44f81 /sbin
parentd42d258f85f0289f2892ee9b2cd9d3523193a7b9 (diff)
downloadFreeBSD-src-85b92382975dcce3c4e75db4f6d039ac9c2ce510.zip
FreeBSD-src-85b92382975dcce3c4e75db4f6d039ac9c2ce510.tar.gz
Clean up markup (mainly).
Diffstat (limited to 'sbin')
-rw-r--r--sbin/geom/class/part/gpart.8226
1 files changed, 149 insertions, 77 deletions
diff --git a/sbin/geom/class/part/gpart.8 b/sbin/geom/class/part/gpart.8
index 6deea8c..3de658c 100644
--- a/sbin/geom/class/part/gpart.8
+++ b/sbin/geom/class/part/gpart.8
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd Nov 18, 2008
+.Dd November 18, 2008
.Dt GPART 8
.Os
.Sh NAME
@@ -43,20 +43,34 @@ lines in your kernel configuration file:
.Cd "options GEOM_PART_VTOC8"
.Ed
.Pp
-The GEOM_PART_APM option adds support for the Apple Partition Map (APM)
+The
+.Dv GEOM_PART_APM
+option adds support for the Apple Partition Map (APM)
found on Apple Macintosh computers.
-The GEOM_PART_BSD option adds support for the traditional BSD disklabel.
-The GEOM_PART_GPT option adds support for the GUID Partition Table (GPT)
+The
+.Dv GEOM_PART_BSD
+option adds support for the traditional
+.Bx
+disklabel.
+The
+.Dv GEOM_PART_GPT
+option adds support for the GUID Partition Table (GPT)
found on Intel Itanium computers and Intel-based Macintosh computers.
-The GEOM_PART_MBR option adds support for the Master Boot Record (MBR)
+The
+.Dv GEOM_PART_MBR
+option adds support for the Master Boot Record (MBR)
found on PCs and used on many removable media.
-The GEOM_PART_PC98 option adds support for the MBR variant as used on
+The
+.Dv GEOM_PART_PC98
+option adds support for the MBR variant as used on
NEC PC-98 computers.
-The GEOM_PART_VTOC8 option adds support for Sun's SMI VTOC8 label as
+The
+.Dv GEOM_PART_VTOC8
+option adds support for Sun's SMI VTOC8 label as
found on UltraSPARC-based computers.
.Pp
Usage of the
-.Xr gpart 8
+.Ns Nm
utility:
.Pp
.\" ==== ADD ====
@@ -123,7 +137,7 @@ utility:
.Ar geom
.\" ==== UNSET ====
.Nm
-.Cm unset
+.Cm unset
.Fl a Ar attrib
.Fl i Ar index
.Op Fl f Ar flags
@@ -134,7 +148,7 @@ The
.Nm
utility is used to partition GEOM providers, normally disks.
The first argument of which is the action to be taken:
-.Bl -tag -width ".Cm wwwwwww"
+.Bl -tag -width ".Cm bootcode"
.\" ==== ADD ====
.It Cm add
Add a new partition to the partitioning scheme given by
@@ -148,13 +162,15 @@ option.
The type of the partition is given by the
.Fl t Ar type
option.
-Partition types are discussed in the section entitled "Partition Types".
+Partition types are discussed below in the section entitled
+.Sx "PARTITION TYPES" .
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl i Ar index
The index in the partition table at which the new partition is to be
-placed. The index determines the name of the device special file used
+placed.
+The index determines the name of the device special file used
to represent the partition.
.It Fl l Ar label
The label attached to the partition.
@@ -162,7 +178,9 @@ This option is only valid when used on partitioning schemes that support
partition labels.
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== BOOTCODE ====
@@ -185,7 +203,7 @@ The
option specifies a file that contains the bootstrap code.
The contents and size of the file are determined by the partitioning
scheme.
-For the MBR scheme, it's a 512 byte file of which the first 446 bytes
+For the MBR scheme, it is a 512 byte file of which the first 446 bytes
are installed as bootstrap code.
The
.Fl p Ar partcode
@@ -196,11 +214,13 @@ The partition is specified by the
option.
The size of the file must be smaller than the size of the partition.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== COMMIT ====
@@ -229,8 +249,8 @@ option determines the scheme to use.
The kernel needs to have support for a particular scheme before
that scheme can be used to partition a disk.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl n Ar entries
The number of entries in the partition table.
Every partitioning scheme has a minimum and a maximum number of entries
@@ -242,7 +262,9 @@ By default, partition tables are created with the minimum number of
entries.
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== DELETE ====
@@ -254,11 +276,13 @@ and further identified by the
option.
The partition cannot be actively used by the kernel.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== DESTROY ====
@@ -266,11 +290,13 @@ about its use.
Destroy the partitioning scheme as implemented by geom
.Ar geom .
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== MODIFY ====
@@ -290,22 +316,26 @@ option.
Not all partitioning schemes support labels and it is invalid to
try to change a partition label in such cases.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== SET ====
.It Cm set
Set the named attribute on the partition entry.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.\" ==== SHOW ====
@@ -314,7 +344,8 @@ Show the current partition information of the specified geoms
or all geoms if none are specified.
.\" ==== UNDO ====
.It Cm undo
-Revert any pending changes.
+Revert any pending changes for geom
+.Ar geom .
This action is the opposite of the
.Cm commit
action and can be used to undo any changes that have not been committed.
@@ -322,11 +353,13 @@ action and can be used to undo any changes that have not been committed.
.It Cm unset
Clear the named attribute on the partition entry.
.Pp
-Addition options include:
-.Bl -tag -width ".Fl w Ar wwwwwww"
+Additional options include:
+.Bl -tag -width 10n
.It Fl f Ar flags
Additional operational flags.
-See the section entitled "Operational flags" below for a discussion
+See the section entitled
+.Sx "OPERATIONAL FLAGS"
+below for a discussion
about its use.
.El
.El
@@ -338,47 +371,82 @@ utility uses symbolic names for common partition types to avoid that the
user needs to know what the partitioning scheme in question is and what
the actual number or identification needs to be used for a particular
type.
-the
+The
.Nm
utility also allows the user to specify scheme-specific partition types
-for partition types that don't have symbol names.
+for partition types that do not have symbol names.
The symbolic names currently understood are:
-.Bl -tag -width "wwwwwwwwwwwww"
-.It efi
+.Bl -tag -width ".Cm freebsd-vinum"
+.It Cm efi
The system partition for computers that use the Extensible Firmware
Interface (EFI).
In such cases, the GPT partitioning scheme is being used and the
actual partition type for the system partition can also be specified as
-"!c12a7328-f81f-11d2-ba4b-00a0c93ec93ab".
-.It freebsd
-A FreeBSD partition that uses the BSD disklabel to sub-divide the
+.Qq Li "!c12a7328-f81f-11d2-ba4b-00a0c93ec93ab" .
+.It Cm freebsd
+A
+.Fx
+partition that uses the
+.Bx
+disklabel to sub-divide the
partition into file systems.
This is a legacy partition type and should not be used for the APM
or GPT schemes.
-The scheme-specific types are "!165" for MBR, "!FreeBSD" for APM, and
-"!516e7cb4-6ecf-11d6-8ff8-00022d09712b" for GPT.
-.It freebsd-boot
-A FreeBSD partition dedicated to bootstrap code.
-The scheme-specific type is "!83bd6b9d-7f41-11dc-be0b-001560b84f0f" for GPT.
-.It freebsd-swap
-A FreeBSD partition dedicated to swap space.
-The scheme-specific types are "!FreeBSD-swap" for APM, and
-"!516e7cb5-6ecf-11d6-8ff8-00022d09712b" for GPT.
-.It freebsd-ufs
-A FreeBSD partition that contains a UFS or UFS2 file system.
-the scheme-specific types are "!FreeBSD-UFS" for APM, and
-"!516e7cb6-6ecf-11d6-8ff8-00022d09712b" for GPT.
-.It freebsd-vinum
-A FreeBSD partition that contains a Vinum volume.
-The scheme-specific types are "!FreeBSD-Vinum" for APM, and
-"!516e7cb8-6ecf-11d6-8ff8-00022d09712b" for GPT.
-.It freebsd-zfs
-A FreeBSD partition that contains a ZFS volume.
-The scheme-specific types are "!FreeBSD-ZFS" for APM, and
-"!516e7cba-6ecf-11d6-8ff8-00022d09712b" for GPT.
-.It mbr
+The scheme-specific types are
+.Qq Li "!165"
+for MBR,
+.Qq Li "!FreeBSD"
+for APM, and
+.Qq Li "!516e7cb4-6ecf-11d6-8ff8-00022d09712b"
+for GPT.
+.It Cm freebsd-boot
+A
+.Fx
+partition dedicated to bootstrap code.
+The scheme-specific type is
+.Qq Li "!83bd6b9d-7f41-11dc-be0b-001560b84f0f"
+for GPT.
+.It Cm freebsd-swap
+A
+.Fx
+partition dedicated to swap space.
+The scheme-specific types are
+.Qq Li "!FreeBSD-swap"
+for APM, and
+.Qq Li "!516e7cb5-6ecf-11d6-8ff8-00022d09712b"
+for GPT.
+.It Cm freebsd-ufs
+A
+.Fx
+partition that contains a UFS or UFS2 file system.
+The scheme-specific types are
+.Qq Li "!FreeBSD-UFS"
+for APM, and
+.Qq Li "!516e7cb6-6ecf-11d6-8ff8-00022d09712b"
+for GPT.
+.It Cm freebsd-vinum
+A
+.Fx
+partition that contains a Vinum volume.
+The scheme-specific types are
+.Qq Li "!FreeBSD-Vinum"
+for APM, and
+.Qq Li "!516e7cb8-6ecf-11d6-8ff8-00022d09712b"
+for GPT.
+.It Cm freebsd-zfs
+A
+.Fx
+partition that contains a ZFS volume.
+The scheme-specific types are
+.Qq Li "!FreeBSD-ZFS"
+for APM, and
+.Qq Li "!516e7cba-6ecf-11d6-8ff8-00022d09712b"
+for GPT.
+.It Cm mbr
A partition that is sub-partitioned by a master boot record (MBR).
-This type is known as "!024dee41-33e7-11d3-9d69-0008c781f39f" by GPT.
+This type is known as
+.Qq Li "!024dee41-33e7-11d3-9d69-0008c781f39f"
+by GPT.
.El
.Sh OPERATIONAL FLAGS
Actions other than the
@@ -391,10 +459,12 @@ option.
This option is used to specify action-specific operational flags.
By default, the
.Nm
-utility defines the 'C' flag so that the action is immediately
+utility defines the
+.Ql C
+flag so that the action is immediately
committed.
The user can specify
-.Fl f Ar x
+.Dq Fl f Cm x
to have the action result in a pending change that can later, with
other pending changes, be committed as a single compound change with
the
@@ -417,31 +487,33 @@ Embed GPT bootstrap code into protective MBR.
.Ed
.Pp
Create a dedicated
-.Pa freebsd-boot
-partition that can boot FreeBSD from a
-.Pa freebsd-ufs
+.Cm freebsd-boot
+partition that can boot
+.Fx
+from a
+.Cm freebsd-ufs
partition, and install bootstrap code into it.
This partition must be larger than
.Pa /boot/gptboot ,
or the GPT boot you are planning to write.
A size of 15 blocks (7680 bytes) would be sufficient for
-booting from UFS but lets use 128 blocks (64 KB) here in
+booting from UFS but let's use 128 blocks (64 KB) here in
this example, in order to reserve some space for potential
-future need (e.g. from a ZFS partition).
+future need (e.g.\& from a ZFS partition).
.Bd -literal -offset indent
/sbin/gpart add -b 34 -s 128 -t freebsd-boot ad0
/sbin/gpart bootcode -p /boot/gptboot -i 1 ad0
.Ed
.Pp
Create a 512MB-sized
-.Pa freebsd-ufs
+.Cm freebsd-ufs
partition that would contain UFS where the system boot from.
.Bd -literal -offset indent
/sbin/gpart add -b 162 -s 1048576 -t freebsd-ufs ad0
.Ed
.Sh SEE ALSO
.Xr geom 4 ,
-.Xr geom 8 ,
+.Xr geom 8
.Sh HISTORY
The
.Nm
OpenPOWER on IntegriCloud