linux-support 0.0.25

Comprehensive Linux support for namespaces, cgroups, processes, scheduling, parsing /proc, parsing /sys, signals, hyper threads, CPUS, NUMA nodes, unusual file descriptors, PCI devices and much, much more
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

// This file is part of linux-support. 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/linux-support/master/COPYRIGHT. No part of linux-support, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2020 The developers of linux-support. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/linux-support/master/COPYRIGHT.


/// Resources.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub struct Resources<'a>
{
	pci_device: &'a PciDevice<'a>,
	resources: BTreeMap<u8, ResourceEntry>,
}

impl<'a> Deref for Resources<'a>
{
	type Target = BTreeMap<u8, ResourceEntry>;

	#[inline(always)]
	fn deref(&self) -> &Self::Target
	{
		&self.resources
	}
}

impl<'a> Resources<'a>
{
	/// Memory map resource.
	#[inline(always)]
	pub fn memory_map(&self, resource_index: u8) -> Result<Option<MemoryMappedResource>, io::Error>
	{
		if !self.resources.contains_key(&resource_index)
		{
			return Ok(None)
		}

		ResourceEntry::memory_map(self.pci_device, resource_index).map(|resource| Some(resource))
	}

	/*
		A typical file might be
		0x0000000000008200 0x000000000000823f 0x0000000000040101
		0x00000000ee000000 0x00000000ee000fff 0x0000000000040200
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
		0x0000000000000000 0x0000000000000000 0x0000000000000000
	*/
	pub(crate) fn parse_lines(pci_device: &'a PciDevice<'a>) -> io::Result<Self>
	{
		let file_path = pci_device.device_file_or_folder_path("resource");
		let reader = file_path.read_raw()?;

		let mut resources = BTreeMap::default();
		let mut index = 0;
		
		for line in reader.split_bytes(b'\n')
		{
			if let Some(resource_entry) = ResourceEntry::parse_line(line).map_err(io_error_other)?
			{
				resources.insert(index, resource_entry);
			}
			index += 1;
		}
		Ok
		(
			Self
			{
				pci_device,
				resources,
			}
		)
	}
}