Package oshi.software.common

Class AbstractOSProcess

java.lang.Object

oshi.software.common.AbstractOSProcess

All Implemented Interfaces:

OSProcess

Direct Known Subclasses:

AixOSProcess, FreeBsdOSProcess, LinuxOSProcess, MacOSProcess, SolarisOSProcess, WindowsOSProcess

@ThreadSafe
public abstract class AbstractOSProcess
extends java.lang.Object
implements OSProcess

A process is an instance of a computer program that is being executed. It contains the program code and its current activity. Depending on the operating system (OS), a process may be made up of multiple threads of execution that execute instructions concurrently.

Nested Class Summary

Nested classes/interfaces inherited from interface oshi.software.os.OSProcess

OSProcess.State

Constructor Summary

Constructors

Constructor	Description
AbstractOSProcess(int pid)

Method Summary

Modifier and Type	Method	Description
long	getMajorFaults()	The number of major (hard) faults the process has made which have required loading a memory page from disk.
long	getMinorFaults()	The number of minor (soft) faults the process has made which have not required loading a memory page from disk.
double	getProcessCpuLoadBetweenTicks(OSProcess priorSnapshot)	Gets CPU usage of this process since a previous snapshot of the same process, provided as a parameter.
double	getProcessCpuLoadCumulative()	Gets cumulative CPU usage of this process.
int	getProcessID()	Getter for the field processID.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface oshi.software.os.OSProcess

getAffinityMask, getBitness, getBytesRead, getBytesWritten, getCommandLine, getCurrentWorkingDirectory, getGroup, getGroupID, getKernelTime, getName, getOpenFiles, getParentProcessID, getPath, getPriority, getResidentSetSize, getStartTime, getState, getThreadCount, getThreadDetails, getUpTime, getUser, getUserID, getUserTime, getVirtualSize, updateAttributes

Constructor Details

AbstractOSProcess

public AbstractOSProcess(int pid)

Method Details

getProcessID

public int getProcessID()

Description copied from interface: OSProcess

Getter for the field processID.

Specified by:

getProcessID in interface OSProcess

Returns:

Returns the processID.

getProcessCpuLoadCumulative

public double getProcessCpuLoadCumulative()

Description copied from interface: OSProcess

Gets cumulative CPU usage of this process.

This calculation sums CPU ticks across all processors and may exceed 100% for multi-threaded processes. This is consistent with the cumulative CPU presented by the "top" command on Linux/Unix machines.

Specified by:

getProcessCpuLoadCumulative in interface OSProcess

Returns:

The proportion of up time that the process was executing in kernel or user mode.

getProcessCpuLoadBetweenTicks

public double getProcessCpuLoadBetweenTicks(OSProcess priorSnapshot)

Description copied from interface: OSProcess

Gets CPU usage of this process since a previous snapshot of the same process, provided as a parameter.

This calculation sums CPU ticks across all processors and may exceed 100% for multi-threaded processes. This is consistent with process usage calulations on Linux/Unix machines, but should be divided by the number of logical processors to match the value displayed by the Windows Task Manager.

The accuracy of this calculation is dependent on both the number of threads on which the process is executing, and the precision of the Operating System's tick counters. A polling interval of at least a few seconds is recommended.

Specified by:

getProcessCpuLoadBetweenTicks in interface OSProcess

Parameters:

priorSnapshot - An OSProcess object containing statistics for this same process collected at a prior point in time. May be null.

Returns:

If the prior snapshot is for the same process at a prior point in time, the proportion of elapsed up time between the current process snapshot and the previous one that the process was executing in kernel or user mode. Returns cumulative load otherwise.

getMinorFaults

public long getMinorFaults()

Description copied from interface: OSProcess

The number of minor (soft) faults the process has made which have not required loading a memory page from disk. Sometimes called reclaims.

Not available on Solaris. On Windows, this includes the total of major and minor faults.

Specified by:

getMinorFaults in interface OSProcess

Returns:

minor page faults (reclaims).

getMajorFaults

public long getMajorFaults()

Description copied from interface: OSProcess

The number of major (hard) faults the process has made which have required loading a memory page from disk.

Not available on Solaris. Windows does not distinguish major and minor faults at the process level, so this value returns 0 and major faults are included in OSProcess.getMinorFaults().

Specified by:

getMajorFaults in interface OSProcess

Returns:

major page faults.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object