autosuspend - autosuspend Documentation
Contents
Bugs
Please report bugs at the project repository at https://github.com/languitar/autosuspend.
Copyright
2017, Johannes Wienke
7.2 Mar 02, 2025 AUTOSUSPEND(1)
Description
autosuspend is a daemon that periodically suspends a system on inactivity and wakes it up again
automatically in case it is needed. For this purpose, autosuspend periodically iterates a number of
user-configurable activity checks, which indicate whether an activity on the host is currently present
that should prevent the host from suspending. In case one of the checks indicates such activity, no
action is taken and periodic checking continues. Otherwise, in case no activity can be detected, this
state needs to be present for a specified amount of time before the host is suspended by autosuspend. In
addition to the activity checks, wake up checks are used to determine planned future activities of the
system (for instance, a TV recording or a periodic backup). In case such activities are known before
suspending, autosuspend triggers a command to wake up the system automatically before the soonest
activity.
If not specified via a command line argument, autosuspend looks for a default configuration at
/etc/autosuspend.conf. autosuspend.conf(5) describes the configuration file, the available checks, and
their configuration options.
Name
autosuspend - autosuspend Documentation
Options
Commandlineoptions
General syntax:
autosuspend [options] daemon|presuspend|version [subcommandoptions]
Generaloptions-h,--help
Displays an online help.
-cFILE,--configFILE
Specifies an alternate config file to use instead of the default on at /etc/autosuspend.conf.
-lFILE,--loggingFILE
Configure the logging system with the provided logging file. This file needs to follow the
conventions for Pythonloggingfiles
</usr/share/doc/python3-doc/html/library/logging.config.html#logging-config-fileformat>.
-d Configure full debug logging in the command line. Mutually exclusive to autosuspend-l.
Subcommanddaemon
Starts the continuously running daemon.
-a,--allchecks
Usually, autosuspend stops checks in each iteration as soon as the first matching check indicates
system activity. If this flag is set, all subsequent checks are still executed. Useful mostly
for debugging purposes.
-rSECONDS,--runforSECONDS
If specified, do not run endlessly. Instead, operate only for the specified amount of seconds,
then exit. Useful mostly for debugging purposes.
Subcommandpresuspend
Should be called by the system before suspending.
No options
Subcommandversion
Outputs the currently installed version of autosuspend to stdout.
No options
See Also
autosuspend.conf(5), online documentation including FAQs at https://autosuspend.readthedocs.io/Synopsis
autosuspend [options] daemon|presuspend|version [subcommandoptions]
