systemd/docs
Arthur Shau cc0ab8c810 timer: introduce DeferReactivation setting
By default, in instances where timers are running on a realtime schedule,
if a service takes longer to run than the interval of a timer, the
service will immediately start again when the previous invocation finishes.
This is caused by the fact that the next elapse is calculated based on
the last trigger time, which, combined with the fact that the interval
is shorter than the runtime of the service, causes that elapse to be in
the past, which in turn means the timer will trigger as soon as the
service finishes running.

This behavior can be changed by enabling the new DeferReactivation setting,
which will cause the next calendar elapse to be calculated based on when
the trigger unit enters inactivity, rather than the last trigger time.

Thus, if a timer is on an realtime interval, the trigger will always
adhere to that specified interval.
E.g. if you have a timer that runs on a minutely interval, the setting
guarantees that triggers will happen at *:*:00 times, whereas by default
this may skew depending on how long the service runs.

Co-authored-by: Matteo Croce <teknoraver@meta.com>
2024-10-11 22:54:16 +02:00
..
_data docs: drop outdated documents about os-release and cgroupsv1 2024-05-01 01:30:12 +01:00
_includes docs: update footer to 2024 2024-03-16 03:14:23 +09:00
_layouts docs: adapt forward layout to systemd.io design 2022-05-21 18:09:50 +02:00
assets docs/DEBUGGING: add screenshot and fix path to it 2024-03-27 06:53:46 +01:00
fonts docs: make it pretty 2019-12-11 17:04:20 +01:00
sysvinit man: update links to "Compatibility with SysV" 2024-05-28 14:46:44 +02:00
var-log tree-wide: use https for the 0pointer.de doc links 2023-06-23 13:46:56 +01:00
_config.yml Revert "docs: don't suffix page permalink with a slash" 2024-04-17 20:53:49 +02:00
.gitattributes docs: mark spdx headers with the default license to website files 2021-10-18 09:43:18 +02:00
.gitignore gitignore: add jekyll cache directory 2021-06-24 10:20:29 +02:00
API_FILE_SYSTEMS.md docs/API_FILE_SYSTEM: format text 2024-03-27 07:11:53 +01:00
APPSTREAM_BUNDLE.md sysupdate: Support changelogs & appstream metadata 2024-07-12 14:38:09 +01:00
ARCHITECTURE.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
AUTOMATIC_BOOT_ASSESSMENT.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
BACKPORTS.md docs/BACKPORTS: format text 2024-03-27 07:11:54 +01:00
BLOCK_DEVICE_LOCKING.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
BOOT_LOADER_INTERFACE.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
BOOT_LOADER_SPECIFICATION.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
BOOT.md Change OS X to macOS in BOOT.md (#34358) 2024-09-11 09:15:39 +02:00
BUILDING_IMAGES.md docs/BUILDING_IMAGES: format text 2024-03-27 07:11:55 +01:00
CATALOG.md docs/CATALOG: format text 2024-03-27 07:11:55 +01:00
CGROUP_DELEGATION.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
CODE_OF_CONDUCT.md docs/CODE_OF_CONDUCT: format text 2024-03-27 07:11:55 +01:00
CODE_QUALITY.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
CODING_STYLE.md docs/CODING_STYLE: document that we nowadays prefer (const char*) for func ret type 2024-07-02 23:35:58 +02:00
CONTAINER_INTERFACE.md docs: Mention the new mount API in the container interface doc 2024-08-13 12:20:43 +02:00
CONTRIBUTING.md docs/CONTRIBUTING.md: Fix links in CONTRIBUTING 2024-05-28 12:53:18 +02:00
CONTROL_GROUP_INTERFACE.md CONTROL_GROUP_INTERFACE: fix link to systemd-run code 2024-09-17 15:09:48 +09:00
CONVERTING_TO_HOMED.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
COREDUMP_PACKAGE_METADATA.md docs: rename COREDUMP_PACKAGE_METADATA → ELF_PACKAGE_METADATA 2022-05-21 18:08:19 +02:00
COREDUMP.md treewide: fix a few typos in NEWS, docs, comments, and log messages 2024-04-27 12:11:13 +02:00
CREDENTIALS.md docs: minor improvements to CREDENTIALS.md 2024-05-07 11:02:31 +02:00
DAEMON_SOCKET_ACTIVATION.md docs/DAEMON_SOCKET_ACTIVATION 2024-06-03 15:22:54 +09:00
DEBUGGING.md docs/DEBUGGING.md: use an underscore in the kernel command line option 2024-04-29 14:16:57 +02:00
DESKTOP_ENVIRONMENTS.md docs/DESKTOP_ENVIRONMENTS: fix formatting 2024-10-11 10:28:22 +02:00
DISCOVERABLE_PARTITIONS.md docs: DPS and BLS have moved to uapi-group.org 2022-11-02 07:31:18 +09:00
DISTRO_PORTING.md docs/DISTRO_PORTING: format text 2024-03-27 07:12:04 +01:00
ELF_DLOPEN_METADATA.md docs/ELF_DLOPEN_METADATA: add detailed example 2024-09-13 14:53:17 +02:00
ELF_PACKAGE_METADATA.md docs/ELF_PACKAGE_METADATA: add detailed example 2024-09-13 14:51:44 +02:00
ENVIRONMENT.md Add $SYSTEMD_IN_CHROOT to override chroot detection 2024-08-16 10:11:29 +02:00
FAQ.md docs: fix typo in filename: REATLIME -> REALTIME 2024-09-17 10:21:54 +02:00
favicon.png docs: make it pretty 2019-12-11 17:04:20 +01:00
favicon.svg docs: mark spdx headers with the default license to website files 2021-10-18 09:43:18 +02:00
FILE_DESCRIPTOR_STORE.md Fix reference to FileDescriptorStoreMax= directive 2024-09-25 16:16:29 +02:00
GROUP_RECORD.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
HACKING.md mkosi: Add back support for running clangd within mkosi 2024-09-22 15:23:01 +02:00
HOME_DIRECTORY.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
INCOMPATIBILITIES.md treewide: fix a few typos in NEWS, docs, comments, and log messages 2024-04-27 12:11:13 +02:00
index.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
INHIBITOR_LOCKS.md logind: always check for inhibitor locks 2024-07-25 12:22:36 +01:00
INITRD_INTERFACE.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
JOURNAL_EXPORT_FORMATS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
JOURNAL_FILE_FORMAT.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
JOURNAL_NATIVE_PROTOCOL.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
MEMORY_PRESSURE.md docs: fix dead link to GNOME documentation 2024-06-28 09:39:56 +02:00
MINIMAL_BUILDS.md docs/MINIMAL_BUILDS: format text 2024-03-27 07:11:58 +01:00
MOUNT_REQUIREMENTS.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
MY_SERVICE_CANT_GET_REALTIME.md docs: fix typo in filename: REATLIME -> REALTIME 2024-09-17 10:21:54 +02:00
NETWORK_ONLINE.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
OPTIMIZATIONS.md docs/OPTIMIZATIONS: format text 2024-03-27 07:11:59 +01:00
PASSWORD_AGENTS.md docs: don't mention split-usr path anymore 2024-10-11 10:27:53 +02:00
PAX_CONTROL_GROUPS.md docs: drop invalid links 2024-04-26 14:57:22 +02:00
PORTABILITY_AND_STABILITY.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
PORTABLE_SERVICES.md docs/PORTABLE_SERVICES: format text 2024-03-27 07:12:06 +01:00
PORTING_TO_NEW_ARCHITECTURES.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
PREDICTABLE_INTERFACE_NAMES.md docs/PREDICTABLE_INTERACES: format text 2024-03-27 07:26:56 +01:00
PRESET.md docs/PRESET: format text 2024-03-27 07:12:00 +01:00
RANDOM_SEEDS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
RELEASE.md docs: Document how to do stable releases 2024-07-19 16:33:36 +02:00
RESOLVED-VPNS.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
ROOT_STORAGE_DAEMONS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
SECURITY.md docs/SECURITY: format text 2024-03-27 07:12:01 +01:00
SEPARATE_USR_IS_BROKEN.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
style.css docs: desaturate dark-mode background color 2022-06-10 13:52:31 +02:00
SYSLOG.md docs/SYSLOG: format text 2024-03-27 07:12:01 +01:00
SYSTEMD_FILE_HIERARCHY_REQUIREMENTS.md docs/SYSTEMD_FILE_HIERARCHY: format text 2024-03-27 07:17:08 +01:00
TEMPORARY_DIRECTORIES.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
TESTING_WITH_SANITIZERS.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
THE_CASE_FOR_THE_USR_MERGE.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
TIPS_AND_TRICKS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
TPM2_PCR_MEASUREMENTS.md stub: Add support for .initrd addon files 2024-10-09 14:06:10 +01:00
TRANSIENT-SETTINGS.md timer: introduce DeferReactivation setting 2024-10-11 22:54:16 +02:00
TRANSLATORS.md Revert "docs: use collections to structure the data" 2024-02-23 09:48:47 +01:00
UIDS-GIDS.md docs/UIDS-GIDS: drop obsolete comment about Fedora 2024-08-31 13:36:09 +02:00
USER_GROUP_API.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
USER_NAMES.md docs/USER_NAMES: format text 2024-03-27 07:12:04 +01:00
USER_RECORD_BLOB_DIRS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
USER_RECORD.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
USERDB_AND_DESKTOPS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
VIRTUALIZED_TESTING.md docs/VIRTUALIZED_TESTING: format text 2024-03-27 07:26:55 +01:00
VM_INTERFACE.md docs: fix typo 2024-03-15 04:04:01 +09:00
WRITING_DESKTOP_ENVIRONMENTS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00
WRITING_DISPLAY_MANAGERS.md docs: drop link to obsolete multiseat page 2024-05-28 14:48:56 +02:00
WRITING_NETWORK_CONFIGURATION_MANAGERS.md docs/WRITING_NETWORK_CONFIG_MANAGERS: format text 2024-03-27 07:31:54 +01:00
WRITING_RESOLVER_CLIENTS.md docs/WRITING_RESOLVER_CLIENTS: update manpage link 2024-03-27 07:11:50 +01:00
WRITING_VM_AND_CONTAINER_MANAGERS.md docs: use absolute links for our pages 2024-04-17 21:21:23 +02:00