aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarius Strobl <marius@FreeBSD.org>2010-06-12 00:28:41 +0000
committerMarius Strobl <marius@FreeBSD.org>2010-06-12 00:28:41 +0000
commitefd6236a6a460a28da69f32bc66165c135ca91d9 (patch)
tree1799ae980bfd3655057b9e27bb06c14cf935267b
parent0902c96de796d4b1310cf199e2fe4f11c2c525bb (diff)
downloadsrc-efd6236a6a460a28da69f32bc66165c135ca91d9.tar.gz
src-efd6236a6a460a28da69f32bc66165c135ca91d9.zip
MFC: r208778
- Mention that VTOC8 labels are found in Fujitsu SPARC64 machines as well. - Add information regarding VTOC8 bootrstrap code and how it's handled with r208777 in place. - Document the mapping of partition types to VTOC8 tags. - Add examples for VTOC8 to the respective section. - Eliminated hard sentence breaks. Reviewed by: marcel (slightly buggy version) Approved by: re (bz)
Notes
Notes: svn path=/stable/8/; revision=209083
-rw-r--r--sbin/geom/class/part/gpart.849
1 files changed, 38 insertions, 11 deletions
diff --git a/sbin/geom/class/part/gpart.8 b/sbin/geom/class/part/gpart.8
index 6deea8cd2ab3..9c984733c4d2 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 June 3, 2010
.Dt GPART 8
.Os
.Sh NAME
@@ -53,7 +53,10 @@ found on PCs and used on many removable media.
The 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
-found on UltraSPARC-based computers.
+found on computers based on
+.Tn SPARC64
+and
+.Tn UltraSPARC.
.Pp
Usage of the
.Xr gpart 8
@@ -191,9 +194,15 @@ The
.Fl p Ar partcode
option specifies a file that contains the bootstrap code intended to be
written to a partition.
+For the VTOC8 scheme, it is a 8192 byte file of which the last 7680 bytes
+are installed as bootstrap code.
The partition is specified by the
.Fl i Ar index
option.
+For the VTOC8 scheme, if the
+.Fl i Ar index
+option is omitted, the bootstrap code is written to all sufficiently large
+partitions.
The size of the file must be smaller than the size of the partition.
.Pp
Addition options include:
@@ -362,20 +371,20 @@ 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.
+The scheme-specific types are "!FreeBSD-swap" for APM,
+"!516e7cb5-6ecf-11d6-8ff8-00022d09712b" for GPT, and tag 0x0901 for VTOC8.
.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.
+the scheme-specific types are "!FreeBSD-UFS" for APM,
+"!516e7cb6-6ecf-11d6-8ff8-00022d09712b" for GPT, and tag 0x0902 for VTOC8.
.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.
+The scheme-specific types are "!FreeBSD-Vinum" for APM,
+"!516e7cb8-6ecf-11d6-8ff8-00022d09712b" for GPT, and tag 0x0903 for VTOC8.
.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.
+The scheme-specific types are "!FreeBSD-ZFS" for APM,
+"!516e7cba-6ecf-11d6-8ff8-00022d09712b" for GPT, and 0x0904 for VTOC8.
.It 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.
@@ -435,10 +444,28 @@ future need (e.g. from a ZFS partition).
.Pp
Create a 512MB-sized
.Pa freebsd-ufs
-partition that would contain UFS where the system boot from.
+partition that would contain UFS where the system boots from.
.Bd -literal -offset indent
/sbin/gpart add -b 162 -s 1048576 -t freebsd-ufs ad0
.Ed
+.Pp
+Create VTOC8 scheme on
+.Pa da0 .
+.Bd -literal -offset indent
+/sbin/gpart create -s VTOC8 da0
+.Ed
+.Pp
+Create a 512MB-sized
+.Cm freebsd-ufs
+partition that would contain UFS where the system boots from.
+.Bd -literal -offset indent
+/sbin/gpart add -b 0 -s 1048576 -t freebsd-ufs da0
+.Ed
+.Pp
+After having created all required partitions, embed bootstrap code into them.
+.Bd -literal -offset indent
+/sbin/gpart bootcode -p /boot/boot1 da0
+.Ed
.Sh SEE ALSO
.Xr geom 4 ,
.Xr geom 8 ,