======
update
======

The `update` command targets a release instead of a jail. Because every jail is
based on a release, when the release is updated all the jails are automatically
updated as well.

If no updates are available, a message will be shown:

.. code-block:: shell

  ishmael ~ # bastille update 11.2-RELEASE
  Looking up update.FreeBSD.org mirrors... 2 mirrors found.
  Fetching metadata signature for 11.2-RELEASE from update4.freebsd.org... done.
  Fetching metadata index... done.
  Inspecting system... done.
  Preparing to download files... done.
  
  No updates needed to update system to 11.2-RELEASE-p4.
  No updates are available to install.


The older the release, however, the more updates will be available:

.. code-block:: shell

  ishmael ~ # bastille update 10.4-RELEASE
  Looking up update.FreeBSD.org mirrors... 2 mirrors found.
  Fetching metadata signature for 10.4-RELEASE from update1.freebsd.org... done.
  Fetching metadata index... done.
  Fetching 2 metadata patches.. done.
  Applying metadata patches... done.
  Fetching 2 metadata files... done.
  Inspecting system... done.
  Preparing to download files... done.
  
  The following files will be added as part of updating to 10.4-RELEASE-p13:
  ...[snip]...

To be safe, you may want to restart any jails that have been updated live.