NAME

       system-image-cli - Ubuntu System Image Upgrader command line script

SYNOPSYS

       system-image-cli [options]

DESCRIPTION

       This  script  upgrades the system to the latest available image (i.e. build number).  With
       no options, this script checks the latest version available on the server  and  calculates
       an  upgrade path to that version from the system's current version.  If an upgrade path is
       found, the relevant files are downloaded and the  upgrade  is  applied  by  rebooting  the
       system into recovery mode.

OPTIONS

       -h, --help
              Show the program's message and exit.

       --version
              Show the program's version number and exit.

       -b NUMBER, --build NUMBER
              Override  the  device's  current  build  number  just this once.  NUMBER must be an
              integer.  Use -b 0 for force an upgrade.

       -c CHANNEL, --channel CHANNEL
              Override the device's upgrade channel just this  once.   Use  in  combination  with
              --build 0 to switch channels.

       -d DEVICE, --device DEVICE
              Override the device name just this once.

       --f FILTER, --filter FILTER
              Filter  the  candidate upgrade paths to only contain full or delta updates.  FILTER
              must be either full or delta.

       -i, --info
              Show some information about the current device, including the current build number,
              device name, and channel, then exit.

       -n, --dry-run
              Calculate and print the upgrade path, but do not download or apply it.

       -v, --verbose
              Increase  the  logging  verbosity.   With  one  -v,  logging goes to the console in
              addition to the log file, and logging at INFO level is enabled.  With  two  -v  (or
              -vv), logging both to the console and to the log file are output at DEBUG level.

       -C FILE, --config FILE
              Use  the  given  configuration  file,  otherwise use the default.  The program will
              optionally also read a channel.ini file in the same directory as FILE.

       --dbus Run in D-Bus client mode.  Normally, system-image-cli  runs  directly  against  the
              internal  API.  With this switch, it instead acts as a D-Bus client, performing all
              operations against the system-image-dbus service.  This mode  more  closely  mimics
              how a user interface would perform updates.

FILES

       /etc/system-image/client.ini
              Default configuration file.

       /etc/system-image/channel.ini
              Optional configuration file overrides (for the [service] section only).

SEE ALSO

       client.ini(5), system-image-dbus(8)

AUTHOR

       Barry Warsaw <barry@ubuntu.com>

COPYRIGHT

       2013-2014 Canonical Ltd.