psutil 5.4.0

Process and system monitoring library
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

use std::str::FromStr;

use crate::process::{procfs_path, psutil_error_to_process_error, ProcessResult};
use crate::{read_file, Error, Pid, Result, PAGE_SIZE};

const STATM: &str = "statm";

/// Memory usage of a process read from `/proc/[pid]/statm`.
///
/// The `lib` [4, u64] and `dt` [6, u64] fields are ignored.
/// New struct, not in Python psutil.
#[derive(Clone, Debug)]
pub struct ProcfsStatm {
	/// Total program size (bytes).
	pub size: u64,

	/// Resident Set Size (bytes).
	pub resident: u64,

	/// Shared pages (bytes).
	pub shared: u64,

	/// Text.
	pub text: u64,

	/// Data + stack.
	pub data: u64,
}

impl FromStr for ProcfsStatm {
	type Err = Error;

	fn from_str(contents: &str) -> Result<Self> {
		let fields = match contents.split_whitespace().collect::<Vec<_>>() {
			fields if fields.len() >= 7 => Ok(fields),
			_ => Err(Error::MissingData {
				path: STATM.into(),
				contents: contents.to_string(),
			}),
		}?;

		let parse = |s: &str| -> Result<u64> {
			s.parse().map_err(|err| Error::ParseInt {
				path: STATM.into(),
				contents: contents.to_string(),
				source: err,
			})
		};

		Ok(ProcfsStatm {
			size: parse(fields[0])? * *PAGE_SIZE,
			resident: parse(fields[1])? * *PAGE_SIZE,
			shared: parse(fields[2])? * *PAGE_SIZE,
			text: parse(fields[3])? * *PAGE_SIZE,
			data: parse(fields[5])? * *PAGE_SIZE,
		})
	}
}

/// New function, not in Python psutil.
pub fn procfs_statm(pid: Pid) -> ProcessResult<ProcfsStatm> {
	let contents =
		read_file(procfs_path(pid, STATM)).map_err(|e| psutil_error_to_process_error(e, pid))?;

	ProcfsStatm::from_str(&contents).map_err(|e| psutil_error_to_process_error(e, pid))
}