gptboot and zfsboot

[John Baldwin]

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