ostree/man
Matthew Leeds 6869bada49 config: Add a core/change-update-summary option
This commits adds and implements a boolean repo config option called
"change-update-summary" which updates the summary file every time a ref
changes (additions, updates, and deletions).

The main impetus for this feature is that the `ostree create-usb` and
`flatpak create-usb` commands depend on the repo summary being up to
date. On the command line you can work around this by asking the user to
run `ostree summary --update` but in the case of GNOME Software calling
out to `flatpak create-usb` this wouldn't work because it's running as a
user and the repo is owned by root. That strategy also means flatpak
can't update the repo metadata refs for fear of invalidating the
summary.

Another use case for this relates to LAN updates. Specifically, the
component of eos-updater that generates DNS-SD records advertising ostree
refs depends on the repo summary being up to date.

Since ostree_repo_regenerate_summary() now takes an exclusive lock, this
should be safe to enable. However it's not enabled by default because of
the performance cost, and because it's more useful on clients than
servers (which likely have another mechanism for updating the summary).

Fixes https://github.com/ostreedev/ostree/issues/1664

Closes: #1681
Approved by: jlebon
2018-07-30 17:19:12 +00:00
..
ostree-admin-cleanup.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-config-diff.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-deploy.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-init-fs.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-instutil.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-os-init.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-pin.xml sysroot: Add concept of deployment "pinning" 📌 2018-02-26 19:06:59 +00:00
ostree-admin-set-origin.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-status.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-switch.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-undeploy.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-unlock.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin-upgrade.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-admin.xml admin: Fix list of subcommands in help and manpage 2018-06-12 14:36:24 +00:00
ostree-cat.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-checkout.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-checksum.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-commit.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-config.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-create-usb.xml man: Add man page for create-usb 2018-04-19 13:35:15 +00:00
ostree-diff.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-export.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-find-remotes.xml Make P2P API public (no longer experimental) 2018-06-04 19:20:10 +00:00
ostree-fsck.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-gpg-sign.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-init.xml man/ostree-init: Briefly describe various modes 2018-04-30 17:58:38 +00:00
ostree-log.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-ls.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-prune.xml docs/prune: Document that --static-deltas-only isn't that useful 2018-03-06 14:02:32 +00:00
ostree-pull-local.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-pull.xml ostree/pull: Add network-retries command line option 2018-07-05 17:59:09 +00:00
ostree-refs.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-remote.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-reset.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-rev-parse.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-show.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-static-delta.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree-summary.xml Make P2P API public (no longer experimental) 2018-06-04 19:20:10 +00:00
ostree-trivial-httpd.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree.repo-config.xml config: Add a core/change-update-summary option 2018-07-30 17:19:12 +00:00
ostree.repo.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00
ostree.xml Make P2P API public (no longer experimental) 2018-06-04 19:20:10 +00:00
rofiles-fuse.xml Add SPDX-License-Identifier to source files 2018-01-30 20:03:42 +00:00