Re: zpool upgrade and bootcode on 13-RELEASE

From: Mathieu Arnold <>
Date: Fri, 28 May 2021 18:37:14 UTC
On Wed, May 19, 2021 at 07:32:43PM +0200, Michael Gmelin wrote:
> On Wed, 19 May 2021 19:09:06 +0200
> Kurt Jaeger <> wrote:
> > Hi!
> > 
> > > Does this mean, re-installing the bootcode isn't necessary anymore
> > > - or has the warning been removed by accident/as a side effect of
> > > merging with OpenZFS?  
> > 
> > On the contrary, because of the switch from FreeBSD ZFS to
> > OpenZFS, the bootcodes needs to be updated! It's unfortunate
> > that no message is displayed 8-(
> > 
> That's too bad - maybe it would make sense to mention this in the
> release errata?
> > The problem is, finding out which bootcode needs to go where etc.
> For the machines in question it was a straightforward legacy layout, so
> that was easy enough (they came back up just fine - *phew*).
> Do you think there is any chance to get the warning back in there?
> Maybe in a more generic way, like:
>   In case you're booting from <poolname>, please make sure to update
>   the bootcode according to your partition layout. See `man zfsboot'
>   for details.
> Fun fact: That man page already exists (I had no idea), but could use
> some love - e.g., add the EFI examples you gave.

I have had a look at that man page, it gives ten different commands,
without saying which you need to use, if they are all needed, or not, or
when you actually have to used them.

Fun fact is that I absolutely never ever used any of them.  All I ever
did was run:

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

because `zpool upgrade` told me to.  It would probably be great to have
that command in that man page.

Mathieu Arnold