#! /bin/sh

#  We have removed the ability for auto-firmware upgrade from our code,
#  This script should be removed in a future release when it is no
#  longer necessary on OneFS upgrades.  Until then, simply have the
#  script return True all the time.  See the "Note" at bottom of comments!
#  Retaining original comments below:

#  This script is for use by the update engine only.  Its purpose is to
#  contain the knowledge for how to update the firmware to the new images
#  while running in the old environment.  This is to be adjusted as necessary
#  to circumstances such as
#    a)  The new release wants to update firmware that the old environment
#        does not know about
#    b)  The new release contains changes that are incompatible with the old
#        environment (eg, changes to kernel structures)

#  Note:  This is only called by update engines in which firmware updates
#  has been implemented.  Older update engines (Poblano/4.0, Anaheim 4.1)
#  do not have the code to call this script.

#  Usage:
#    upgrade-firmware <root_mountpoint> [-c] [-v<caller version>]
#
#  <root_mountpoint> is the mountpoint for the image of the future root 
#                    filesystem, typically /usr/update/root
#  -c indicates check-only.  No '-c' indicates updating of any & all firmware 
#     that needs updating.
#  -v indicates a version number of the source build for the purposes of this
#     script.  A typical purpose is to indicate if the source build contains
#     a bug fix or not.  

#  Current version numbers:
#     <no -v>  initial code
#     -v1      contains fix for bug 34898

#  Note:  Future releases are free to change this to python, chroot, or do
#    whatever to update firmware.

true;
