From b4c5251ad58cf60d00700db34e104fd75f78edea Mon Sep 17 00:00:00 2001 From: Tomasz Kramkowski Date: Wed, 30 Dec 2020 14:53:33 +0000 Subject: add readme --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d318ecf --- /dev/null +++ b/README.md @@ -0,0 +1,33 @@ +# battd + +A simple battery daemon written for use with a daemontools-style supervisor. + +`run` polls the status of a `check` function with a regular interval. On the +transition from a successful `check` exit status to an unsuccessful `check` exit +status the `failed` function is called. + +## Installation + +Directly install `run`, `conf` and `battcheck` in a service directory. + +## Usage + +Configure `conf` appropriately. This should contain three functions: + +`interval` +: Called to determine the polling interval (see below). + +`check` +: Called to determine the battery status. + +`failed` +: Called when the battery status has transitioned from a successful to a + failing return. + +Optionally two variables can be set: + +`long_interval` +: The polling interval when `interval` returns success (default: 300). + +`short_interval` +: The polling interval when `interval` returns failure (default: 30). -- cgit v1.2.3-54-g00ecf