Class LinuxCentralProcessorFFM

java.lang.Object

oshi.hardware.common.AbstractCentralProcessor

oshi.hardware.platform.linux.LinuxCentralProcessorFFM

All Implemented Interfaces:

CentralProcessor

@ThreadSafe
public final class LinuxCentralProcessorFFM
extends AbstractCentralProcessor

FFM-based Linux central processor implementation. Extends LinuxCentralProcessor, overriding udev-dependent methods with FFM implementations via UdevFunctions.

Nested Class Summary

Nested classes/interfaces inherited from interface CentralProcessor

CentralProcessor.LogicalProcessor, CentralProcessor.PhysicalProcessor, CentralProcessor.ProcessorCache, CentralProcessor.ProcessorIdentifier, CentralProcessor.TickType

Constructor Summary

Constructors

Constructor	Description
LinuxCentralProcessorFFM()

Method Summary

Modifier and Type	Method	Description
protected static CentralProcessor.LogicalProcessor	getLogicalProcessorFromSyspath(String syspath, Set<CentralProcessor.ProcessorCache> caches, String modAlias, Map<Integer,Integer> coreEfficiencyMap, Map<Integer,String> modAliasMap)
double[]	getSystemLoadAverage(int nelem)	Returns the system load average for the number of elements specified, up to 3, representing 1, 5, and 15 minutes.
protected Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.PhysicalProcessor>, List<CentralProcessor.ProcessorCache>, List<String>>	initProcessorCounts()	Initializes logical and physical processor lists and feature flags.
long	queryContextSwitches()	Get number of context switches
long[]	queryCurrentFreq()	Get processor current frequency.
protected static boolean	queryCurrentFreqFromSysfs(long[] freqs)
protected boolean	queryCurrentFreqFromUdev(long[] freqs)	Fills the freqs array from udev cpu-freq source.
long	queryInterrupts()	Get number of interrupts
long	queryMaxFreq()	Get processor max frequency.
protected static long	queryMaxFreqFromCpuFreqPath(String cpuFreqPath)
protected static long	queryMaxFreqFromSysfs()
protected long	queryMaxFreqFromUdev()	Queries the max CPU frequency from udev.
long[][]	queryProcessorCpuLoadTicks()	Get the processor CPU load ticks
protected CentralProcessor.ProcessorIdentifier	queryProcessorId()	Updates logical and physical processor counts and arrays
long[]	querySystemCpuLoadTicks()	Get the system CPU load ticks
protected static Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.ProcessorCache>, Map<Integer,Integer>, Map<Integer,String>>	readTopologyFromSysfs()
protected Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.ProcessorCache>, Map<Integer,Integer>, Map<Integer,String>>	readTopologyWithUdev()	Reads CPU topology using udev.

Methods inherited from class AbstractCentralProcessor

createProcessorID, createProcListFromDmesg, getContextSwitches, getCurrentFreq, getFeatureFlags, getInterrupts, getLogicalProcessorCount, getLogicalProcessors, getMaxFreq, getPhysicalPackageCount, getPhysicalProcessorCount, getPhysicalProcessors, getProcessorCaches, getProcessorCpuLoadBetweenTicks, getProcessorCpuLoadBetweenTicks, getProcessorCpuLoadTicks, getProcessorIdentifier, getSystemCpuLoadBetweenTicks, getSystemCpuLoadBetweenTicks, getSystemCpuLoadTicks, orderedProcCaches, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface CentralProcessor

getProcessorCpuLoad, getSystemCpuLoad

Constructor Details

LinuxCentralProcessorFFM

public LinuxCentralProcessorFFM()

Method Details

getSystemLoadAverage

public double[] getSystemLoadAverage(int nelem)

Description copied from interface: CentralProcessor

Returns the system load average for the number of elements specified, up to 3, representing 1, 5, and 15 minutes. The system load average is the sum of the number of runnable entities queued to the available processors and the number of runnable entities running on the available processors averaged over a period of time.

This method is designed to provide a hint about the system load and may be queried frequently.

The way in which the load average is calculated is operating system specific but is typically a damped time-dependent average. Linux includes processes waiting for system resources such as disks, while macOS and Unix consider only processes waiting for CPU.

Windows does not provide a load average. Users may set the configuration property oshi.os.windows.loadaverage to true to start a daemon thread which will provide a similar metric.

The load average may be unavailable on some platforms (e.g., Windows without the above configuration). If the load average is not available, a negative value is returned.

Specified by:

getSystemLoadAverage in interface CentralProcessor

Parameters:

nelem - Number of elements to return.

Returns:

an array of the system load averages for 1, 5, and 15 minutes with the size of the array specified by nelem; or negative values if not available.

readTopologyWithUdev

protected Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.ProcessorCache>, Map<Integer,Integer>, Map<Integer,String>> readTopologyWithUdev()

Reads CPU topology using udev. Subclasses provide the implementation.

Returns:

topology quartet of logical processors, caches, core efficiency map, and mod alias map

queryCurrentFreqFromUdev

protected boolean queryCurrentFreqFromUdev(long[] freqs)

Fills the freqs array from udev cpu-freq source. Returns true if successful (max > 0). Subclasses provide the implementation.

Parameters:

freqs - array to fill with per-logical-processor frequencies in Hz

Returns:

true if frequencies were successfully read

queryMaxFreqFromUdev

protected long queryMaxFreqFromUdev()

Queries the max CPU frequency from udev. Subclasses provide the implementation.

Returns:

max frequency in Hz, or -1 if unavailable

queryProcessorId

protected CentralProcessor.ProcessorIdentifier queryProcessorId()

Description copied from class: AbstractCentralProcessor

Updates logical and physical processor counts and arrays

Specified by:

queryProcessorId in class AbstractCentralProcessor

Returns:

An array of initialized Logical Processors

initProcessorCounts

protected Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.PhysicalProcessor>, List<CentralProcessor.ProcessorCache>, List<String>> initProcessorCounts()

Description copied from class: AbstractCentralProcessor

Initializes logical and physical processor lists and feature flags.

Specified by:

initProcessorCounts in class AbstractCentralProcessor

Returns:

Lists of initialized Logical Processors, Physical Processors, Processor Caches, and Feature Flags.

readTopologyFromSysfs

protected static Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.ProcessorCache>, Map<Integer,Integer>, Map<Integer,String>> readTopologyFromSysfs()

getLogicalProcessorFromSyspath

protected static CentralProcessor.LogicalProcessor getLogicalProcessorFromSyspath(String syspath,
 Set<CentralProcessor.ProcessorCache> caches,
 String modAlias,
 Map<Integer,Integer> coreEfficiencyMap,
 Map<Integer,String> modAliasMap)

querySystemCpuLoadTicks

public long[] querySystemCpuLoadTicks()

Description copied from class: AbstractCentralProcessor

Get the system CPU load ticks

Specified by:

querySystemCpuLoadTicks in class AbstractCentralProcessor

Returns:

The system CPU load ticks

queryCurrentFreq

public long[] queryCurrentFreq()

Description copied from class: AbstractCentralProcessor

Get processor current frequency.

Specified by:

queryCurrentFreq in class AbstractCentralProcessor

Returns:

The current frequency.

queryCurrentFreqFromSysfs

protected static boolean queryCurrentFreqFromSysfs(long[] freqs)

queryMaxFreq

public long queryMaxFreq()

Description copied from class: AbstractCentralProcessor

Get processor max frequency.

Overrides:

queryMaxFreq in class AbstractCentralProcessor

Returns:

The max frequency.

queryMaxFreqFromSysfs

protected static long queryMaxFreqFromSysfs()

queryMaxFreqFromCpuFreqPath

protected static long queryMaxFreqFromCpuFreqPath(String cpuFreqPath)

queryProcessorCpuLoadTicks

public long[][] queryProcessorCpuLoadTicks()

Description copied from class: AbstractCentralProcessor

Get the processor CPU load ticks

Specified by:

queryProcessorCpuLoadTicks in class AbstractCentralProcessor

Returns:

The processor CPU load ticks

queryContextSwitches

public long queryContextSwitches()

Description copied from class: AbstractCentralProcessor

Get number of context switches

Specified by:

queryContextSwitches in class AbstractCentralProcessor

Returns:

The context switches

queryInterrupts

public long queryInterrupts()

Description copied from class: AbstractCentralProcessor

Get number of interrupts

Specified by:

queryInterrupts in class AbstractCentralProcessor

Returns:

The interrupts