diff options
| author | Kristijan Gjoshev <crypter@mail.com> | 2020-02-01 18:27:08 +0100 |
|---|---|---|
| committer | Anita Zhang <the.anitazha@gmail.com> | 2020-11-05 19:59:33 +0100 |
| commit | acf24a1a84e9496e3feb09449f4cc43fe67a9a64 (patch) | |
| tree | 4f0ea72d0e2f6b20aea5c51c489574c63ec0ef81 /man/systemd.timer.xml | |
| parent | man: add <option> around default booleans in systemd.timer (diff) | |
| download | systemd-acf24a1a84e9496e3feb09449f4cc43fe67a9a64.tar.xz systemd-acf24a1a84e9496e3feb09449f4cc43fe67a9a64.zip | |
timer: add new feature FixedRandomDelay=
FixedRandomDelay=yes will use
`siphash24(sd_id128_get_machine() || MANAGER_IS_SYSTEM(m) || getuid() || u->id)`,
where || is concatenation, instead of a random number to choose a value between
0 and RandomizedDelaySec= as the timer delay.
This essentially sets up a fixed, but seemingly random, offset for each timer
iteration rather than having a random offset recalculated each time it fires.
Closes #10355
Co-author: Anita Zhang <the.anitazha@gmail.com>
Diffstat (limited to 'man/systemd.timer.xml')
| -rw-r--r-- | man/systemd.timer.xml | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index 24c6dd50f8..c4698bf4dc 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -269,6 +269,18 @@ </varlistentry> <varlistentry> + <term><varname>FixedRandomDelay=</varname></term> + + <listitem><para>Takes a boolean argument. If true, some amount of time between 0 and + <varname>RandomizedDelaySec=</varname> is chosen and added as the delay for each timer iteration. As this + delay will not be recalculated on each run, this effectively creates a fixed offset for each iteration. + The distribution between 0 and <varname>RandomizedDelaySec=</varname> is deterministic and based on + a combination of the machine ID, whether the timer is run by the user/system manager, the service manager's + user ID, and the timer's unit name. Has no effect if + <varname>RandomizedDelaySec=</varname> is set to 0. Defaults to <option>false</option>.</para></listitem> + </varlistentry> + + <varlistentry> <term><varname>OnClockChange=</varname></term> <term><varname>OnTimezoneChange=</varname></term> |