diff options
author | Jonathan Maw <jonathan.maw@codethink.co.uk> | 2012-08-06 17:21:26 +0100 |
---|---|---|
committer | Jannis Pohlmann <jannis.pohlmann@codethink.co.uk> | 2012-08-07 14:34:07 +0100 |
commit | bf11c8a59125171bbadc8f5b736d69eab41c1de2 (patch) | |
tree | 1944a1f556469742a3f23d61ab997c8e30328388 | |
parent | 1e430d3b577c5c8d0d979647046f035f83fcb453 (diff) | |
download | node-startup-controller-bf11c8a59125171bbadc8f5b736d69eab41c1de2.tar.gz |
Document purpose and start/stop methods of job manager
-rw-r--r-- | node-startup-controller/job-manager.c | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/node-startup-controller/job-manager.c b/node-startup-controller/job-manager.c index a3f7318..5fd4bf7 100644 --- a/node-startup-controller/job-manager.c +++ b/node-startup-controller/job-manager.c @@ -19,6 +19,19 @@ +/** + * SECTION: job-manager + * @title: JobManager + * @short_description: Manages systemd jobs. + * @stability: Internal + * + * The Job Manager simplifies starting and stopping systemd units by handling all the + * JobRemoved signals internally, so units can be started and stopped using + * job_manager_start() and job_manager_stop(). + */ + + + typedef struct _JobManagerJob JobManagerJob; @@ -424,6 +437,14 @@ job_manager_new (GDBusConnection *connection, +/** + * job_manager_start: + * @unit: The name of the systemd unit to start. + * @callback: a #JobManagerCallback that is called after the job is started. + * @user_data: userdata that is available in the #JobManagerCallback. + * + * Asynchronously starts @unit, and calls @callback with @user_data when it is finished. + */ void job_manager_start (JobManager *manager, const gchar *unit, @@ -448,6 +469,14 @@ job_manager_start (JobManager *manager, +/** + * job_manager_stop: + * @unit: The name of the systemd unit to stop. + * @callback: a #JobManagerCallback that is called after the job is stopped. + * @user_data: userdata that is available in the #JobManagerCallback. + * + * Asynchronously stops @unit, and calls @callback with @user_data when it is finished. + */ void job_manager_stop (JobManager *manager, const gchar *unit, |