packaging
/
ostree
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

manual/repo.md: reword bits about the summary file 

Closes: #459
Approved by: cgwalters
This commit is contained in:
Jonathan Lebon 2016-08-10 15:11:14 -04:00 committed by Atomic Bot
parent 0728304a8a
commit fa59f5adfb
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/manual/repo.md
View File

@ -113,7 +113,7 @@ that.
A later addition to OSTree is the concept of a "summary" file, created A later addition to OSTree is the concept of a "summary" file, created
via the `ostree summary -u` command. This was introduced for a few via the `ostree summary -u` command. This was introduced for a few
reasons. A primary use case is to be a target a reasons. A primary use case is to be compatible with
[Metalink](https://en.wikipedia.org/wiki/Metalink), which requires a [Metalink](https://en.wikipedia.org/wiki/Metalink), which requires a
single file with a known checksum as a target. single file with a known checksum as a target.
@ -126,12 +126,12 @@ The summary file primarily contains two mappings:
This currently means that it grows linearly with both items. On the This currently means that it grows linearly with both items. On the
other hand, using the summary file, a client can enumerate branches. other hand, using the summary file, a client can enumerate branches.
Further, the summary file is fetched over e.g. pinned TLS, this Further, fetching the summary file over e.g. pinned TLS creates a strong
creates a strong end-to-end verification of the commit or static delta. end-to-end verification of the commit or static delta.
The summary file can also be GPG signed (detached), and currently this The summary file can also be GPG signed (detached). This is currently
is the only way provide GPG signatures (transitively) on deltas. the only way to provide GPG signatures (transitively) on deltas.
If a repository administrator creates a summary file, they must If a repository administrator creates a summary file, they must
thereafter run `ostree summary -u` to update it whenever a commit is thereafter run `ostree summary -u` to update it whenever a ref is
made or a static delta is generated. updated or a static delta is generated.