aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--TODO1
-rw-r--r--lib/python/alarms.c14
2 files changed, 7 insertions, 8 deletions
diff --git a/TODO b/TODO
index 855bd2f..58e81da 100644
--- a/TODO
+++ b/TODO
@@ -1,3 +1,2 @@
- Watch /proc/<client_pid> and destroy alarms last owned by processes when they die
- Allow ownership change command so long as uuid can be given
-- Python binding needs docs
diff --git a/lib/python/alarms.c b/lib/python/alarms.c
index 1ac42af..2c42d52 100644
--- a/lib/python/alarms.c
+++ b/lib/python/alarms.c
@@ -14,12 +14,12 @@
#include "pyalarmd_proto.h"
static PyMethodDef ExportedMethods[] = {
- {"connect" , pyalarmd_connect , METH_VARARGS, "FIXME"},
- {"disconnect" , pyalarmd_disconnect, METH_VARARGS, "FIXME"},
- {"register_alarm" , pyalarmd_register , METH_VARARGS, "FIXME"},
- {"deregister_alarm", pyalarmd_deregister, METH_VARARGS, "FIXME"},
- {"raise_alarm" , pyalarmd_raise , METH_VARARGS, "FIXME"},
- {"clear_alarm" , pyalarmd_clear , METH_VARARGS, "FIXME"},
+ {"connect" , pyalarmd_connect , METH_VARARGS, "Open a connection to the named socket at the given path, returning the fd associated with it."},
+ {"disconnect" , pyalarmd_disconnect, METH_VARARGS, "Close a socket fd previously returned by connect(path)."},
+ {"register_alarm" , pyalarmd_register , METH_VARARGS, "Send a request over the given socket to register an alarm with the given name. Returns the UUID of the new alarm as a string"},
+ {"deregister_alarm", pyalarmd_deregister, METH_VARARGS, "Send a request over the given socket to deregister an alarm with the given UUID."},
+ {"raise_alarm" , pyalarmd_raise , METH_VARARGS, "Send a request over the given socket to raise the alarm with the given UUID."},
+ {"clear_alarm" , pyalarmd_clear , METH_VARARGS, "Send a request over the given socket to clear/lower the alarm with the given UUID."},
{NULL , NULL , 0 , NULL }
};
@@ -27,7 +27,7 @@ static PyMethodDef ExportedMethods[] = {
static struct PyModuleDef alarm_python = {
PyModuleDef_HEAD_INIT,
"alarms", /* module name */
- NULL, /* FIXME reference doc */
+ NULL,
-1, /* storage size -1 since state kept in global variables. */
ExportedMethods
};