Available wake up checks¶

The following checks for wake up times are currently implemented. Each of them is described with its available configuration options and required optional dependencies.

Command¶

Determine wake up times from an external command.

The called command must return a timestamp in UTC or nothing in case no wake up is planned.

The command always has to succeed. If something is printed on stdout by the command, this has to be the next wake up time in UTC seconds.

The command is executed as is using shell execution. Beware of malicious commands in obtained configuration files.

Options¶

command¶: The command to execute including all arguments

File¶

Scheduled wake up from file contents.

Determines the wake up time by reading a file from a configured location. The file has to contain the planned wake up time as an int or float in seconds UTC.

Options¶

path¶: path of the file to read in case it is present

Periodic¶

Schedule periodic wake ups.

Always schedules a wake up at a specified delta from now on. Can be used to let the system wake up every once in a while, for instance, to refresh the calendar used in the wakeup-calendar check.

Options¶

unit¶

A string indicating in which unit the delta is specified. Valid options are: microseconds, milliseconds, seconds, minutes, hours, days, weeks.

Allowed values: microseconds, milliseconds, seconds, minutes, hours, days, weeks.

value¶: The value of the delta as a float.

SystemdScheduledShutdown¶

Check for a pending systemd scheduled shutdown, reboot, halt or kexec.

Ensures that the system is active shortly before an action scheduled via shutdown -r +10, systemctl poweroff --when=... or similar is due, as reported by the ScheduledShutdown property of logind. Despite the property’s name, this also covers reboots, halts and kexecs. Scheduled actions of type dry-reboot or dry-poweroff (created via --dry-run), which never actually execute, are ignored.

Options¶

delta¶

Number of seconds before the scheduled shutdown/reboot at which the system should already be running so that the scheduled action can actually execute. Default: 180.

Value must be at least 0.

SystemdTimer¶

Check for systemd timer schedules.

Ensures that the system is active when a systemd timer is scheduled to run next.

Options¶

match¶: A regular expression selecting the systemd timers to check. This expression matches against the names of the timer units, for instance logrotate.timer. Use systemctl list-timers to find out which timers exist.