Class LinuxOSProcessJNA

java.lang.Object

oshi.software.common.AbstractOSProcess

oshi.software.common.os.linux.LinuxOSProcess

oshi.software.os.linux.LinuxOSProcessJNA

All Implemented Interfaces:

OSProcess

@ThreadSafe
public class LinuxOSProcessJNA
extends LinuxOSProcess

JNA-based Linux OS process. Implements getrlimit and getrusage via JNA.

Nested Class Summary

Nested classes/interfaces inherited from interface OSProcess

OSProcess.State

Modifier and Type	Interface	Description
static enum	OSProcess.State	Process and Thread Execution States

Constructor Summary

Constructors

Constructor	Description
LinuxOSProcessJNA(int pid, LinuxOperatingSystem os)

Method Summary

Modifier and Type	Method	Description
long	getInvoluntaryContextSwitches()	The number of involuntary context switches the process has made.
long	getVoluntaryContextSwitches()	The number of voluntary context switches the process has made.
protected long	queryRlimitHard()	Queries the hard open file limit for the current process via native getrlimit.
protected long	queryRlimitSoft()	Queries the soft open file limit for the current process via native getrlimit.
boolean	updateAttributes()	Attempts to update process attributes.

Methods inherited from class LinuxOSProcess

getAffinityMask, getArguments, getBitness, getBytesRead, getBytesWritten, getCommandLine, getCurrentWorkingDirectory, getEnvironmentVariables, getGroup, getGroupID, getHardOpenFileLimit, getKernelTime, getMajorFaults, getMinorFaults, getName, getOpenFiles, getOs, getParentProcessID, getPath, getPriority, getPrivateResidentMemory, getProcessOpenFileLimit, getResidentMemory, getSoftOpenFileLimit, getStartTime, getState, getThreadCount, getThreadDetails, getUpTime, getUser, getUserID, getUserTime, getVirtualSize

Modifier and Type	Method	Description
long	getAffinityMask()	Gets the process affinity mask for this process.
List<String>	getArguments()	Makes a best effort attempt to get a list of the the command-line arguments of the process.
int	getBitness()	Attempts to get the bitness (32 or 64) of the process.
long	getBytesRead()	Gets the bytes read by the process.
long	getBytesWritten()	Gets the bytes written by the process.
String	getCommandLine()	Gets the process command line used to start the process, including arguments if available to be determined.
String	getCurrentWorkingDirectory()	Makes a best effort attempt to obtain the current working directory for the process.
Map<String,String>	getEnvironmentVariables()	Makes a best effort attempt to obtain the environment variables of the process.
String	getGroup()	Gets the group under which the process is executing.
String	getGroupID()	Gets the group id under which the process is executing.
long	getHardOpenFileLimit()	Gets the hard limit for open file handles (or network connections) that belong to the given process.
long	getKernelTime()	Gets kernel/system (privileged) time used by the process.
long	getMajorFaults()	Gets the number of major (hard) faults the process has made which have required loading a memory page from disk.
long	getMinorFaults()	Gets the number of minor (soft) faults the process has made which have not required loading a memory page from disk.
String	getName()	Gets the name of the process, often the executable program.
long	getOpenFiles()	Gets the number of open file handles (or network connections) that belongs to the process.
protected LinuxOperatingSystem	getOs()	Returns the LinuxOperatingSystem instance associated with this process.
int	getParentProcessID()	Gets the process ID of this process's parent.
String	getPath()	Gets the full filesystem path of the executing process.
int	getPriority()	Gets the priority of this process.
long	getPrivateResidentMemory()	Returns an estimate of the portion of physical memory (RAM) uniquely attributed to this process.
protected long	getProcessOpenFileLimit(long processId, int index)	Gets the open file limit for a process.
long	getResidentMemory()	Returns the total amount of physical memory (RAM) currently mapped to the process's address space.
long	getSoftOpenFileLimit()	Gets the soft limit for open file handles (or network connections) of the given process.
long	getStartTime()	Gets the process start time.
OSProcess.State	getState()	Gets the process state.
int	getThreadCount()	Gets the number of threads being executed by this process.
List<OSThread>	getThreadDetails()	Retrieves the threads of the process and their details.
long	getUpTime()	Gets up time / elapsed time since the process started.
String	getUser()	Gets the user name of the process owner.
String	getUserID()	Gets the user id of the process owner.
long	getUserTime()	Gets user time used by the process.
long	getVirtualSize()	Gets the Virtual Memory Size (VSZ).

Methods inherited from class AbstractOSProcess

getProcessCpuLoadBetweenTicks, getProcessCpuLoadCumulative, getProcessID, toString

Modifier and Type	Method	Description
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()	Gets the process ID.
String	toString()

Methods inherited from class Object

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

Methods inherited from interface OSProcess

getContextSwitches

Modifier and Type	Method	Description
default long	getContextSwitches()	A snapshot of the context switches the process has done, equal to the sum of OSProcess.getVoluntaryContextSwitches() and OSProcess.getInvoluntaryContextSwitches() on platforms that provide the split.

Constructor Details

LinuxOSProcessJNA

public LinuxOSProcessJNA(int pid,
 LinuxOperatingSystem os)

Method Details

updateAttributes

public boolean updateAttributes()

Description copied from interface: OSProcess

Attempts to update process attributes. Returns false if the update fails, which will occur if the process no longer exists.

Specified by:

updateAttributes in interface OSProcess

Overrides:

updateAttributes in class LinuxOSProcess

Returns:

true if the update was successful, false if the update failed. In addition, on a failed update the process state will be changed to OSProcess.State.INVALID.

getVoluntaryContextSwitches

public long getVoluntaryContextSwitches()

Description copied from interface: OSProcess

The number of voluntary context switches the process has made. A voluntary context switch occurs when a process gives up the CPU before its time slice expires (e.g., waiting for I/O).

For the current process, getrusage(RUSAGE_SELF) is used on supported POSIX platforms, which aggregates across all threads. For other processes, platform-specific sources are used (/proc/[pid]/status on Linux, ps on FreeBSD/OpenBSD, /proc/[pid]/usage on Solaris). On macOS, the split is only available for the current process; for other processes this returns 0.

Specified by:

getVoluntaryContextSwitches in interface OSProcess

Overrides:

getVoluntaryContextSwitches in class LinuxOSProcess

Returns:

voluntary context switches if available, 0 otherwise.

getInvoluntaryContextSwitches

public long getInvoluntaryContextSwitches()

Description copied from interface: OSProcess

The number of involuntary context switches the process has made. An involuntary context switch occurs when the scheduler preempts the process (e.g., time slice expired).

For the current process, getrusage(RUSAGE_SELF) is used on supported POSIX platforms, which aggregates across all threads. For other processes, platform-specific sources are used (/proc/[pid]/status on Linux, ps on FreeBSD/OpenBSD, /proc/[pid]/usage on Solaris). On macOS, the split is only available for the current process; for other processes this returns 0.

Specified by:

getInvoluntaryContextSwitches in interface OSProcess

Overrides:

getInvoluntaryContextSwitches in class LinuxOSProcess

Returns:

involuntary context switches if available, 0 otherwise.

queryRlimitSoft

protected long queryRlimitSoft()

Description copied from class: LinuxOSProcess

Queries the soft open file limit for the current process via native getrlimit.

Specified by:

queryRlimitSoft in class LinuxOSProcess

Returns:

the soft limit value

queryRlimitHard

protected long queryRlimitHard()

Description copied from class: LinuxOSProcess

Queries the hard open file limit for the current process via native getrlimit.

Specified by:

queryRlimitHard in class LinuxOSProcess

Returns:

the hard limit value