qsu 0.10.1

Service subsystem utilities and runtime wrapper.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! systemd service module.
//!
//! Implements systemd-specific service subsystem interactions.

use sd_notify::NotifyState;

/// A service reporter that sends notifications to systemd.
pub struct ServiceReporter {}

impl super::StateReporter for ServiceReporter {
  fn starting(&self, _checkpoint: u32, status: &str) {
    // Sent startup status to systemd (via sd-notify)
    if let Err(e) = sd_notify::notify(&[NotifyState::Status(status)]) {
      log::error!("Unable to report service started state; {e}");
    }
  }

  fn started(&self) {
    // Inform systemd that the initialization phase has finshed
    if let Err(e) = sd_notify::notify(&[NotifyState::Ready]) {
      log::error!("Unable to report service started state; {e}");
    }

    // inform user (via systemd) that the service is entering the main service
    // application state.
    let status = "Running service application";
    if let Err(e) = sd_notify::notify(&[NotifyState::Status(status)]) {
      log::error!("Unable to report service status; {e}");
    }
  }

  fn stopping(&self, checkpoint: u32, status: &str) {
    // For systemd, there aren't mutltiple stop checkpoints -- there's just a
    // single "stopping has initiated" event.  Use the special checkpoint 0 to
    // signal that service is stopping.
    if checkpoint == 0
      && let Err(e) = sd_notify::notify(&[NotifyState::Stopping])
    {
      log::error!("Unable to report service stopped state; {e}");
    }

    // ToDo: Is it okay to set status after "Stopping" has been set?
    if let Err(e) = sd_notify::notify(&[NotifyState::Status(status)]) {
      log::error!("Unable to report service stopping state; {e}");
    }
  }

  fn stopped(&self) {
    // ToDo: Is it okay to set status after "Stopping" has been set?
    let status = "Service application termination completed";
    if let Err(e) = sd_notify::notify(&[NotifyState::Status(status)]) {
      log::error!("Unable to report service stopping state; {e}");
    }
  }
}

// vim: set ft=rust et sw=2 ts=2 sts=2 cinoptions=2 tw=79 :