From 043d1f2004aee201ba00f65cffaab7e6feb3c31b Mon Sep 17 00:00:00 2001
From: Benedict Reuschling <bcr@FreeBSD.org>
Date: Thu, 25 Oct 2018 17:12:26 +0000
Subject: [PATCH] Describe how to install the zfs bootcode for GPT and EFI.

Submitted by:	    sineastris@gmail.com (via freebsd-doc)
---
 .../books/handbook/zfs/chapter.xml            | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
index b9c1ef5b3b..d25f283aaa 100644
--- a/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -1464,8 +1464,23 @@ Enabled the following features on 'mypool':
 	<para>The boot code on systems that boot from a pool must be
 	  updated to support the new pool version.  Use
 	  <command>gpart bootcode</command> on the partition that
-	  contains the boot code.  See &man.gpart.8; for more
-	  information.</para>
+	  contains the boot code.  There are two types of bootcode
+	  available, depending on way the system boots:
+	  <acronym>GPT</acronym> (the most common option) and
+	  <acronym>EFI</acronym> (for more modern systems).</para>
+
+	<para>For legacy boot using GPT, use the following
+	  command:</para>
+
+	<screen>&prompt.root; <userinput>gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i <replaceable>1</replaceable> <replaceable>ada1</replaceable></userinput></screen>
+
+	<para>For systems using EFI to boot, execute the following
+	  command:</para>
+
+	<screen>&prompt.root; <userinput>gpart bootcode -p /boot/boot1.efifat -i <replaceable>1</replaceable> <replaceable>ada1</replaceable></userinput></screen>
+
+	<para>Apply the bootcode to all bootable disks in the pool.
+	  See &man.gpart.8; for more information.</para>
       </warning>
     </sect2>