Clean up markup (mainly).
This commit is contained in:
Ruslan Ermilov
parent
cee8119875
commit
605c493e90
@ -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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user