diff options
author | Zac Medico <zmedico@gentoo.org> | 2018-03-30 01:12:19 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2018-04-02 09:53:24 -0700 |
commit | 5f29f03d0d9714082fabbbae5cead8857fbc9093 (patch) | |
tree | f2526ed0fcf3b948d5d719c7240c94978019b618 /man/portage.5 | |
parent | Add retry decorator (API inspired by tenacity) (diff) | |
download | portage-5f29f03d0d9714082fabbbae5cead8857fbc9093.tar.gz portage-5f29f03d0d9714082fabbbae5cead8857fbc9093.tar.bz2 portage-5f29f03d0d9714082fabbbae5cead8857fbc9093.zip |
rsync: add key refresh retry (bug 649276)
Since key refresh is prone to failure, retry using exponential
backoff with random jitter. This adds the following sync-openpgp-*
configuration settings:
sync-openpgp-key-refresh-retry-count = 40
Maximum number of times to retry key refresh if it fails. Between
each key refresh attempt, there is an exponential delay with a
constant multiplier and a uniform random multiplier between 0 and 1.
sync-openpgp-key-refresh-retry-delay-exp-base = 2
The base of the exponential expression. The exponent is the number
of previous refresh attempts.
sync-openpgp-key-refresh-retry-delay-max = 60
Maximum delay between each retry attempt, in units of seconds. This
places a limit on the length of the exponential delay.
sync-openpgp-key-refresh-retry-delay-mult = 4
Multiplier for the exponential delay.
sync-openpgp-key-refresh-retry-overall-timeout = 1200
Combined time limit for all refresh attempts, in units of seconds.
Bug: https://bugs.gentoo.org/649276
Diffstat (limited to 'man/portage.5')
-rw-r--r-- | man/portage.5 | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/man/portage.5 b/man/portage.5 index 549c51c73..2c3a75ccd 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -1,4 +1,4 @@ -.TH "PORTAGE" "31" "May 2017" "Portage VERSION" "Portage" +.TH "PORTAGE" "31" "Apr 2018" "Portage VERSION" "Portage" .SH NAME portage \- the heart of Gentoo .SH "DESCRIPTION" @@ -1081,6 +1081,25 @@ only for protocols supporting cryptographic verification, provided that the respective verification option is enabled. If unset, the user's keyring is used. .TP +.B sync\-openpgp\-key\-refresh\-retry\-count = 40 +Maximum number of times to retry key refresh if it fails. Between each +key refresh attempt, there is an exponential delay with a constant +multiplier and a uniform random multiplier between 0 and 1. +.TP +.B sync\-openpgp\-key\-refresh\-retry\-delay\-exp\-base = 2 +The base of the exponential expression. The exponent is the number of +previous refresh attempts. +.TP +.B sync\-openpgp\-key\-refresh\-retry\-delay\-max = 60 +Maximum delay between each retry attempt, in units of seconds. This +places a limit on the length of the exponential delay. +.TP +.B sync\-openpgp\-key\-refresh\-retry\-delay\-mult = 4 +Multiplier for the exponential delay. +.TP +.B sync\-openpgp\-key\-refresh\-retry\-overall\-timeout = 1200 +Combined time limit for all refresh attempts, in units of seconds. +.TP .B sync-rsync-vcs-ignore = true|false Ignore vcs directories that may be present in the repository. It is the user's responsibility to set sync-rsync-extra-opts to protect vcs |