Package oshi.software.common

Class AbstractOSProcess

java.lang.Object
oshi.software.common.AbstractOSProcess
All Implemented Interfaces:
OSProcess
Direct Known Subclasses:
AixOSProcess, FreeBsdOSProcess, LinuxOSProcess, MacOSProcess, OpenBsdOSProcess, SolarisOSProcess, WindowsOSProcess
@ThreadSafe public abstract class AbstractOSProcess extends 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.

  • Constructor Details

    • AbstractOSProcess

      protected AbstractOSProcess(int pid)

  • Method Details

    • getProcessID

      public int getProcessID()
      Description copied from interface: OSProcess
      Gets the process ID.

      While this is a 32-bit value, it is unsigned on Windows and in extremely rare circumstances may return a negative value.

      Specified by:
      getProcessID in interface OSProcess
      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.

    • toString

      public String toString()
      Overrides:
      toString in class Object