memfaultd 1.26.1

Memfault daemon for embedded Linux systems. Observability, logging, crash reporting, and updating all in one service. Learn more at https://docs.memfault.com/
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
58
59
60
61
62
63
64
65
66
67

//
// Copyright (c) Memfault, Inc.
// See License.txt for details
//! Memfaultd service management
//!
//! This module contains the trait for managing memfaultd services, as well as
//! the implementation for systemd.
//!

#[cfg(not(feature = "systemd"))]
mod default;
#[cfg(feature = "systemd")]
mod systemd;

/// Return the system manager that was configured at build time.
pub fn get_service_manager() -> impl MemfaultdServiceManager {
    #[cfg(feature = "systemd")]
    {
        use systemd::SystemdServiceManager;
        SystemdServiceManager
    }
    #[cfg(not(feature = "systemd"))]
    {
        use default::DefaultServiceManager;
        DefaultServiceManager
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ServiceManagerStatus {
    Starting,
    Running,
    Stopping,
    Stopped,
    #[cfg(not(feature = "systemd"))]
    Unknown,
}

/// Trait for managing memfaultd services
///
/// This trait is implemented for different service managers, such as systemd.
#[cfg_attr(test, mockall::automock)]
pub trait MemfaultdServiceManager {
    fn restart_memfaultd_if_running(&self) -> eyre::Result<()>;
    fn service_manager_status(&self) -> eyre::Result<ServiceManagerStatus>;
}

impl TryFrom<&str> for ServiceManagerStatus {
    type Error = eyre::Error;

    fn try_from(status: &str) -> Result<Self, Self::Error> {
        let status = match status {
            "starting" => ServiceManagerStatus::Starting,
            "running" => ServiceManagerStatus::Running,
            "stopping" => ServiceManagerStatus::Stopping,
            "stopped" => ServiceManagerStatus::Stopped,
            _ => {
                return Err(eyre::eyre!(
                    "Unknown systemd service manager status: {}",
                    status
                ))
            }
        };

        Ok(status)
    }
}