Index: en_US.ISO8859-1/books/handbook/jails/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/jails/chapter.xml
+++ en_US.ISO8859-1/books/handbook/jails/chapter.xml
@@ -1313,11 +1313,32 @@
updates have the same limitations as if
&man.freebsd-update.8; were being run directly. The most
important one is that only -RELEASE versions of &os; are
- available with this method. To update the basejail to the
- latest patched release of the version of &os; on the host
- computer, use:
+ available with this method.
+
+ To update a jail, such as in the case of applying a
+ security patch (updating from 10.1-RELEASE-p1 to
+ 10.1-RELEASE-p2) use:
+
+ &prompt.root; ezjail-admin update -u
+
+ To upgrade a jail (for example from 9.3-RELEASE to
+ 10.1-RELEASE), first upgrade the host system as described in
+ . Once the host has
+ been updated and rebooted, the jails can then be updated.
+ The &man.freebsd-update.8; utility has no way of telling
+ what version of &os; the jail was originally running, so the
+ version to upgrade from must be specified. Use the
+ &man.file.1; utility to determine the original version of
+ &os; that was installed in the jail:
+
+ &prompt.root; file /usr/jails/basejail/bin/sh
+/usr/jails/basejail/bin/sh: ELF 64-bit LSB executable, x86-64, version 1 (FreeBSD), dynamically linked (uses shared libs), for FreeBSD 9.3, stripped
+
+ Now use this information to perform the upgrade from
+ 9.3-RELEASE to the current version of your host
+ system:
- &prompt.root; ezjail-admin update -r
+ &prompt.root; ezjail-admin update -U -s 9.3-RELEASE
After updating the basejail, &man.mergemaster.8; can be
run to update each jail's configuration files.