From c19559c1fec87145ac1878883d3420524ce56a4b Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Thu, 21 Apr 2016 01:56:43 +0000
Subject: [PATCH] Add a tip on setting ezjail to download packages using HTTP
 rather than FTP.  The content from the bug report was rewritten.

PR:		208941
Submitted by:	Dan Bright <freebsd@zaziork.com>
---
 en_US.ISO8859-1/books/handbook/jails/chapter.xml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/en_US.ISO8859-1/books/handbook/jails/chapter.xml b/en_US.ISO8859-1/books/handbook/jails/chapter.xml
index a2c03e3108..1bd2647450 100644
--- a/en_US.ISO8859-1/books/handbook/jails/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/jails/chapter.xml
@@ -1121,6 +1121,22 @@ Created clone interfaces: lo1.</screen>
 	  jail.  <filename>/var/ports</filename> inside each jail is
 	  also used as a work directory when building ports.</para>
       </tip>
+
+      <tip>
+	<para>The <acronym>FTP</acronym> protocol is used by default
+	  to download packages for the installation of the basejail.
+	  Firewall or proxy configurations can prevent or interfere
+	  with <acronym>FTP</acronym> transfers.  The
+	  <acronym>HTTP</acronym> protocol works differently and
+	  avoids these problems.  It can be chosen by specifying a
+	  full <acronym>URL</acronym> for a particular download mirror
+	  in <filename>/usr/local/etc/ezjail.conf</filename>:</para>
+
+	<programlisting>ezjail_ftphost=http://<replaceable>ftp.FreeBSD.org</replaceable></programlisting>
+
+	<para>See <xref linkend="mirrors-ftp"/> for a list of
+	  sites.</para>
+      </tip>
     </sect2>
 
     <sect2 xml:id="jails-ezjail-create">