AUTOSUSPEND.CONF(5) - Linux man page online | File formats

Autosuspend config file Documentation.

Dec 17, 2017


autosuspend.conf - autosuspend config file Documentation




Configures the autosuspend daemon. Syntax The autosuspend configuration file uses INI syntax and needs to be processable by the Python configparser module. A simple configuration file could look like: [general] interval = 30 idle_time = 900 suspend_cmd = /usr/bin/systemctl suspend [check.Ping] enabled = false hosts = [check.RemoteUsers] class = Users enabled = true name = .* terminal = .* host = [0-9].* The configuration file consists of a [general] section, which specifies general processing options, and multiple options of the format [check.*]. These sections describe the checks to execute to determine inactivity. General Configuration The [general] section contains options controlling the overall behavior of the autosuspend daemon. These are: interval The time to wait after executing all checks in seconds. idle_time The required amount of time in seconds with no detected activity before the host will be suspended. suspend_cmd The command to execute in case the host shall be suspended. This line can contain additional command line arguments to the command to execute. Check Configuration For each check to execute, a section with the name format [check.*] needs to be created. Each check has a name and an executing class which implements the behavior. The fraction of the section name check. determines the name, and in case no class option is given inside the section, also the class which implements the check. In case the option:`class option is specified, the name is completely user-defined and the same check can even be instantiated multiple times with differing names. For each check, these generic options can be specified: class Name of the class implementing the check. If this is not specified, the section name must represent a valid check class (see list below). enabled Needs to be true for a check to actually execute. false is assumed if not speci‐ fied. Furthermore, each check might have custom options.


The following checks for activity are currently implemented. Each of the is described with its available configuration options and required optional dependencies. Ping Checks whether one or more hosts answer to ICMP requests. Options hosts Comma-separated list of host names or IPs. Requirements Mpd Checks whether an instance of MPD is currently playing music. Options host Host containing the MPD daemon, default: localhost port Port to connect to the MPD daemon, default: 6600 timeout Request timeout in seconds, default: 5 Requirements · python-mpd2 Kodi Checks whether an instance of Kodi is currently playing. Options url Base URL of the JSON RPC API of the Kodi instance, default: http://local‐ host:8080/jsonrpc timeout Request timeout in seconds, default: 5 Requirements · requests Users Checks whether a user currently logged in at the system matches several criteria. All provided criteria must match to indicate activity on the host. Options All regular expressions are applied against the full string. Capturing substrings needs to be explicitly enabled using wildcard matching. name A regular expression specifying which users to capture, default: .*. terminal A regular expression specifying the terminal on which the user needs to be logged in, default: .*. host A regular expression specifying the host from which a user needs to be logged in, default: .*. Requirements Smb Any active Samba connection will block suspend. Options Requirements smbstatus executable needs to be present. Processes If currently running processes match an expression, the suspend will be blocked. You might use this to hinder the system from suspending when for example your rsync runs. Options processes list of comma-separated process names to check for Requirements ActiveConnection Checks whether there is currently a client connected to a TCP server at certain ports. Can be used to e.g. block suspending the system in case SSH users are connected or a web server is used by clients. Options ports list of comma-separated port numbers Requirements Load Checks whether the system load 5 is below a certain value. Options threshold a float for the maximum allowed load value, default: 2.5 Requirements XIdleTime Checks whether all active local X displays have been idle for a sufficiently long time. This assumes a recent operating system where the X server is started with user permissions (i.e. not as root). Options timeout required idle time in seconds ignore_if_process a regular expression to match against the process names executed by each X session owner. In case the use has a process running, which matches against this expres‐ sion, the X idle time is ignore and the check continues as if there was no activ‐ ity. This can be useful in case of processes which inevitabl The options of individual checks are outlined below.


Johannes Wienke
2017, Johannes Wienke
1.0 Dec 17, 2017 AUTOSUSPEND.CONF(5)
This manual Reference Other manuals
autosuspend.conf(5) referred by autosuspend(1)
refer to
Download raw manual
Main page autosuspend (+2) 1.0 (+56) № 5 (+2141)
Go top