1OSTREE SUMMARY(1)               ostree summary               OSTREE SUMMARY(1)
2
3
4

NAME

6       ostree-summary - Regenerate or view the summary metadata file
7

SYNOPSIS

9       ostree summary [--gpg-sign=KEYID] [--gpg-homedir=HOMEDIR]
10                      [--sign=KEYID] [--sign-type=ENGINE] {--update}
11                      [--add-metadata=KEY=VALUE...]
12
13       ostree summary {--view | --raw}
14

DESCRIPTION

16       The summary file is an optional higher level form of repository
17       metadata that describes the available branches. It needs to be manually
18       regenerated after a series of commits. Among other things, this allows
19       atomically updating multiple commits.
20

OPTIONS

22       --update,-u
23           Update the summary file. This option can be combined with
24           --add-metadata to add metadata fields to the summary.
25
26           If the repository has a collection ID configured, the
27           ostree-metadata branch for that collection ID will also be updated
28           with a new commit containing the given metadata, which will be
29           signed if the summary file is signed.
30
31       --add-metadata,-m=KEY=VALUE
32           Specify an additional metadata field to add to the summary. It must
33           be in the format KEY=VALUE or as two separate arguments. The keys
34           must be namespaced for your organisation or repository using a dot
35           prefix. The values must be in GVariant text format. For example,
36           exampleos.end-of-life "@t 1445385600". This option can be used
37           multiple times.
38
39       --view,-v
40           View the contents of the summary file in a human readable format.
41
42       --raw
43           View the raw bytes of the summary file.
44
45       --gpg-sign=KEYID
46           GPG Key ID to sign the summary with.
47
48       --gpg-homedir=HOMEDIR
49           GPG Homedir to use when looking for keyrings.
50
51       --sign-type=ENGINE
52           Use particular signature engine. Currently available ed25519 and
53           dummy signature types. The default is ed25519.
54
55       --sign="KEY-ID"
56           There KEY-ID is:
57
58           for ed25519:
59               base64-encoded secret key for commit signing.
60
61           for dummy:
62               ASCII-string used as secret key.
63
64

EXAMPLES

66       $ ostree summary -u
67
68       $ ostree summary -u -m key="'value'"
69
70       $ ostree summary -v
71
72           * ostree/1/1/0
73               Latest Commit (4.2 MB):
74                 9828ab80f357459b4ab50f0629beab2ae3b67318fc3d161d10a89fae353afa90
75               Timestamp (ostree.commit.timestamp): 2017-11-21T01:41:10-08
76               Version (ostree.commit.version): 1.2.3
77
78           Last-Modified (ostree.summary.last-modified): 2018-01-12T22:06:38-08
79
80
81
82OSTree                                                       OSTREE SUMMARY(1)
Impressum