Add a quick entry for the new 'gpt boot' directive.
authorMatthew Dillon <dillon@dragonflybsd.org>
Wed, 30 Jul 2008 01:16:29 +0000 (01:16 +0000)
committerMatthew Dillon <dillon@dragonflybsd.org>
Wed, 30 Jul 2008 01:16:29 +0000 (01:16 +0000)
sbin/gpt/gpt.8

index 19f6b5b..929aa07 100644 (file)
@@ -23,7 +23,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/sbin/gpt/gpt.8,v 1.17 2006/06/22 22:22:32 marcel Exp $
-.\" $DragonFly: src/sbin/gpt/gpt.8,v 1.5 2008/07/27 21:05:10 thomas Exp $
+.\" $DragonFly: src/sbin/gpt/gpt.8,v 1.6 2008/07/30 01:16:29 dillon Exp $
 .\"
 .Dd July 27, 2008
 .Os
@@ -156,6 +156,29 @@ UUID.
 You may also specify any symbolic name in the system
 .Xr uuids 5
 files.
+.\" ==== boot ====
+.It Nm Ic boot Ar device ...
+The
+.Ic boot
+command allows the user to create a small boot partition in a freshly
+created GPT.
+.Pp
+This command creates the small, 100MB boot partition as partition #0
+and hacks in a special 'slice 1' in the PMBR which aliases it.
+The PMBR is further modified to add the necessary boot code.
+You can then disklabel GPT partition #0 and mount it, placing the boot
+directory and kernel within.
+The boot directory must be a sub-directory, e.g. /mnt/boot in XXXs0a.
+You must also add a "vfs.root.mountfrom="filesystem:device" line to
+/mnt/boot/loader.conf to point to the actual root mount.
+For example, "ufs:da8s1a".
+.Pp
+Your root partition may be another GPT partition and you may use a 64 bit
+disklabel within that partition if you desire.  Note that the boot partition
+must use a 32 bit disklabel.
+.Pp
+WARNING WARNING!  Some BIOSes may not be able to deal with this hack,
+your mileage may vary.
 .\" ==== create ====
 .It Nm Ic create Oo Fl fp Oc Ar device ...
 The