~ci-train-bot/ubuntu-system-image/system-image-ubuntu-xenial-landing-023

« back to all changes in this revision

Viewing changes to cli-manpage.rst

  • Committer: Barry Warsaw
  • Date: 2016-03-02 20:37:46 UTC
  • mfrom: (0.3.5)
  • mto: This revision was merged to the branch mainline in revision 246.
  • Revision ID: barry@python.org-20160302203746-co21wt551lndpu84
* New upstream release.
  - LP: #1386302 - In ``system-image-cli``, add a ``-m``/``--maximage``
    flag which can be used to cap a winning upgrade path to a maximum
    image number.
  - LP: #1380678 - Remove the previously deprecated ``Info()`` D-Bus method.
  - Remove the previously deprecated ``--no-reboot`` command line option.
  - LP: #1508081 - Add support for temporarily overriding the wifi-only
    setting when using ubuntu-download-manager:
    + Added ``ForceAllowGSMDownload()`` method to the D-Bus API.
    + Added ``DownloadStarted`` D-Bus signal, which gets sent when the
      download for an update has begun.
    + Added ``--override-gsm`` flag to ``system-image-cli``.
* d/control: Add python3-dbusmock to Build-Depends.
* d/tests/control: ADd python3-dbusmock as a dependency for dryrun.

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
------------------------------------------------
8
8
 
9
9
:Author: Barry Warsaw <barry@ubuntu.com>
10
 
:Date: 2015-01-15
11
 
:Copyright: 2013-2015 Canonical Ltd.
12
 
:Version: 3.0
 
10
:Date: 2016-02-25
 
11
:Copyright: 2013-2016 Canonical Ltd.
 
12
:Version: 3.1
13
13
:Manual section: 1
14
14
 
15
15
 
58
58
-d DEVICE, --device DEVICE
59
59
    Override the device name just this once.
60
60
 
61
 
--f FILTER, --filter FILTER
 
61
-f FILTER, --filter FILTER
62
62
    Filter the candidate upgrade paths to only contain full or delta updates.
63
63
    ``FILTER`` must be either ``full`` or ``delta``.
64
64
 
 
65
-m IMAGENO, --maximage IMAGENO
 
66
    Cap a winning upgrade path to image number ``IMAGENO``.  All images with a
 
67
    version number greater than ``IMAGENO`` will be ignored.  For example, if
 
68
    the winning upgrade path is ``200:204:304`` and you give ``-m 205``, the
 
69
    upgrade will not include image number 304.  Note that this capping happens
 
70
    *after* the winning upgrade path is selected.
 
71
 
65
72
-i, --info
66
73
    Show some information about the current device, including the current
67
74
    build number, device name, and channel, then exit.
77
84
-g, --no-apply
78
85
    Downloads all files and prepares for, but does not actually apply the
79
86
    update.  On devices which require a reboot to apply the update, no reboot
80
 
    is performed.  *New in system-image 3.0: --no-reboot is renamed to
81
 
    --no-apply*
 
87
    is performed.
82
88
 
83
89
-v, --verbose
84
90
    Increase the logging verbosity.  With one ``-v``, logging goes to the
120
126
    Deletes the given key from the settings database.  If the key does not
121
127
    exist, this is a no-op.  May be given multiple times.
122
128
 
 
129
--override-gsm
 
130
    Allows an update to proceed while the device is on GSM and currently set
 
131
    to only use wifi.  This is only effective when using
 
132
    ``ubuntu-download-manager``.
 
133
    **New in system-image 3.1.**
 
134
 
123
135
 
124
136
FILES
125
137
=====