poggers 1.2.1

memory lib
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

use self::implement::PlatformData;
use super::process::{External, Process};

/// OS specific implementations of [ProcList]
pub mod implement;
/// a list of processes
#[derive(Debug)]
pub struct ProcessList(Box<[ProcessListEntry]>);
/// a contains basic data about process
#[derive(Debug)]
pub struct ProcessListEntry {
    /// the process id
    pub pid: u32,
    pd: PlatformData,
}
impl std::ops::Deref for ProcessList {
    type Target = [ProcessListEntry];
    fn deref(&self) -> &Self::Target {
        &self.0
    }
}
impl std::ops::Deref for ProcessListEntry {
    type Target = PlatformData;

    fn deref(&self) -> &Self::Target {
        &self.pd
    }
}
#[derive(Debug, thiserror::Error)]
/// errors that can occur when getting a process list
pub enum ProcListError {
    /// temp error
    #[error("unable to get process list")]
    UnableToGetProcessList,
}

/// standard functions for getting a process list
pub trait ProcList {
    /// get a [ProcessList] from the current system
    /// under the hood just calls [get_iter] and collects it into a vec
    fn get_list() -> Result<ProcessList, ProcListError> {
        let iter = Self::get_iter()?;
        let hint = iter.size_hint();
        let hint = hint.1.unwrap_or(hint.0);
        let mut vec = Vec::with_capacity(hint);
        for i in iter {
            vec.push(i);
        }
        let proclist = vec.into_boxed_slice();
        Ok(ProcessList(proclist))
    }
    /// get an iterator of [ProcessListEntry] from the current system
    fn get_iter() -> Result<impl Iterator<Item = ProcessListEntry>, ProcListError>;
}
impl ProcessListEntry {
    /// converts the process list entry into a process
    pub fn upgrade(&self) -> Result<Process<External>, crate::structures::process::ProcessError> {
        Process::find_pid(self.pid)
    }
}