New upstream version 2017.3

This commit is contained in:
Simon McVittie committed 2017-03-10 23:16:34 +00:00
commit 057de00126
134 files changed
+7527 -2384

No files matched your search

+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin cleanup
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin cleanup
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin config-diff
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin config-diff
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin deploy
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin deploy
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin init-fs
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin init-fs
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin instutil
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin instutil
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin os-init
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin os-init
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin set-origin
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin set-origin
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin status
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin status
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin switch
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin switch
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin undeploy
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin undeploy
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin unlock
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin unlock
.\" Source: OSTree
.\" Language: English
+16 -2
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin upgrade
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin upgrade
.\" Source: OSTree
.\" Language: English
@@ -34,7 +34,10 @@ ostree-admin-upgrade \- Construct new tree from current origin and deploy it, if
\fBostree admin upgrade\fR [OPTIONS...]
.SH "DESCRIPTION"
.PP
Downloads the latest version of the current ref from the build server and deploys it, if it changed\&. Reboot the machine for the changes to take effect\&.
Downloads the latest version of the current ref from the build server and deploys it, if it changed\&. Reboot the machine for the changes to take effect\&. These phases can be split via
\fB\-\-pull\-only\fR
and
\fB\-\-deploy\-only\fR\&.
.SH "OPTIONS"
.PP
\fB\-\-os\fR="OSNAME"
@@ -42,6 +45,17 @@ Downloads the latest version of the current ref from the build server and deploy
Use a different operating system root than the current one\&.
.RE
.PP
\fB\-\-pull\-only\fR
.RS 4
Only perform a pull into the repository; do not create a deployment\&. This option can hence safely be used in a background scheduled job with the assurance of not changing system state\&.
.RE
.PP
\fB\-\-deploy\-only\fR
.RS 4
Create a new deployment from the latest commit in the tracked origin refspec\&. This option is intended to be used by a scheduled system that detected changes via
\fB\-\-pull\-only\fR, and is ready to deploy them\&.
.RE
.PP
\fB\-\-reboot\fR,\fB\-r\fR
.RS 4
Reboot after a successful upgrade\&.
+22 -1
View File
@@ -57,7 +57,10 @@ Boston, MA 02111-1307, USA.
<title>Description</title>
<para>
Downloads the latest version of the current ref from the build server and deploys it, if it changed. Reboot the machine for the changes to take effect.
Downloads the latest version of the current ref from the build
server and deploys it, if it changed. Reboot the machine for the
changes to take effect. These phases can be split via
<option>--pull-only</option> and <option>--deploy-only</option>.
</para>
</refsect1>
@@ -73,6 +76,24 @@ Boston, MA 02111-1307, USA.
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--pull-only</option></term>
<listitem><para> Only perform a pull into the repository; do not
create a deployment. This option can hence safely be used in a
background scheduled job with the assurance of not changing
system state.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--deploy-only</option></term>
<listitem><para>Create a new deployment from the latest commit
in the tracked origin refspec. This option is intended to be used
by a scheduled system that detected changes via <option>--pull-only</option>,
and is ready to deploy them.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--reboot</option>,<option>-r</option></term>
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree admin
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree admin
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree cat
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree cat
.\" Source: OSTree
.\" Language: English
+6 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree checkout
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree checkout
.\" Source: OSTree
.\" Language: English
@@ -54,6 +54,11 @@ Checkout sub\-directory PATH\&.
Keep existing directories and unchanged files, overwrite existing files\&.
.RE
.PP
\fB\-\-union\-add\fR
.RS 4
Keep existing directories and files\&.
.RE
.PP
\fB\-\-allow\-noent\fR
.RS 4
Do nothing if specified path does not exist\&.
+8
View File
@@ -89,6 +89,14 @@ Boston, MA 02111-1307, USA.
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--union-add</option></term>
<listitem><para>
Keep existing directories and files.
</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--allow-noent</option></term>
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree checksum
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree checksum
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree commit
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree commit
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree config
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree config
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree diff
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree diff
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree export
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree export
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree fsck
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree fsck
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree gpg-sign
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree gpg-sign
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree init
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree init
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree log
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree log
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree ls
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree ls
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree prune
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree prune
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree pull-local
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree pull-local
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree pull
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree pull
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree refs
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree refs
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree remote
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree remote
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree reset
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree reset
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree rev-parse
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree rev-parse
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree show
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree show
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree static-delta
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree static-delta
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree summary
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree summary
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree trivial-httpd
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree trivial-httpd
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree
.\" Source: OSTree
.\" Language: English
+36 -5
View File
@@ -2,7 +2,7 @@
.\" Title: ostree.repo-config
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree.repo-config
.\" Source: OSTree
.\" Language: English
@@ -82,10 +82,15 @@ Describes a remote repository location\&.
.PP
\fIurl\fR
.RS 4
Must be present; declares URL for accessing this remote\&. The only supported schemes are the moment are
file,
http, and
https\&.
Must be present; declares URL for accessing metadata and content for remote\&. See also
contenturl\&. The supported schemes are documented below\&.
.RE
.PP
\fIcontenturl\fR
.RS 4
Declares URL for accessing content (filez, static delta parts)\&. When specified,
url
is used just for metadata: summary, static delta "superblocks"\&.
.RE
.PP
\fIproxy\fR
@@ -140,6 +145,32 @@ file, remotes may also be specified in
\&.conf; files whose name does not end in
\&.conf
will be ignored\&.
.SH "REPOSITORY URL/CONTENTURL"
.PP
Originally, OSTree had just a
url
option for remotes\&. Since then, the
contenturl
option was introduced\&. Both of these support
file,
http, and
https
schemes\&.
.PP
Additionally, both of these can be prefixed with the string
mirrorlist=, which instructs the client that the target url is a "mirrorlist" format, which is a plain text file of newline\-separated URLs\&. Earlier URLs will be given precedence\&.
.PP
Note that currently, the
tls\-ca\-path
and
tls\-client\-cert\-path
options apply to every HTTP request, even when
contenturl
and/or
mirrorlist
are in use\&. This may change in the future to only apply to metadata (i\&.e\&.
url, not
contenturl) fetches\&.
.SH "PER\-REMOTE GPG KEYRINGS AND VERIFICATION"
.PP
OSTree supports a per\-remote GPG keyring, as well as a
+36 -4
View File
@@ -127,10 +127,16 @@ Boston, MA 02111-1307, USA.
<variablelist>
<varlistentry>
<term><varname>url</varname></term>
<listitem><para>Must be present; declares URL for accessing
this remote. The only supported schemes are the moment are
<literal>file</literal>, <literal>http</literal>, and
<literal>https</literal>.</para></listitem>
<listitem><para>Must be present; declares URL for accessing metadata and
content for remote. See also <literal>contenturl</literal>. The
supported schemes are documented below.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>contenturl</varname></term>
<listitem><para>Declares URL for accessing content (filez, static delta
parts). When specified, <literal>url</literal> is used just for
metadata: summary, static delta "superblocks".</para></listitem>
</varlistentry>
<varlistentry>
@@ -201,6 +207,32 @@ Boston, MA 02111-1307, USA.
</para>
</refsect1>
<refsect1>
<title>Repository url/contenturl</title>
<para>
Originally, OSTree had just a <literal>url</literal> option
for remotes. Since then, the <literal>contenturl</literal>
option was introduced. Both of these support
<literal>file</literal>, <literal>http</literal>, and
<literal>https</literal> schemes.
</para>
<para>
Additionally, both of these can be prefixed with the string
<literal>mirrorlist=</literal>, which instructs the client
that the target url is a "mirrorlist" format, which is
a plain text file of newline-separated URLs. Earlier
URLs will be given precedence.
</para>
<para>
Note that currently, the <literal>tls-ca-path</literal> and
<literal>tls-client-cert-path</literal> options apply to every HTTP
request, even when <literal>contenturl</literal> and/or
<literal>mirrorlist</literal> are in use. This may change in the future to
only apply to metadata (i.e. <literal>url</literal>, not
<literal>contenturl</literal>) fetches.
</para>
</refsect1>
<refsect1>
<title>Per-remote GPG keyrings and verification</title>
<para>
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: ostree.repo
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: ostree.repo
.\" Source: OSTree
.\" Language: English
+1 -1
View File
@@ -2,7 +2,7 @@
.\" Title: rofiles-fuse
.\" Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 01/19/2017
.\" Date: 03/10/2017
.\" Manual: rofiles-fuse
.\" Source: rofiles-fuse
.\" Language: English