evgeni / voltverine

voltverine

Shutdown your machine when certain conditions are met.

configuration

In theory you should not need a configuration in many cases. Yet, not all plugins will work properly without a configuration.

voltverine uses a YAML file for its configuration, with currently only two possible entries: action and plugins. While action is a literal string, representing an action from voltverine.actions to be executed, plugins can be either a list or a hash of plugins from voltverine.plugins. See the following examples:

---
action: LogindPoweroff
plugins:
  - LogindSessions
  - LogindInhibitors

This will set the action to LogindPoweroff and enable the LogindSessions and LogindInhibitors plugins, without further configuration of them.

---
plugins:
  NoShutdownFile:
    filename: /some/path

This does not set an action and voltverine will use the default action (LogindPowerof). This also enables the NoShutdownFile plugin and configures it to watch for a file called /some/path.

voltverine's Issues

tell h01ger when public

open connections plugin

loog for open smb/nfs/ssh/dlna connections, even if there is no traffic

Depends on #3

generic command plugin

The plugin should be able to execute a normal command and act depending on it's exit code.

Depends on #3

traffic plugin

the plugin should check whether there is active network traffic and forbid shutdown if there is

config: traffic threshold, network device to check (if not all)

depends on #3

Command plugin should support directories

see http://anonscm.debian.org/cgit/debian-edu/pkg-team/shutdown-at-night.git/tree/shutdown-at-night#n143

cli/cron mode

As a user I want to be able to run voltverine from a shell or cron.

At least the following options should be available:

• verbose mode, where all plugins report their doings and decisions
• dry-run mode, where no actuall action is taken
• alternative config file (if any)

running processes plugin

check if a specific process is running and forbid shutdown

depends #3

plugin interface

As a developer I don't want to hardcode checks into voltverine. A plugin API/interface should exist.

The API should allow the plugin to take a decision (shutdown, no-shutdown or "dunno"). It also should allow the plugin to pass some more information, like a no-retry delay if it's clear the action will take some time and a shutdown is not possible.

configuration files

As an user I want to configure voltverine in a config file.

systemd inhibit plugin

http://www.freedesktop.org/wiki/Software/systemd/inhibit/

depends #7

uptime plugin

see http://anonscm.debian.org/cgit/debian-edu/pkg-team/shutdown-at-night.git/tree/shutdown-at-night#n139

daemon mode

As an user I want to run voltverine as a daemon, so it will analyze the machine constantly.

no-shutdown file

similar to #13 but without systemd/dbus

depends on #3

generic dbus plugin

The plugin should be able to do a dbus call (either system or user bus, but probably only system is relevant) and decide the action based on the result.

Depends on #3

active user sessions plugin

ask logind if there are users logged in, forbid shutdown if yes

Depends on #7

time plugin

check the current time :)

depends #3

plugin loader

As an user I want to add own plugins without polluting the main voltverine install. A path should be given via cfg/cli. The loaded plugins can be listed.

Depends on #3