svn commit: r209084 - stable/7/sbin/geom/class/part

[Marius Strobl]

Author: marius
Date: Sat Jun 12 00:28:53 2010
New Revision: 209084
URL: http://svn.freebsd.org/changeset/base/209084

Log:
  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)

Modified:
  stable/7/sbin/geom/class/part/gpart.8
Directory Properties:
  stable/7/sbin/geom/class/part/   (props changed)

Modified: stable/7/sbin/geom/class/part/gpart.8
==============================================================================
--- stable/7/sbin/geom/class/part/gpart.8	Sat Jun 12 00:28:41 2010	(r209083)
+++ stable/7/sbin/geom/class/part/gpart.8	Sat Jun 12 00:28:53 2010	(r209084)
@@ -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 
 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 bootstr
 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 ,