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
67

use std::path::Path;

use nix::sys;

use crate::{Bytes, Percent, Result};

#[derive(Clone, Debug, Default)]
pub struct DiskUsage {
	pub(crate) total: Bytes,
	pub(crate) used: Bytes,
	pub(crate) free: Bytes,
	pub(crate) percent: Percent,
}

impl DiskUsage {
	/// Total size of the filesystem.
	pub fn total(&self) -> Bytes {
		self.total
	}

	/// Used bytes of the filesystem.
	pub fn used(&self) -> Bytes {
		self.used
	}

	/// Free bytes of the filesystem.
	pub fn free(&self) -> Bytes {
		self.free
	}

	/// Percentage of the filesystem used (used / total * 100).
	pub fn percent(&self) -> Percent {
		self.percent
	}
}

/// This returns information about the filesystem containing the path.
///
/// It's a wrapper around [statvfs (3)](https://www.mankier.com/3/statvfs).
// Disable the unnecessary_cast lint, as we need to do the u64 casts since on some platforms the
// types are aliased to u32.
// See https://github.com/rust-psutil/rust-psutil/issues/64 and
// https://github.com/rust-psutil/rust-psutil/pull/39
#[allow(clippy::unnecessary_cast)]
pub fn disk_usage<P>(path: P) -> Result<DiskUsage>
where
	P: AsRef<Path>,
{
	let statvfs = sys::statvfs::statvfs(path.as_ref())?;

	let total = statvfs.blocks() as u64 * statvfs.fragment_size() as u64;

	let avail_to_root = statvfs.blocks_free() as u64 * statvfs.fragment_size() as u64;
	let used = total - avail_to_root;

	let free = statvfs.blocks_available() as u64 * statvfs.fragment_size() as u64;

	let total_user = used + free;
	let percent = ((used as f64 / total_user as f64) * 100.0) as f32;

	Ok(DiskUsage {
		total,
		used,
		free,
		percent,
	})
}