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
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
116
117
118
119
120
121
122
123
124
125
126
127

// 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.


/// General driver and device information.
///
/// Users can use the `ETHTOOL_GSSET_INFO` command to get the number ofstrings in any of the string sets (`SS`):-
///
/// * `ethtool_stringset::ETH_SS_PRIV_FLAGS`.
/// * `ethtool_stringset::ETH_SS_STATS`.
/// * `ethtool_stringset::ETH_SS_TEST`.
#[derive(Default, Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[repr(C)]
pub(crate) struct ethtool_drvinfo
{
	/// Always `ETHTOOL_GDRVINFO`.
	pub(crate) cmd: u32,
	
	/// Driver short name.
	///
	/// Must not be an empty string.
	pub(crate) driver: [c_char; 32],
	
	/// Driver version.
	///
	/// Can be an empty string.
	pub(crate) version: [c_char; 32],
	
	/// Firmware version.
	///
	/// Can be an empty string.
	pub(crate) fw_version: [c_char; ETHTOOL_FWVERS_LEN],
	
	/// Device bus address.
	///
	/// Can be an empty string.
	pub(crate) bus_info: [c_char; ETHTOOL_BUSINFO_LEN],
	
	/// Expansion ROM version string.
	///
	/// Can be an empty string.
	pub(crate) erom_version: [c_char; ETHTOOL_EROMVERS_LEN],
	
	reserved2: [c_char; 12],
	
	/// Number of flags valid for `ETHTOOL_GPFLAGS` and `ETHTOOL_SPFLAGS` commands; also the number of strings in the `ethtool_stringset::ETH_SS_PRIV_FLAGS` string set.
	///
	/// If zero then the `ETHTOOL_GPFLAGS` and `ETHTOOL_SPFLAGS` commands are unsupported and the `ethtool_stringset::ETH_SS_PRIV_FLAGS` string set is unsupported.
	///
	/// Use the command `ETHTOOL_GSSET_INFO` instead.
	pub(crate) n_priv_flags: u32,
	
	/// Number of u64 statistics returned by the `ETHTOOL_GSTATS` command; also the number of strings in the `ethtool_stringset::ETH_SS_STATS` string set.
	///
	/// If zero then the `ETHTOOL_GSTATS` command is unsupported and the `ethtool_stringset::ETH_SS_STATS` string set is unsupported.
	///
	/// Use the command `ETHTOOL_GSSET_INFO` instead.
	pub(crate) n_stats: u32,

	/// Number of results returned by the `ETHTOOL_TEST` command; also the number of strings in the `ethtool_stringset::ETH_SS_TEST` string set.
	///
	/// If zero then the `ETHTOOL_TEST` command is unsupported and the `ethtool_stringset::ETH_SS_TEST` string set is unsupported.
	///
	/// Use the command `ETHTOOL_GSSET_INFO` instead.
	#[deprecated]
	pub(crate) testinfo_len: u32,

	/// Size of EEPROM accessible through the `ETHTOOL_GEEPROM` and `ETHTOOL_SEEPROM` commands, in bytes.
	///
	/// If zero then the `ETHTOOL_GEEPROM` and `ETHTOOL_SEEPROM` commands are unsupported.
	pub(crate) eedump_len: u32,

	/// Size of register dump returned by the `ETHTOOL_GREGS` command, in bytes.
	///
	/// If zero then the `ETHTOOL_GREGS` command is unsupported.
	pub(crate) regdump_len: u32,
}

impl EthtoolCommand for ethtool_drvinfo
{
	#[inline(always)]
	fn command(&self) -> u32
	{
		self.cmd
	}
}

impl ethtool_drvinfo
{
	#[inline(always)]
	pub(crate) fn as_driver_and_device_information(self) -> Result<DriverAndDeviceInformation, ObjectNameFromBytesError>
	{
		#[inline(always)]
		fn optional_object_name_32(object_name_32: [c_char; 32]) -> Result<Option<ObjectName32>, ObjectNameFromBytesError>
		{
			let value = if object_name_32.is_empty()
			{
				None
			}
			else
			{
				Some(ObjectName32::try_from(object_name_32)?)
			};
			Ok(value)
		}
		
		#[inline(always)]
		fn non_zero_u32(value: u32) -> Option<NonZeroU32>
		{
			unsafe { transmute(value) }
		}
		
		Ok
		(
			DriverAndDeviceInformation
			{
				driver_name: ObjectName32::try_from(self.bus_info)?,
				driver_version: optional_object_name_32(self.version)?,
				device_bus_device_address: optional_object_name_32(self.bus_info)?.map(BusDeviceAddress::from),
				device_firmware_version: optional_object_name_32(self.fw_version)?,
				device_expansion_eeprom_version: optional_object_name_32(self.erom_version)?,
				device_eeprom_blob_size_in_bytes: non_zero_u32(self.eedump_len),
				device_registers_blob_size_in_bytes: non_zero_u32(self.regdump_len),
			}
		)
	}
}