Class LinuxCentralProcessorNF

java.lang.Object

oshi.hardware.common.AbstractCentralProcessor

oshi.hardware.common.platform.linux.LinuxCentralProcessor

oshi.hardware.common.platform.linux.nativefree.LinuxCentralProcessorNF

All Implemented Interfaces:

CentralProcessor

@ThreadSafe
public final class LinuxCentralProcessorNF
extends LinuxCentralProcessor

Native-free Linux central processor implementation. Extends LinuxCentralProcessor, overriding udev-dependent methods with sysfs-based alternatives.

Nested Class Summary

Nested classes/interfaces inherited from interface CentralProcessor

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

Modifier and Type	Interface	Description
static class	CentralProcessor.LogicalProcessor	A class representing a Logical Processor and its replationship to physical processors, physical packages, and logical groupings such as NUMA Nodes and Processor groups, useful for identifying processor topology.
static class	CentralProcessor.PhysicalProcessor	A class representing a Physical Processor (a core) providing per-core statistics that may vary, particularly in hybrid/modular processors.
static class	CentralProcessor.ProcessorCache	A class representing CPU Cache Memory.
static final class	CentralProcessor.ProcessorIdentifier	A class encapsulating ghe CPU's identifier strings ,including name, vendor, stepping, model, and family information (also called the signature of a CPU)
static enum	CentralProcessor.TickType	Index of CPU tick counters in the CentralProcessor.getSystemCpuLoadTicks() and CentralProcessor.getProcessorCpuLoadTicks() arrays.

Constructor Summary

Constructors

Constructor	Description
LinuxCentralProcessorNF()	Creates a new native-free Linux central processor.

Method Summary

Modifier and Type	Method	Description
protected boolean	queryCurrentFreqFromUdev(long[] freqs)	Fills the freqs array from udev cpu-freq source.
protected long	queryMaxFreqFromUdev()	Queries the maximum frequency from udev.
protected Quartet<List<CentralProcessor.LogicalProcessor>, List<CentralProcessor.ProcessorCache>, Map<Integer,Integer>, Map<Integer,String>>	readTopologyWithUdev()	Reads processor topology using udev.

Methods inherited from class LinuxCentralProcessor

getLogicalProcessorFromSyspath, getSystemLoadAverage, initProcessorCounts, queryContextSwitches, queryCurrentFreq, queryCurrentFreqFromSysfs, queryHwcap, queryInterrupts, queryMaxFreq, queryMaxFreqFromCpuFreqPath, queryMaxFreqFromSysfs, queryProcessorCpuLoadTicks, queryProcessorId, querySystemCpuLoadTicks, readTopologyFromSysfs

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)	getLogicalProcessorFromSyspath.
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)	queryCurrentFreqFromSysfs.
protected long	queryHwcap()	Queries the hardware capabilities from the auxiliary vector.
long	queryInterrupts()	Get number of interrupts
long	queryMaxFreq()	Get processor max frequency.
protected static long	queryMaxFreqFromCpuFreqPath(String cpuFreqPath)	Queries the maximum frequency from a cpufreq path.
protected static long	queryMaxFreqFromSysfs()	Queries the maximum frequency from sysfs.
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()	Reads processor topology from sysfs using the default CPU path.

Methods inherited from class AbstractCentralProcessor

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

Modifier and Type	Method	Description
protected static String	createProcessorID(String stepping, String model, String family, String[] flags)	Creates a Processor ID by encoding the stepping, model, family, and feature flags.
protected static String	createProcessorID(String stepping, String model, String family, String[] flags, long hwcap)	Creates a Processor ID by encoding the stepping, model, family, and feature flags.
protected List<CentralProcessor.PhysicalProcessor>	createProcListFromDmesg(List<CentralProcessor.LogicalProcessor> logProcs, Map<Integer,String> dmesg)	Creates a list of physical processors from dmesg output.
long	getContextSwitches()	Get the number of system-wide context switches which have occurred.
long[]	getCurrentFreq()	Attempts to return the current frequency (in Hz), of the logical processors on this CPU.
List<String>	getFeatureFlags()	Returns a list of platform-specific strings which identify CPU Feature Flags.
long	getInterrupts()	Get the number of system-wide interrupts which have occurred.
int	getLogicalProcessorCount()	Get the number of logical CPUs available for processing.
List<CentralProcessor.LogicalProcessor>	getLogicalProcessors()	Returns an UnmodifiableList of the CPU's logical processors.
long	getMaxFreq()	Maximum frequeny (in Hz), of the logical processors on this CPU.
int	getPhysicalPackageCount()	Get the number of packages/sockets in the system.
int	getPhysicalProcessorCount()	Get the number of physical CPUs/cores available for processing.
List<CentralProcessor.PhysicalProcessor>	getPhysicalProcessors()	Returns an UnmodifiableList of the CPU's physical processors.
List<CentralProcessor.ProcessorCache>	getProcessorCaches()	Makes a best-effort attempt to identify the CPU's processor caches.
double[]	getProcessorCpuLoadBetweenTicks(long[][] oldTicks)	Returns the "recent cpu usage" for all logical processors by counting ticks from CentralProcessor.getProcessorCpuLoadTicks() between the user-provided value from a previous call.
double[]	getProcessorCpuLoadBetweenTicks(long[][] oldTicks, long[][] ticks)	Returns the "recent cpu usage" for all logical processors by counting ticks from CentralProcessor.getProcessorCpuLoadTicks() between the user-provided value from a previous call.
long[][]	getProcessorCpuLoadTicks()	Get Processor CPU Load tick counters.
CentralProcessor.ProcessorIdentifier	getProcessorIdentifier()	The CPU's identifier strings ,including name, vendor, stepping, model, and family information (also called the signature of a CPU).
double	getSystemCpuLoadBetweenTicks(long[] oldTicks)	Returns the "recent cpu usage" for the whole system by counting ticks from CentralProcessor.getSystemCpuLoadTicks() between the user-provided value from a previous call.
double	getSystemCpuLoadBetweenTicks(long[] oldTicks, long[] ticks)	Returns the "recent cpu usage" for the whole system by counting ticks between two user-provided values, retrieved from CentralProcessor.getSystemCpuLoadTicks() at different points in time.
long[]	getSystemCpuLoadTicks()	Get System-wide CPU Load tick counters.
static List<CentralProcessor.ProcessorCache>	orderedProcCaches(Set<CentralProcessor.ProcessorCache> caches)	Filters a set of processor caches to an ordered list
String	toString()

Methods inherited from class Object

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

Methods inherited from interface CentralProcessor

getProcessorCpuLoad, getSystemCpuLoad

Modifier and Type	Method	Description
default double[]	getProcessorCpuLoad(long delay)	This is a convenience method which collects an initial set of ticks using CentralProcessor.getProcessorCpuLoadTicks() and passes that result to CentralProcessor.getProcessorCpuLoadBetweenTicks(long[][]) after the specified delay.
default double	getSystemCpuLoad(long delay)	This is a convenience method which collects an initial set of ticks using CentralProcessor.getSystemCpuLoadTicks() and passes that result to CentralProcessor.getSystemCpuLoadBetweenTicks(long[]) after the specified delay.

Constructor Details

LinuxCentralProcessorNF

public LinuxCentralProcessorNF()

Creates a new native-free Linux central processor.

Method Details

readTopologyWithUdev

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

Description copied from class: LinuxCentralProcessor

Reads processor topology using udev.

Specified by:

readTopologyWithUdev in class LinuxCentralProcessor

Returns:

a quartet of logical processors, caches, efficiency map, and modalias map

queryCurrentFreqFromUdev

protected boolean queryCurrentFreqFromUdev(long[] freqs)

Description copied from class: LinuxCentralProcessor

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

Specified by:

queryCurrentFreqFromUdev in class LinuxCentralProcessor

Parameters:

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

Returns:

true if frequencies were successfully read

queryMaxFreqFromUdev

protected long queryMaxFreqFromUdev()

Description copied from class: LinuxCentralProcessor

Queries the maximum frequency from udev.

Specified by:

queryMaxFreqFromUdev in class LinuxCentralProcessor

Returns:

the maximum frequency in Hz