From owner-freebsd-doc@FreeBSD.ORG Thu Jun 21 20:42:04 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E284F1065672 for ; Thu, 21 Jun 2012 20:42:04 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from bigwig.baldwin.cx (bigknife-pt.tunnel.tserv9.chi1.ipv6.he.net [IPv6:2001:470:1f10:75::2]) by mx1.freebsd.org (Postfix) with ESMTP id B79978FC14 for ; Thu, 21 Jun 2012 20:42:04 +0000 (UTC) Received: from jhbbsd.localnet (unknown [209.249.190.124]) by bigwig.baldwin.cx (Postfix) with ESMTPSA id 279C6B922; Thu, 21 Jun 2012 16:42:04 -0400 (EDT) From: John Baldwin To: Warren Block Date: Thu, 21 Jun 2012 14:33:56 -0400 User-Agent: KMail/1.13.5 (FreeBSD/8.2-CBSD-20110714-p13; KDE/4.5.5; amd64; ; ) References: <201206210755.21402.jhb@freebsd.org> In-Reply-To: MIME-Version: 1.0 Content-Type: Text/Plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <201206211433.56632.jhb@freebsd.org> X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (bigwig.baldwin.cx); Thu, 21 Jun 2012 16:42:04 -0400 (EDT) Cc: freebsd-doc@freebsd.org Subject: Re: gptboot and zfsboot X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Jun 2012 20:42:05 -0000 On Thursday, June 21, 2012 10:38:09 am Warren Block wrote: > On Thu, 21 Jun 2012, John Baldwin wrote: > > > On Wednesday, June 20, 2012 3:59:54 pm Warren Block wrote: > >> We have no man pages for gptboot or zfsboot. Are the details of how > >> they work covered anywhere other than the source? There's a need for > >> these. > >> > >> http://forums.freebsd.org/showthread.php?t=32807 > >> http://forums.freebsd.org/showthread.php?t=32886 > > > > Note that there is no boot2(8) manpage either. Instead there is a boot(8) > > manpage. I do think boot(8) does not currently handle gptboot and zfsboot (it > > should be fairly easy to update it for gptboot), but that is the right place > > to document these I believe. > > boot(8) is kind of written around the standad boot1/boot2. It will need > a rewrite to handle the others. See the Files and Diagnostics sections > for what I mean; those are going to be different for each of the > different types. There ought to be boot2.8, gptboot.8, and zfsboot.8 > links to that page, too. > > That's all doable, but it seems like a fair amount of work to combine > disparate things that would be better separately. > > So maybe we should split the boot2 information out into boot2(8), create > a relatively-trivial gptboot(8) and a possibly-not-so-trivial > zfsboot(8). gptboot is very similar to boot2 (both use /boot.config for example with mostly similar syntax (gptboot uses ad0pX vs ad0sXa in boot2). zfsboot is quite different and probably warrants a separate page. -- John Baldwin