path: root/modules-available/statistics/inc/hardwareparser.inc.php

<?php

class HardwareParser
{

	const SIZE_LOOKUP = ['T' => 1099511627776, 'G' => 1073741824, 'M' => 1048576, 'K' => 1024, '' => 1];
	const SI_LOOKUP = ['T' => 1000000000000, 'G' => 1000000000, 'M' => 1000000, 'K' => 1000, '' => 1];

	const LOOKUP = ['T' => 1099511627776, 'G' => 1073741824, 'M' => 1048576, 'K' => 1024, '' => 1];

	/**
	 * Convert/format size unit. Input string can be a size like
	 * 8 GB or 1024 MB and will be converted according to passed parameters.
	 * @param string $string Input string
	 * @param string $scale 'a' for auto, T/G/M/K/'' for according units
	 * @param bool $appendUnit append unit string, e.g. 'GiB'
	 * @return false|string|int Formatted result
	 */
	public static function convertSize(string $string, string $scale = 'a', bool $appendUnit = true)
	{
		if (!preg_match('/(\d+)\s*([TGMK]?)/i', $string, $out)) {
			//error_log("Not size: $string");
			return false;
		}
		$val = (int)$out[1] * self::LOOKUP[strtoupper($out[2])];
		if (!array_key_exists($scale, self::LOOKUP)) {
			foreach (self::LOOKUP as $k => $v) {
				if ($k === '' || $val / 8 >= $v || abs($val - $v) < 50) {
					$scale = $k;
					break;
				}
			}
		}
		$val = (int)round($val / self::LOOKUP[$scale]);
		if ($appendUnit) {
			$val .= ' ' . ($scale === '' ? 'Byte' : $scale . 'iB'); // NBSP!!
		}
		return $val;
	}

	/**
	 * Decode JEDEC ID to according manufacturer
	 * @param string $string
	 * @return string
	 */
	public static function decodeJedec(string $string): string
	{
		// JEDEC ID:7F 7F 9E 00 00 00 00 00
		if (preg_match('/JEDEC(?:\s*ID)?\s*:\s*([0-9a-f\s]+)/i', $string, $out)) {
			preg_match_all('/[0-9a-f]{2}/i', $out[1], $out);
			$bank = 0;
			$id = 0;
			foreach ($out[0] as $id) {
				$bank++;
				$id = hexdec($id) & 0x7f; // Let's just ignore the parity bit, and any potential error
				if ($id !== 0x7f)
					break;
			}
			if ($id !== 0) {
				static $data = false;
				if ($data === false) $data = json_decode(file_get_contents(dirname(__FILE__) . '/jedec.json'), true);
				if (array_key_exists('bank' . $bank, $data) && array_key_exists('id' . $id, $data['bank' . $bank]))
					return $data['bank' . $bank]['id' . $id];
			}
		}
		return $string;
	}

	/**
	 * @param string $key
	 * @param string $value
	 * @return ?int value, or null if not numeric
	 */
	private static function toNumeric(string $key, string $val)
	{
		$key = strtolower($key);
		// Normalize voltage to mV
		if ((strpos($key, 'volt') !== false || strpos($key, 'current') !== false)
			&& preg_match('/^([0-9]+(?:\.[0-9]+)?)\s+(m?)V/', $val, $out)) {
			return (int)($out[1] * ($out[2] === 'm' ? 1 : 1000));
		}
		if (preg_match('/speed|width|size|capacity/', $key)
			&& preg_match('#^([0-9]+(?:\.[0-9]+)?)\s*([TGMK]?)i?([BT](?:it|yte|))s?(?:/s)?#i',
				$val, $out)) {
			// Matched (T/G/M) Bits, Bytes, etc...
			// For bits, use SI
			if ($out[3] !== 'B' && strtolower($out[3]) !== 'byte')
				return (int)($out[1] * self::SI_LOOKUP[strtoupper($out[2])]);
			// For bytes, use 1024
			return (int)($out[1] * self::SIZE_LOOKUP[strtoupper($out[2])]);
		}
		// Speed in Hz
		if (preg_match('#^([0-9]+(?:\.[0-9]+)?)\s*([TGMK]?)Hz#i',
			$val, $out)) {
			return (int)($out[1] * self::SI_LOOKUP[strtoupper($out[2])]);
		}
		// Count, size (unitless)
		if (is_numeric($val) && preg_match('/^-?[0-9]+$/', $val)
			&& preg_match('/used|occupied|count|number|size|temperature|_start|_value|_thresh|_worst|_time/', $key)) {
			return (int)$val;
		}
		// Date
		if (preg_match('#^(?:[0-9]{2}/[0-9]{2}/[0-9]{4}|[0-9]{4}-[0-9]{2}-[0-9]{2})$#', $val)) {
			return (int)strtotime($val);
		}
		return null;
	}

	/**
	 * Takes hwinfo json, then looks up and returns all sections from the
	 * dmidecode subtree that represent the given dmi table entry type,
	 * e.g. 17 for memory. It will then return an array of 'props' subtrees.
	 *
	 * @param array $data hwinfo tree
	 * @param int $type dmi type
	 * @return array [ <props>, <props>, ... ]
	 */
	public static function getDmiHandles(array $data, int $type): array
	{
		if (empty($data['dmidecode']))
			return [];
		$ret = [];
		foreach ($data['dmidecode'] as $section) {
			if ($section['handle']['type'] == $type) {
				$ret[] = $section['props'];
			}
		}
		return $ret;
	}

	/**
	 * Takes key-value-array, returns a concatenated string of all the values with the keys given in $fields.
	 * The items are separated by spaces, and returned in the order they were given in $fields. Missing keys
	 * are silently omitted.
    */
	private static function idFromArray(array $array, string ...$fields): string
	{
		$out = '';
		foreach ($fields as $field) {
			if (!isset($array[$field]))
				continue;
			if (empty($out)) {
				$out = $array[$field];
			} else {
				$out .= ' ' . $array[$field];
			}
		}
		return $out;
	}

	/**
	 * Establish a mapping between a client and some hardware device.
	 * Optionally writes hardware properties specific to a hardware instance of a client
	 *
	 * @param string $uuid client
	 * @param int $hwid hw global hw id
	 * @param string $pathId unique identifier for the local instance of this hw, e.q. PCI slot, /dev path, something that handles the case that there are multiple instances of the same hardware in one machine
	 * @param array $props KV-pairs of properties to write for this instance; can be empty
	 * @return int
	 */
	private static function writeLocalHardwareData(string $uuid, int $hwid, string $pathId, array $props): int
	{
		// Add mapping between hw entity and machine
		$mappingId = Database::insertIgnore('machine_x_hw', 'machinehwid',
			['hwid' => $hwid, 'machineuuid' => $uuid, 'devpath' => $pathId],
			['disconnecttime' => 0]);
		// And all the properties specific to this entity instance (e.g. serial number)
		if (!empty($props)) {
			$vals = [];
			foreach ($props as $k => $v) {
				$vals[] = [$mappingId, $k, $v, self::toNumeric($k, $v)];
			}
			Database::exec("INSERT INTO machine_x_hw_prop (machinehwid, prop, `value`, `numeric`)
					VALUES :vals
					ON DUPLICATE KEY UPDATE `value` = VALUES(`value`), `numeric` = VALUES(`numeric`)", ['vals' => $vals]);
		}
		return $mappingId;
	}

	/**
	 * Takes an array of type [ key1 => [ 'values' => [ <val1.1>, <val1.2>, ... ] ], key2 => ... ]
	 * and turns it into [ key1 => <val1.1>, key2 => <val2.1>, ... ]
	 *
	 * Along the way:
	 * 1) any fields with bogus values, or values analogous to empty will get removed
	 */
	public static function prepareDmiProperties(array $data): array
	{
		$ret = [];
		foreach ($data as $key => $vals) {
			$val = trim($vals['values'][0] ?? 'NULL');
			if ($val === '[Empty]' || $val === 'NULL')
				continue;
			$val = preg_replace('/[^a-z0-9]/', '', strtolower($val));
			if ($val === '' || $val === 'notspecified' || $val === 'tobefilledbyoem' || $val === 'unknown'
				|| $val === 'chassismanufacture' || $val === 'chassismanufacturer' || $val === 'chassisversion'
				|| $val === 'chassisserialnumber' || $val === 'defaultstring' || $val === 'productname'
				|| $val === 'manufacturer' || $val === 'systemmodel' || $val === 'fillbyoem' || $val === 'none') {
				continue;
			}
			$val = trim($vals['values'][0] ?? '');
			if ($key === 'Manufacturer') {
				$val = self::fixManufacturer($val);
			}
			$ret[$key] = $val;
		}
		return $ret;
	}

	/**
	 * Mark all devices of a given type disconnected from the given machine, with an optional
	 * exclude list of machine-client-mapping IDs
	 *
	 * @param string $uuid client
	 * @param string $dbType type, eg HDD
	 * @param array $excludedHwIds mappingIDs to exclude, ie. devices that are still connected
	 */
	private static function markDisconnected(string $uuid, string $dbType, array $excludedHwIds)
	{
		//error_log("Marking disconnected for $dbType except " . implode(', ', $excludedHwIds));
		if (empty($excludedHwIds)) {
			Database::exec("UPDATE machine_x_hw mxh, statistic_hw h
				SET mxh.disconnecttime = UNIX_TIMESTAMP()
				WHERE h.hwtype = :type AND h.hwid = mxh.hwid AND mxh.machineuuid = :uuid
				AND mxh.disconnecttime = 0",
				['type' => $dbType, 'uuid' => $uuid]);
		} else {
			Database::exec("UPDATE machine_x_hw mxh, statistic_hw h
				SET mxh.disconnecttime = UNIX_TIMESTAMP()
				WHERE h.hwtype = :type AND h.hwid = mxh.hwid AND mxh.machineuuid = :uuid
				AND mxh.disconnecttime = 0 AND mxh.machinehwid NOT IN (:hwids)",
				['type' => $dbType, 'uuid' => $uuid, 'hwids' => $excludedHwIds]);
		}
	}

	private static function writeGlobalHardwareData(string $dbType, array $global): int
	{
		static $cache = [];
		// Since the global properties are supposed to be unique for a specific piece of hardware, use them all
		// to generate a combined ID for this hardware entity, as opposed to $localProps, which should differ
		// between instances of the same hardware entity, e.g. one specific HDD model has different serial numbers.
		$id = md5(implode(' ', $global));
		if (!isset($cache[$id])) {
			// Cache lookup, make sure we insert this only once for every run, as this is supposed to be general
			// information about the hardware, e.g. model number, max. resultion, capacity, ...
			$hwid = Database::insertIgnore('statistic_hw', 'hwid', ['hwtype' => $dbType, 'hwname' => $id]);
			$vals = [];
			foreach ($global as $k => $v) {
				$vals[] = [$hwid, $k, $v, self::toNumeric($k, $v)];
			}
			if (!empty($vals)) {
				Database::exec("INSERT INTO statistic_hw_prop (hwid, prop, `value`, `numeric`)
						VALUES :vals
						ON DUPLICATE KEY UPDATE `value` = VALUES(`value`), `numeric` = VALUES(`numeric`)",
					['vals' => $vals]);
			}
			$cache[$id] = $hwid;
		}
		return $cache[$id];
	}

	public static function parseMachine(string $uuid, array $data)
	{
		$version = $data['version'] ?? 0;
		if ($version != 2) {
			error_log("Received unsupported hw json v$version");
			return;
		}
		// determine misc stuff first
		$globalMainboardExtra = [];
		$localMainboardExtra = [];
		// physical memory array
		$memArrays = self::getDmiHandles($data, 16);
		$globalMainboardExtra['Memory Slot Count'] = 0;
		$globalMainboardExtra['Memory Maximum Capacity'] = 0;
		foreach ($memArrays as $mem) {
			$mem = self::prepareDmiProperties($mem);
			if (isset($mem['Number Of Devices']) && ($mem['Use'] ?? 0) === 'System Memory') {
				$globalMainboardExtra['Memory Slot Count'] += $mem['Number Of Devices'];
			}
			if (isset($mem['Maximum Capacity'])) {
				$globalMainboardExtra['Memory Maximum Capacity']
					+= self::convertSize($mem['Maximum Capacity'], 'M', false);
			}
		}
		$globalMainboardExtra['Memory Maximum Capacity']
			= self::convertSize($globalMainboardExtra['Memory Maximum Capacity'] . ' MB', 'G');
		// BIOS section - need to cross-match this with mainboard or system model, as it doesn't have a meaningful
		// identifier on its own
		$bios = self::prepareDmiProperties(self::getDmiHandles($data, 0)[0]);
		foreach (['Version', 'Release Date', 'Firmware Revision'] as $k) {
			if (isset($bios[$k])) {
				$localMainboardExtra['BIOS ' . $k] = $bios[$k];
			}
		}
		if (isset($bios['BIOS Revision'])) {
			$localMainboardExtra['BIOS Revision'] = $bios['BIOS Revision'];
		}
		foreach (['Vendor', 'ROM Size'] as $k) {
			if (isset($bios[$k])) {
				$globalMainboardExtra['BIOS ' . $k] = $bios[$k];
			}
		}
		// Using the general helper function
		$capa = 0;
		$ramModCount = self::updateHwTypeFromDmi($uuid, $data, 17, HardwareInfo::RAM_MODULE, function (array $flat) use (&$capa): bool {
			$size = self::convertSize(($flat['Size'] ?? 0), '', false);
			if ($size > 65 * 1024 * 1024) {
				$capa += $size;
				return true;
			}
			return false;
		},
			['Locator'],
			['Data Width',
				'Size',
				'Form Factor',
				'Type',
				'Type Detail',
				'Speed',
				'Manufacturer',
				'Part Number',
				'Minimum Voltage',
				'Maximum Voltage'],
			['Locator', 'Bank Locator', 'Serial Number', 'Asset Tag', 'Configured Memory Speed', 'Configured Voltage']
		);
		// Fake RAM slots used/total etc. into this
		$localMainboardExtra['Memory Slot Occupied'] = $ramModCount;
		$localMainboardExtra['Memory Installed Capacity'] = self::convertSize($capa, 'G', true);
		foreach (['sockets', 'cores', 'threads'] as $key) {
			if (!isset($data['cpu'][$key]))
				continue;
			$localMainboardExtra['cpu-' . $key] = $data['cpu'][$key];
		}
		self::updateHwTypeFromDmi($uuid, $data, 2, HardwareInfo::MAINBOARD, ['Manufacturer', 'Product Name'],
			[],
			['Manufacturer', 'Product Name', 'Type', 'Version'],
			['Serial Number', 'Asset Tag', 'Location In Chassis'],
			$globalMainboardExtra, $localMainboardExtra
		);
		self::updateHwTypeFromDmi($uuid, $data, 1, HardwareInfo::DMI_SYSTEM, ['Manufacturer', 'Product Name'],
			[],
			['Manufacturer', 'Product Name', 'Version', 'Wake-up Type'],
			['Serial Number', 'UUID', 'SKU Number']
		);
		self::updateHwTypeFromDmi($uuid, $data, 39, HardwareInfo::POWER_SUPPLY, ['Manufacturer'],
			['Location',
				'Power Unit Group',
				'Name'], // Location might be empty/"Unknown", but Name can be something like "PSU 2"
			['Manufacturer', 'Product Name', 'Model Part Number', 'Revision', 'Max Power Capacity'],
			['Serial Number', 'Asset Tag', 'Status', 'Plugged', 'Hot Replaceable']
		);
		self::updateHwTypeFromDmi($uuid, $data, 4, HardwareInfo::CPU, ['Version'],
			['Socket Designation'],
			['Type', 'Family', 'Manufacturer', 'Signature', 'Version', 'Core Count', 'Thread Count'],
			['Voltage', 'Current Speed', 'Upgrade', 'Core Enabled']);
		self::updateHwTypeFromDmi($uuid, $data, 9, HardwareInfo::SYSTEM_SLOT, function (array &$entry): bool {
			if (!isset($entry['Type']))
				return false;
			// Split up PCIe info
			if (preg_match('/^x(?<b>\d+) PCI Express( (?<g>\d+)( x(?<s>\d+))?)?$/', $entry['Type'], $out)) {
				$entry['Type'] = 'PCI Express';
				$entry['PCIe Bus Width'] = $out['b'];
				if (!empty($out['g'])) {
					$entry['PCIe Gen'] = $out['g'];
				}
				if (!empty($out['s'])) {
					$entry['PCIe Slot Width'] = $out['s'];
				}
			}
			return true;
		},
			['Designation', 'ID', 'Bus Address'],
			['Type', 'PCIe Bus Width', 'PCIe Gen', 'PCIe Slot Width'],
			['Current Usage', 'Designation']
		);
		// ---- lspci ------------------------------------
		$pciHwIds = [];
		foreach (($data['lspci'] ?? []) as $dev) {
			$props = self::propsFromArray($dev, 'vendor', 'device', 'rev', 'class');
			if (!isset($props['vendor']) || !isset($props['device']))
				continue;
			$hwid = self::writeGlobalHardwareData(HardwareInfo::PCI_DEVICE, $props);
			$mappingId = self::writeLocalHardwareData($uuid, $hwid, $dev['slot'] ?? 'unknown',
				self::propsFromArray($dev, 'slot', 'subsystem', 'subsystem_vendor', 'iommu_group'));
			$pciHwIds[] = $mappingId;
		}
		self::markDisconnected($uuid, HardwareInfo::PCI_DEVICE, $pciHwIds);
		// ---- Disks ------------------------------------0Y3R3K
		$hddHwIds = [];
		$id44 = $id45 = 0;
		foreach (($data['drives'] ?? []) as $dev) {
			if (empty($dev['readlink']))
				continue;
			if (!isset($dev['smartctl'])) {
				$smart = [];
			} else {
				$smart =& $dev['smartctl'];
			}
			if (!isset($dev['lsblk']['blockdevices'][0])) {
				$lsblk = [];
			} else {
				$lsblk =& $dev['lsblk']['blockdevices'][0];
			}
			if (!isset($smart['rotation_rate']) && isset($lsblk['rota']) && !$lsblk['rota']) {
				$smart['rotation_rate'] = 0;
			}
			$size = $lsblk['size'] ?? $smart['user_capacity']['bytes'] ?? 'unknown';
			$hwid = self::writeGlobalHardwareData(HardwareInfo::HDD, [
					// Try to use the model name as the unique identifier
					'model' => $smart['model_name'] ?? $lsblk['model'] ?? 'unknown',
					// Append device size as some kind of fallback, in case model is unknown
					'size' => $size,
					'physical_block_size' => $smart['physical_block_size'] ?? $lsblk['phy-sec'] ?? 0,
					'logical_block_size' => $smart['logical_block_size'] ?? $lsblk['log-sec'] ?? 0,
				] + self::propsFromArray($smart, 'rotation_rate', 'sata_version//string',
					'interface_speed//max//string', 'model_family'));
			// Mangle smart attribute table
			// TODO: Handle used endurance indicator for (SATA) SSDs
			$table = [];
			foreach (($smart['ata_smart_attributes']['table'] ?? []) as $attr) {
				if (!isset($attr['id']))
					continue;
				$id = 'attr_' . $attr['id'] . '_';
				foreach (['value', 'worst', 'thresh', 'when_failed'] as $item) {
					if (isset($attr[$item])) {
						$table[$id . $item] = $attr[$item];
					}
				}
				if (isset($attr['raw']['value'])) {
					if ($attr['id'] === 194) {
						if (!isset($smart['temperature'])) {
							$smart['temperature'] = [];
						}
						if (!isset($smart['temperature']['current'])) {
							$smart['temperature']['current'] = $attr['raw']['value'] & 0xffff;
						}
						$smart['temperature']['min'] = ($attr['raw']['value'] >> 16) & 0xffff;
						$smart['temperature']['max'] = ($attr['raw']['value'] >> 32) & 0xffff;
					}
					$table[$id . 'raw'] = $attr['raw']['value'];
				}
			}
			if (isset($smart['nvme_smart_health_information_log'])
					&& is_array($smart['nvme_smart_health_information_log'])) {
				$table += array_filter($smart['nvme_smart_health_information_log'], function ($v, $k) {
					return !is_array($v) && $k !== 'temperature' && $k !== 'temperature_sensors';
				}, ARRAY_FILTER_USE_BOTH);
			}
			// Partitions - find special ones
			$used = 0;
			if (isset($dev['sfdisk']['partitiontable'])) {
				$table['partition_table'] = $dev['sfdisk']['partitiontable']['label'] ?? 'none';
				switch ($dev['sfdisk']['partitiontable']['unit'] ?? 'sectors') {
				case 'sectors':
					$fac = 512;
					break;
				case 'bytes':
					$fac = 1;
					break;
				default:
					$fac = 0;
				}
				$i = 0;
				foreach (($dev['sfdisk']['partitiontable']['partitions'] ?? []) as $part) {
					if (!isset($part['size']))
						continue;
					$type = hexdec($part['type'] ?? '0');
					if ($type === 0x0 || $type === 0x5 || $type === 0xf || $type === 0x15 || $type === 0x1f
							|| $type === 0x85 || $type === 0xc5 || $type == 0xcf)
						continue; // Extended partition, ignore
					$used += $part['size'] * $fac;
					$id = 'part_' . $i . '_';
					foreach (['start', 'size', 'type', 'uuid', 'name'] as $item) {
						if (!isset($part[$item]))
							continue;
						if ($item === 'size' || $item === 'start') {
							// Turn size and start into byte offsets
							$table[$id . $item] = $part[$item] * $fac;
						} else {
							$table[$id . $item] = $part[$item];
						}
					}
					$type = $table[$id . 'type'] ?? 0;
					$name = $table[$id . 'name'] ?? '';
					if ($type == '44' || strtolower($type) === '87f86132-ff94-4987-b250-444444444444'
						|| $name === 'OpenSLX-ID44') {
						$table[$id . 'slxtype'] = '44';
						$id44 += $part['size'] * $fac;
					} elseif ($type == '45' || strtolower($type) === '87f86132-ff94-4987-b250-454545454545'
						|| $name === 'OpenSLX-ID45') {
						$table[$id . 'slxtype'] = '45';
						$id45 += $part['size'] * $fac;
					}
					//
					++$i;
				}
			}
			$table['unused'] = $size - $used;
			$table['dev'] = $dev['readlink'];
			$table += self::propsFromArray($smart + ($lsblk ?? []),
				'serial_number', 'firmware_version',
				'interface_speed//current//string',
				'smart_status//passed', 'temperature//current', 'temperature//min', 'temperature//max',
				'power_on_time//hours');
			$mappingId = self::writeLocalHardwareData($uuid, $hwid, $dev['readlink'],
				$table);
			// Delete old partition and smart attribute entries
			Database::exec("DELETE FROM machine_x_hw_prop WHERE machinehwid = :id AND prop NOT IN (:keep)
					AND prop NOT LIKE '@%'", [
				'id' => $mappingId,
				'keep' => array_keys($table),
			]);
			$hddHwIds[] = $mappingId;
			unset($smart, $lsblk);
		} // End loop over disks
		self::markDisconnected($uuid, HardwareInfo::HDD, $hddHwIds);
		//
		// Mark parse date
		Database::exec("UPDATE machine SET dataparsetime = UNIX_TIMESTAMP(), id44mb = :id44, id45mb = :id45
				WHERE machineuuid = :uuid", [
			'uuid' => $uuid,
			'id44' => round($id44 / (1024 * 1024)),
			'id45' => round($id45 / (1024 * 1024)),
		]);
	}

	/**
	 * Unify different variants of manufacturer names
	 */
	private static function fixManufacturer(string $in): string
	{
		$in = self::decodeJedec($in);
		switch (strtolower($in)) {
		case 'advanced micro devices, inc.':
		case 'advanced micro devices':
		case 'authenticamd':
			return 'AMD';
		case 'apple inc.':
			return 'Apple';
		case 'asustek computer inc.':
			return 'ASUS';
		case 'dell inc.':
			return 'Dell';
		case 'fujitsu':
		case 'fujitsu client computing limited':
			return 'Fujitsu';
		case 'hewlett packard':
		case 'hewlett-packard':
			return 'HP';
		case 'hynix semiconduc':
		case 'hynix/hyundai':
		case 'hyundai electronics hynix semiconductor inc':
		case 'hynix semiconductor inc sk hynix':
			return 'SK Hynix';
		case 'genuineintel':
		case 'intel corporation':
		case 'intel(r) corp.':
		case 'intel(r) corporation':
			return 'Intel';
		case 'samsung sdi':
			return 'Samsung';
		}
		return $in;
	}

	/**
	 * Takes key-value-array, returns a new array with only the keys listed in $fields.
	 */
	private static function propsFromArray(array $array, string ...$fields): array
	{
		$ret = [];
		foreach ($fields as $field) {
			if (strpos($field, '//') === false) {
				if (isset($array[$field]) && !is_array($array[$field])) {
					$ret[$field] = $array[$field];
				}
			} else {
				$parts = explode('//', $field);
				$elem = $array;
				foreach ($parts as $part) {
					if (isset($elem[$part])) {
						$elem = $elem[$part];
					} else {
						$elem = false;
						break;
					}
				}
				if ($elem !== false && !is_array($elem)) {
					$ret[preg_replace('~//(value|string)$~', '', $field)] = $elem;
				}
			}
		}
		return $ret;
	}

	private static function updateHwTypeFromDmi(
		string $uuid, array $data, int $type, string $dbType,
				 $requiredPropsOrCallback, array $pathFields, array $globalProps, array $localProps,
		array  $globalExtra = [], array $localExtra = []
	): int
	{
		$sections = self::getDmiHandles($data, $type);
		$thisMachineHwIds = [];
		foreach ($sections as $section) {
			$flat = self::prepareDmiProperties($section);
			if (is_array($requiredPropsOrCallback)) {
				foreach ($requiredPropsOrCallback as $prop) {
					if (!isset($flat[$prop]))
						continue 2;
				}
			}
			if (is_callable($requiredPropsOrCallback)) {
				if (!$requiredPropsOrCallback($flat))
					continue;
			}
			// Global
			$props = self::propsFromArray($flat, ...$globalProps);
			$hwid = self::writeGlobalHardwareData($dbType, $props + $globalExtra);
			// Local
			$pathId = md5(self::idFromArray($flat, ...$pathFields));
			$props = self::propsFromArray($flat, ...$localProps);
			$mappingId = self::writeLocalHardwareData($uuid, $hwid, $pathId, $props + $localExtra);
			$thisMachineHwIds[] = $mappingId;
		}
		// Any hw <-> client mappings not in that list get marked as disconnected
		self::markDisconnected($uuid, $dbType, $thisMachineHwIds);
		return count($thisMachineHwIds);
	}

}