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

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

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

.. code-block:: shell

  ishmael ~ # bastille update 11.4-RELEASE
  Looking up update.FreeBSD.org mirrors... 2 mirrors found.
  Fetching metadata signature for 11.4-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.4-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 13.2-RELEASE
  Looking up update.FreeBSD.org mirrors... 2 mirrors found.
  Fetching metadata signature for 13.2-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 13.2-RELEASE-p4:
  ...[snip]...

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