dpdk 0.0.1

A wrapper around DPDK
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

// This file is part of dpdk. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/dpdk/master/COPYRIGHT. No part of dpdk, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2016-2017 The developers of dpdk. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/dpdk/master/COPYRIGHT.


#[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum NonNumaMemory
{
}

impl NonNumaMemory
{
	pub fn supportedHugePageSizesLargestFirst(sysPath: &Path, defaultHugePageSize: Option<HugePageSize>) -> Vec<HugePageSize>
	{
		let length = HugePageSize::PotentiallySupportedHugePageSizesLargestFirst.len();
		
		let mut supported = Vec::with_capacity(length);
		
		for hugePageSize in HugePageSize::PotentiallySupportedHugePageSizesLargestFirst.iter()
		{
			if Self::numberOfNonNumaHugePages(sysPath, *hugePageSize).is_ok()
			{
				supported.push(*hugePageSize);
			}
		}
		
		if let Some(defaultHugePageSize) = defaultHugePageSize
		{
			let mut containsDefaultHugePageSize = false;
			for hugePageSize in supported.iter()
			{
				if *hugePageSize == defaultHugePageSize
				{
					containsDefaultHugePageSize = true;
					break;
				}
			}
		
			assert!(containsDefaultHugePageSize, "supported huge page sizes '{:?}' do not contain default '{:?}'", supported, defaultHugePageSize)
		}
		
		supported.shrink_to_fit();
		supported
	}
	
	/// Will only work as root
	pub fn tryToClearAllNonNumaHugePagesReserved(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<()>
	{
		assertEffectiveUserIsRoot(&format!("Clear all non-NUMA huge pages of size '{:?}'", hugePageSize));
		Self::tryToReserveNonNumaHugePages(sysPath, hugePageSize, 0)
	}
	
	/// Will only work as root
	pub fn tryToReserveNonNumaHugePages(sysPath: &Path, hugePageSize: HugePageSize, count: u64) -> io::Result<()>
	{
		assertEffectiveUserIsRoot(&format!("Reserve '{}' non-NUMA huge pages of size '{:?}'", count, hugePageSize));

		let filePath = Self::nonNumaNumberOfHugePagesFilePath(sysPath, hugePageSize);
		writeValueToFile(&filePath, count)
	}
	
	pub fn numberOfNonNumaHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaNumberOfHugePagesFilePath(sysPath, hugePageSize);
		readValueFromFile(&filePath)
	}
	
	pub fn numberOfNonNumaFreeHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "free_hugepages");
		readValueFromFile(&filePath)
	}
	
	pub fn numberOfNonNumaSurplusHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "surplus_hugepages");
		readValueFromFile(&filePath)
	}
	
	pub fn numberOfNonNumaReservedHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "resv_hugepages");
		readValueFromFile(&filePath)
	}
	
	pub fn numberOfNonNumaMemoryPolicyHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "nr_hugepages_mempolicy");
		readValueFromFile(&filePath)
	}
	
	pub fn numberOfNonNumaOvercommitHugePages(sysPath: &Path, hugePageSize: HugePageSize) -> io::Result<u64>
	{
		let filePath = Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "nr_overcommit_hugepages");
		readValueFromFile(&filePath)
	}
	
	fn nonNumaNumberOfHugePagesFilePath(sysPath: &Path, hugePageSize: HugePageSize) -> PathBuf
	{
		Self::nonNumaHugePagesFilePath(sysPath, hugePageSize, "nr_hugepages")
	}
	
	fn nonNumaHugePagesFilePath(sysPath: &Path, hugePageSize: HugePageSize, fileName: &str) -> PathBuf
	{
		let mut filePath = Self::nonNumaHugePagesFolderPath(sysPath, hugePageSize);
		filePath.push(fileName);
		filePath
	}
	
	fn nonNumaHugePagesFolderPath(sysPath: &Path, hugePageSize: HugePageSize) -> PathBuf
	{
		let mut filePath = PathBuf::from(sysPath);
		filePath.push(format!("kernel/mm/hugepages/hugepages-{}kB", hugePageSize.size()));
		filePath
	}
}