SLEEPCTL(1)

NAME
sleepctl - enable/disable sleepd

SYNOPSIS
sleeptcl [on|off|status]

DESCRIPTION
sleepctl allows temporarily disabling of the sleepd(8) daemon, by a regular user. This can be useful when you're in the middle of a long download or compile, and don't want the system going to sleep in the middle.

"sleepctl off" makes sleepd not put the system to sleep even if it thinks it is idle. If this command is run more than once, the requests stack up, and a like number of "sleepctl on" commands must be run to re-enable sleeping. This may be useful if multiple automated processes or users use the command. Note that the system may still be put to sleep for other reasons, such as a failing battery.

"sleepctl on" re-enables sleeping. If sleeping is re-enabled and sleepd has seen no system activity for some time, and has been prevented from putting the system to sleep, it may put the system to sleep immediatly.

"sleepctl status" outputs the current status of sleepd.

Note that if the system is forced to sleep by other means, sleepd will not remember what mode it was in when it wakes back up, and will return to the default mode of putting the system to sleep after some amount of inactivity. This is by design, so you may easily and naturally undo the effects of a "sleepctl off" without remembering to turn it back on.

This program communicates with sleepd by writing to the file /var/run/sleepd.ctl. As such, it needs read/write access to that file. It also needs to run as whatever user sleepd runs as, so it can hup the daemon.

EXAMPLES
 sleepctl off ; wget http://foo/huge.tgz ; sleepctl on

SEE ALSO
sleepd(8)

http://kitenet.net/~joey/code/sleepd/

AUTHOR
Joey Hess <joey@kitenet.net>