Class LinuxHardwareAbstractionLayerJNA

All Implemented Interfaces:
HardwareAbstractionLayer

@ThreadSafe public final class LinuxHardwareAbstractionLayerJNA extends LinuxHardwareAbstractionLayer
JNA-based Linux hardware abstraction layer. Extends LinuxHardwareAbstractionLayer, overriding methods as FFM equivalents are migrated to LinuxHardwareAbstractionLayerFFM.
  • Constructor Details

    • LinuxHardwareAbstractionLayerJNA

      public LinuxHardwareAbstractionLayerJNA()
  • Method Details

    • getLogicalVolumeGroups

      public List<LogicalVolumeGroup> getLogicalVolumeGroups()
      Description copied from interface: HardwareAbstractionLayer
      Instantiates a list of LogicalVolumeGroup objects, representing a storage pool or group of devices, partitions, volumes, or other implementation specific means of file storage.

      If not yet implemented or if logical volume groups do not exist, returns an empty list.

      Currently implemented for Linux (LVM2), macOS (Core Storage), and Windows (Storage Spaces).

      Returns:
      A list of LogicalVolumeGroup objects or an empty list if none are present.
    • getNetworkIFs

      public List<NetworkIF> getNetworkIFs(boolean includeLocalInterfaces)
      Description copied from interface: HardwareAbstractionLayer
      Gets a list NetworkIF objects, representing a network interface.
      Parameters:
      includeLocalInterfaces - whether to include local interfaces (loopback or no hardware address) in the result
      Returns:
      A list of NetworkIF objects representing the interfaces
    • getDiskStores

      public List<HWDiskStore> getDiskStores()
      Description copied from interface: HardwareAbstractionLayer
      Instantiates a list of HWDiskStore objects, representing physical hard disks or other similar storage devices.
      Returns:
      A list of HWDiskStore objects or an empty list if none are present.
    • getUsbDevices

      public List<UsbDevice> getUsbDevices(boolean tree)
      Description copied from interface: HardwareAbstractionLayer
      Instantiates a list of UsbDevice objects, representing devices connected via a usb port (including internal devices).

      If the value of tree is true, the top level devices returned from this method are the USB Controllers; connected hubs and devices in its device tree share that controller's bandwidth. If the value of tree is false, USB devices (not controllers) are listed in a single flat list.

      Note: in both cases each UsbDevice in the returned list may still report connected child devices via UsbDevice.getConnectedDevices(). When tree is false the list is intended for simple iteration over individual devices; callers should not recurse into UsbDevice.getConnectedDevices() or rely on Object.toString() (which renders the full subtree) to avoid processing devices more than once.

      To print the full device tree rooted at each controller:

      for (UsbDevice controller : hal.getUsbDevices(true)) {
          System.out.println(controller); // toString() renders the full subtree
      }
      
      To iterate individual devices without tree structure:
      for (UsbDevice device : hal.getUsbDevices(false)) {
          // Use individual fields; avoid toString() as it includes the subtree
          System.out.println(device.getName() + " [" + device.getVendorId() + ":" + device.getProductId() + "]");
      }
      
      Parameters:
      tree - If true, returns the USB Controllers as top-level entries, with connected hubs and devices accessible via UsbDevice.getConnectedDevices(). If false, returns a flat list of non-controller devices; UsbDevice.getConnectedDevices() may still be non-empty but should not be iterated to avoid duplicates.
      Returns:
      A list of UsbDevice objects representing (optionally) the USB Controllers and devices connected to them, or an empty list if none are present
    • getPowerSources

      public List<PowerSource> getPowerSources()
      Description copied from interface: HardwareAbstractionLayer
      Instantiates a list of PowerSource objects, representing batteries, etc.
      Returns:
      A list of PowerSource objects or an empty list if none are present.