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.