Class LinuxHardwareAbstractionLayerFFM

java.lang.Object
oshi.hardware.common.AbstractHardwareAbstractionLayer
oshi.hardware.platform.linux.LinuxHardwareAbstractionLayer
oshi.hardware.platform.linux.LinuxHardwareAbstractionLayerFFM
All Implemented Interfaces:
HardwareAbstractionLayer
@ThreadSafe public final class LinuxHardwareAbstractionLayerFFM extends LinuxHardwareAbstractionLayer
FFM-based hardware abstraction layer for Linux. Extends LinuxHardwareAbstractionLayer, overriding methods as FFM implementations become available.

  • Constructor Details

    • LinuxHardwareAbstractionLayerFFM

      public LinuxHardwareAbstractionLayerFFM()

  • Method Details

    • createProcessor

      public CentralProcessor createProcessor()
      Description copied from class: AbstractHardwareAbstractionLayer
      Instantiates the platform-specific CentralProcessor object
      Overrides:
      createProcessor in class LinuxHardwareAbstractionLayer
      Returns:
      platform-specific CentralProcessor object

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

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

    • 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