Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 21 Jun 2012 14:33:56 -0400
From:      John Baldwin <jhb@freebsd.org>
To:        Warren Block <wblock@wonkity.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: gptboot and zfsboot
Message-ID:  <201206211433.56632.jhb@freebsd.org>
In-Reply-To: <alpine.BSF.2.00.1206210755280.70177@wonkity.com>
References:  <alpine.BSF.2.00.1206201352300.64840@wonkity.com> <201206210755.21402.jhb@freebsd.org> <alpine.BSF.2.00.1206210755280.70177@wonkity.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201206211433.56632.jhb>