Scroll to navigation

AUTOSUSPEND(1) autosuspend AUTOSUSPEND(1)

NAME

autosuspend - autosuspend Documentation

SYNOPSIS

autosuspend [options] daemon|presuspend|version [subcommand options]

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.

OPTIONS

Command line options

General syntax:

autosuspend [options] daemon|presuspend|version [subcommand options]


General options

Displays an online help.

Specifies an alternate config file to use instead of the default on at /etc/autosuspend.conf.

Configure the logging system with the provided logging file. This file needs to follow the conventions for Python logging files </usr/share/doc/python3-doc/html/library/logging.config.html#logging-config-fileformat>.

Configure full debug logging in the command line. Mutually exclusive to autosuspend -l.

Subcommand daemon

Starts the continuously running daemon.

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.

If specified, do not run endlessly. Instead, operate only for the specified amount of seconds, then exit. Useful mostly for debugging purposes.

Subcommand presuspend

Should be called by the system before suspending.

No options

Subcommand version

Outputs the currently installed version of autosuspend to stdout.

No options

BUGS

Please report bugs at the project repository at https://github.com/languitar/autosuspend.

SEE ALSO

autosuspend.conf(5), online documentation including FAQs at https://autosuspend.readthedocs.io/

AUTHOR

Johannes Wienke

COPYRIGHT

2024, Johannes Wienke

November 10, 2024 7.0