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

//
// Copyright (c) Memfault, Inc.
// See License.txt for details
use std::fs::{remove_file, OpenOptions};
use std::io::{ErrorKind, Write};
use std::path::Path;

use eyre::{eyre, Report, Result, WrapErr};
use nix::unistd::Pid;

const PID_FILE: &str = "/var/run/memfaultd/memfaultd.pid";

pub fn write_pid_file() -> Result<()> {
    let file = OpenOptions::new()
        .write(true)
        .create_new(true)
        .open(Path::new(PID_FILE));

    match file {
        Ok(mut file) => writeln!(file, "{}", Pid::this()).wrap_err("Failed to write PID file"),
        Err(e) => {
            let msg = match e.kind() {
                ErrorKind::AlreadyExists => "Daemon already running, aborting.",
                _ => "Failed to open PID file, aborting.",
            };
            Err(Report::new(e).wrap_err(msg))
        }
    }
}

/// Returns true if (and only if) our PID file exists, is readable and contains our current PID.
pub fn is_pid_file_about_me() -> bool {
    match get_pid_from_file() {
        Ok(pid) => pid == Pid::this(),
        _ => false,
    }
}

pub fn get_pid_from_file() -> Result<Pid> {
    match std::fs::read_to_string(PID_FILE) {
        Ok(pid_string) => {
            let pid = pid_string
                .trim()
                .parse()
                .wrap_err("Failed to parse PID file contents")?;
            Ok(Pid::from_raw(pid))
        }
        Err(_) => Err(eyre!("Couldn't read memfaultd PID file at {}.", PID_FILE)),
    }
}

pub fn remove_pid_file() -> Result<()> {
    remove_file(PID_FILE).wrap_err("Failed to remove PID file")
}

pub fn send_signal_to_pid(signal: nix::sys::signal::Signal) -> Result<()> {
    let pid = get_pid_from_file()?;
    nix::sys::signal::kill(pid, signal).wrap_err("Failed to send signal to memfaultd")
}