heim-process 0.0.11

Cross-platform processes information
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

use ordered_float::NotNan;

use crate::Pid;
use heim_common::units::{time, Time};

/// Process unique ID.
///
/// Processes can't be compared just by their PIDs,
/// as the PIDs can be re-used, so the minimal information amount
/// needed to unique identify a process is a (pid, create_time)
/// tuple.
///
/// In addition, since `create_time` is basically the `f64` type
/// internally, it is wrapped into a `NotNan` type
/// in order to provide `Hash`, `PartialEq` and `Eq` traits.
///
/// This struct is shared across multiple OS-specific implementations.
#[derive(Debug, Hash, PartialEq, Eq, Clone)]
pub struct UniqueId {
    pid: Pid,
    create_time: NotNan<f64>,
}

impl UniqueId {
    /// Create new `UniqueId` based on process' `pid` and `create_time`.
    ///
    /// ## Panics
    ///
    /// Will panic if `create_time` internally is `NaN`,
    /// which should be considered as a bug, since it should
    /// be impossible to get such a time value for process.
    pub fn new(pid: Pid, create_time: Time) -> UniqueId {
        let seconds = create_time.get::<time::second>();
        let time = NotNan::new(seconds).expect("Process create time can't be NaN");

        UniqueId {
            pid,
            create_time: time,
        }
    }

    /// Get back the process creation time.
    ///
    /// Mostly used to reduce `Process` struct size
    /// and re-use already loaded values
    pub fn create_time(&self) -> Time {
        Time::new::<time::second>(*self.create_time)
    }
}