From owner-freebsd-fs@FreeBSD.ORG  Tue Feb  4 20:13:56 2014
Return-Path: <owner-freebsd-fs@FreeBSD.ORG>
Delivered-To: fs@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id BC7367AD;
 Tue,  4 Feb 2014 20:13:56 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 66C1A1601;
 Tue,  4 Feb 2014 20:13:56 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id s14KDsoL039959;
 Tue, 4 Feb 2014 13:13:54 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s14KDseU039956;
 Tue, 4 Feb 2014 13:13:54 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Tue, 4 Feb 2014 13:13:54 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Scot Hetzel <swhetzel@gmail.com>
Subject: Re: zfs boot manual pages
In-Reply-To: <CACdU+f-mjkLTJj2TChspvs+TSGgbYo48+7c4n+OYy6ERzj-46g@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1402041301220.38916@wonkity.com>
References: <201301251633.r0PGX15j040754@svn.freebsd.org>
 <5102B7A5.7030105@FreeBSD.org>
 <alpine.BSF.2.00.1307022125160.58832@wonkity.com>
 <51F0F0FE.6030208@FreeBSD.org>
 <alpine.BSF.2.00.1307281800200.12706@wonkity.com>
 <51F60897.1020005@FreeBSD.org>
 <alpine.BSF.2.00.1307291401500.46556@wonkity.com>
 <52E22240.5050501@FreeBSD.org>
 <alpine.BSF.2.00.1401241845360.92265@wonkity.com>
 <alpine.BSF.2.00.1401241856260.93615@wonkity.com>
 <alpine.BSF.2.00.1401241901580.93615@wonkity.com>
 <52F0F0EC.5090902@FreeBSD.org>
 <CACdU+f-mjkLTJj2TChspvs+TSGgbYo48+7c4n+OYy6ERzj-46g@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Tue, 04 Feb 2014 13:13:54 -0700 (MST)
Cc: freebsd-doc@freebsd.org, FreeBSD Current <freebsd-current@freebsd.org>,
 freebsd-fs <fs@freebsd.org>, Andriy Gapon <avg@freebsd.org>
X-BeenThere: freebsd-fs@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Filesystems <freebsd-fs.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-fs>,
 <mailto:freebsd-fs-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-fs/>
List-Post: <mailto:freebsd-fs@freebsd.org>
List-Help: <mailto:freebsd-fs-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-fs>,
 <mailto:freebsd-fs-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 04 Feb 2014 20:13:56 -0000

On Tue, 4 Feb 2014, Scot Hetzel wrote:

> On Tue, Feb 4, 2014 at 7:53 AM, Andriy Gapon <avg@freebsd.org> wrote:
>>
>> I've started working on manual pages for the zfs boot chain.
>>
>> Please [p]review my work in progress here:
>> https://github.com/avg-I/freebsd/compare/review;zfs-boot-man-pages
>>
>> Any additions, corrections, suggestions and other kinds of reviewing are
>> welcome.  Patches and pull requests are very welcome!
>>
>> Many thanks to Warren Block for the initial review and many fixes.
>
> One fix for the gptzfsboot man page would be to mention that
> gptzfsboot is installed into a GPT partition of type freebsd-boot, and
> that the -i 1 refers to the GPT index for this partition.

We are missing that from the gptboot.8 page also.

   gptzfsboot is installed in a freebsd-boot partition, usually the
   first partition on the disk.  A ``protective MBR'' (see gpart(8)) is
   typically used in combination with gptzfsboot.

   To install gptzfsboot on the ada0 drive:

         gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0