← Back to branch summary

~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: 2015-05-08 21:41:15 UTC
  • mfrom: (0.3.2)
  • mto: (240.2.1 system-image)
  • mto: This revision was merged to the branch mainline in revision 241.
  • Revision ID: barry@python.org-20150508214115-7x9811br9w04x9ae
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
cli-manpage.rst
7
7
------------------------------------------------
8
8
 
9
9
:Author: Barry Warsaw <barry@ubuntu.com>
10
 
:Date: 2014-09-16
11
 
:Copyright: 2013-2014 Canonical Ltd.
12
 
:Version: 2.4
 
10
:Date: 2015-01-15
 
11
:Copyright: 2013-2015 Canonical Ltd.
 
12
:Version: 3.0
13
13
:Manual section: 1
14
14
 
15
15
 
68
68
 
69
69
-n, --dry-run
70
70
    Calculate and print the upgrade path, but do not download or apply it.
71
 
 
72
 
--no-reboot
73
 
    Downloads all files and prepares for a reboot into recovery, but doesn't
74
 
    actually issue the reboot.
 
71
    *New in system-image 2.5.1: output displays the target phase percentage*
 
72
 
 
73
-p VALUE, --percentage VALUE
 
74
    For testing purposes, force a device specific phase percentage.  The value
 
75
    must be an integer between 0 and 100.  *New in system-image 2.5.1*
 
76
 
 
77
-g, --no-apply
 
78
    Downloads all files and prepares for, but does not actually apply the
 
79
    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*
75
82
 
76
83
-v, --verbose
77
84
    Increase the logging verbosity.  With one ``-v``, logging goes to the
79
86
    enabled.  With two ``-v`` (or ``-vv``), logging both to the console and to
80
87
    the log file are output at ``DEBUG`` level.
81
88
 
82
 
-C FILE, --config FILE
83
 
    Use the given configuration file, otherwise use the default.  The program
84
 
    will optionally also read a ``channel.ini`` file in the same directory as
85
 
    ``FILE``.
 
89
-C DIR, --config DIR
 
90
    Use the given configuration directory, otherwise use the system default.
 
91
    The program will read all the files in this directory that begin with a
 
92
    number, followed by an underscore, and ending in ``.ini``
 
93
    (e.g. ``03_myconfig.ini``).  The files are read in sorted numerical order
 
94
    from lowest prefix number to highest, with later configuration files able
 
95
    to override any variable in any section.
86
96
 
87
97
--factory-reset
88
98
    Wipes the data partition and issues a reboot into recovery.  This
91
101
--show-settings
92
102
    Show all the key/value pairs in the settings database.
93
103
 
 
104
--progress [dots|logfile|json]
 
105
    Report progress in various ways.  `dots` prints some dots every once in a
 
106
    while to stderr; this mimic what was available in system-image 2.5.
 
107
    `logfile` prints messages at debug level to the system-image log file, and
 
108
    is also available in 2.5 (via the `--verbose` flag).  `json` prints JSON
 
109
    records to stdout.  *New in system-image 3.0*
 
110
 
94
111
--get KEY
95
112
    Print the value for the given key in the settings database.  If the key is
96
113
    missing, a default value is printed.  May be given multiple times.
107
124
FILES
108
125
=====
109
126
 
110
 
/etc/system-image/client.ini
111
 
    Default configuration file.
112
 
 
113
 
/etc/system-image/channel.ini
114
 
    Optional configuration file overrides (for the ``[service]`` section
115
 
    only).
 
127
/etc/system-image/[0-9]+*.ini
 
128
    Default configuration files.
116
129
 
117
130
 
118
131
SEE ALSO
119
132
========
120
133
 
121
 
client.ini(5), system-image-dbus(8)
 
134
system-image.ini(5), system-image-dbus(8)