// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : List.cs // Author(s) : Natalia Portillo // // Component : Direct device access. // // --[ Description ] ---------------------------------------------------------- // // Gets a list of known physical devices. // // --[ License ] -------------------------------------------------------------- // // This library is free software; you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as // published by the Free Software Foundation; either version 2.1 of the // License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, see . // // ---------------------------------------------------------------------------- // Copyright © 2011-2025 Natalia Portillo // ****************************************************************************/ using System; using System.Runtime.InteropServices; using Aaru.CommonTypes.Interop; using Aaru.Logging; using Sentry; namespace Aaru.Devices; /// Contains device information [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi, Pack = 1)] public struct DeviceInfo { /// Device path [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 1024)] public string Path; /// Device vendor or manufacturer [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Vendor; /// Device model or product name [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Model; /// Device serial number [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Serial; /// Bus the device is attached to [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Bus; /// /// Set to true if Aaru can send commands to the device in the current machine or remote, false /// otherwise /// [MarshalAs(UnmanagedType.U1)] public bool Supported; /// Padding [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public readonly byte[] Padding; } public partial class Device { /// Lists devices attached to current machine /// List of devices public static DeviceInfo[] ListDevices() => ListDevices(out _, out _, out _, out _, out _, out _); /// Lists devices attached to current machine or specified remote /// Is remote /// Remote application /// Remote application version /// Remote operating system name /// Remote operating system version /// Remote architecture /// Remote URI /// List of devices /// public static DeviceInfo[] ListDevices(out bool isRemote, out string serverApplication, out string serverVersion, out string serverOperatingSystem, out string serverOperatingSystemVersion, out string serverArchitecture, string aaruRemote = null) { isRemote = false; serverApplication = null; serverVersion = null; serverOperatingSystem = null; serverOperatingSystemVersion = null; serverArchitecture = null; if(aaruRemote is null) { if(OperatingSystem.IsWindows()) return Windows.ListDevices.GetList(); if(OperatingSystem.IsLinux()) return Linux.ListDevices.GetList(); throw new InvalidOperationException(string.Format(Localization.Platform_0_not_yet_supported, DetectOS.GetRealPlatformID())); } try { var aaruUri = new Uri(aaruRemote); if(aaruUri.Scheme != "aaru" && aaruUri.Scheme != "dic") { AaruLogging.Error(Localization.Invalid_remote_URI); return []; } using var remote = new Remote.Remote(aaruUri); isRemote = true; serverApplication = remote.ServerApplication; serverVersion = remote.ServerVersion; serverOperatingSystem = remote.ServerOperatingSystem; serverOperatingSystemVersion = remote.ServerOperatingSystemVersion; serverArchitecture = remote.ServerArchitecture; return remote.ListDevices(); } catch(Exception ex) { SentrySdk.CaptureException(ex); AaruLogging.Exception(ex, Localization.Error_connecting_to_host); AaruLogging.Error(Localization.Error_connecting_to_host); return []; } } }