lpfs 0.2.0

Retriving infomations from linux proc filesystem
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

//! > 3.6	/proc/<pid>/comm  & /proc/<pid>/task/<tid>/comm
//! > --------------------------------------------------------
//! > These files provide a method to access a tasks comm value. It also allows for
//! > a task to set its own or one of its thread siblings comm value. The comm value
//! > is limited in size compared to the cmdline value, so writing anything longer
//! > then the kernel's TASK_COMM_LEN (currently 16 chars) will result in a truncated
//! > comm value.
//! >
//! > https://www.kernel.org/doc/Documentation/filesystems/proc.txt

define_struct! {
    /// Represent the content of /proc/[pid]/comm, returned by [`comm_of()`](fn.comm_of.html).
    /// 
    /// This is an String wrapper with implement of Deref trait.
    pub struct CommP {
        inner: String,
    }
}

use std::ops::Deref;
impl Deref for CommP {
    type Target = String;

    fn deref(&self) -> &Self::Target {
        &self.inner
    }

}

impl CommP {
    /// Consume this CommP and return the inner String.
    pub fn into_inner(self) -> String {
        self.inner
    }
}

use std::str::FromStr;
impl FromStr for CommP {
    type Err = crate::ProcErr;

    fn from_str(s: &str) -> Result<CommP, crate::ProcErr> {
        Ok(CommP{inner:s.to_string()})
    }
}

pid_instance_impl! {
    comm_of, "comm", CommP, 
    comm_self, comm_of_task, comm_self_task
}

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn test_comm_of() {
        comm_self().unwrap();
    }
}