Class MacOSProcessJNA

java.lang.Object

oshi.software.common.AbstractOSProcess

oshi.software.common.os.mac.MacOSProcess

oshi.software.os.mac.MacOSProcessJNA

All Implemented Interfaces:

OSProcess

@ThreadSafe
public class MacOSProcessJNA
extends MacOSProcess

JNA-backed macOS OSProcess.

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

Field Summary

Fields inherited from class MacOSProcess

bitness, contextSwitches, currentWorkingDirectory, group, groupID, involuntaryContextSwitches, LOG_MAC_SYSCTL_WARNING, MAC_RLIMIT_NOFILE, majorFaults, majorVersion, memoryFootprint, minorFaults, minorVersion, openFiles, os, P_LP64, residentSetSize, user, userID, voluntaryContextSwitches

Modifier and Type	Field	Description
protected int	bitness
protected long	contextSwitches
protected String	currentWorkingDirectory
protected String	group
protected String	groupID
protected long	involuntaryContextSwitches
protected static final boolean	LOG_MAC_SYSCTL_WARNING
protected static final int	MAC_RLIMIT_NOFILE
protected long	majorFaults
protected final int	majorVersion
protected long	memoryFootprint
protected long	minorFaults
protected final int	minorVersion
protected long	openFiles
protected final MacOperatingSystem	os
protected static final int	P_LP64
protected long	residentSetSize
protected String	user
protected String	userID
protected long	voluntaryContextSwitches

Fields inherited from class AbstractOSProcess

bytesRead, bytesWritten, kernelTime, name, parentProcessID, path, priority, startTime, state, threadCount, upTime, userTime, virtualSize

Modifier and Type	Field	Description
protected long	bytesRead
protected long	bytesWritten
protected long	kernelTime
protected String	name
protected int	parentProcessID
protected String	path
protected int	priority
protected long	startTime
protected OSProcess.State	state
protected int	threadCount
protected long	upTime
protected long	userTime
protected long	virtualSize

Constructor Summary

Constructors

Constructor	Description
MacOSProcessJNA(int pid, int major, int minor, MacOperatingSystem os)

Method Summary

Modifier and Type	Method	Description
long	getHardOpenFileLimit()	Gets the hard limit for open file handles (or network connections) that belong to the given process.
long	getSoftOpenFileLimit()	Gets the soft limit for open file handles (or network connections) of the given process.
protected Pair<List<String>, Map<String,String>>	queryArgsAndEnvironment()	Queries this process's arguments and environment via the backend-specific KERN_PROCARGS2 sysctl.
protected int	queryLogicalProcessorCount()	Returns the number of logical processors via the backend-specific hw.logicalcpu sysctl.
boolean	updateAttributes()	Attempts to update process attributes.

Methods inherited from class MacOSProcess

getAffinityMask, getArguments, getBitness, getCommandLine, getContextSwitches, getCurrentWorkingDirectory, getEnvironmentVariables, getGroup, getGroupID, getInvoluntaryContextSwitches, getMajorFaults, getMinorFaults, getOpenFiles, getPrivateResidentMemory, getResidentMemory, getThreadDetails, getUser, getUserID, getVoluntaryContextSwitches, stateFromStatus

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.
String	getCommandLine()	Gets the process command line used to start the process, including arguments if available to be determined.
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.
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	getInvoluntaryContextSwitches()	The number of involuntary context switches the process has made.
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.
long	getOpenFiles()	Gets the number of open file handles (or network connections) that belongs to the process.
long	getPrivateResidentMemory()	Returns an estimate of the portion of physical memory (RAM) uniquely attributed to this process.
long	getResidentMemory()	Returns the total amount of physical memory (RAM) currently mapped to the process's address space.
List<OSThread>	getThreadDetails()	Retrieves the threads of the process and their details.
String	getUser()	Gets the user name of the process owner.
String	getUserID()	Gets the user id of the process owner.
long	getVoluntaryContextSwitches()	The number of voluntary context switches the process has made.
protected static OSProcess.State	stateFromStatus(int status)	Maps a macOS pbi_status value to an OSProcess.State.

Methods inherited from class AbstractOSProcess

getBytesRead, getBytesWritten, getKernelTime, getName, getParentProcessID, getPath, getPriority, getProcessCpuLoadBetweenTicks, getProcessCpuLoadCumulative, getProcessID, getStartTime, getState, getThreadCount, getUpTime, getUserTime, getVirtualSize, toString

Modifier and Type	Method	Description
long	getBytesRead()	Gets the bytes read by the process.
long	getBytesWritten()	Gets the bytes written by the process.
long	getKernelTime()	Gets kernel/system (privileged) time used by the process.
String	getName()	Gets the name of the process, often the executable program.
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.
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.
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.
long	getUpTime()	Gets up time / elapsed time since the process started.
long	getUserTime()	Gets user time used by the process.
long	getVirtualSize()	Gets the Virtual Memory Size (VSZ).
String	toString()

Methods inherited from class Object

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

Constructor Details

MacOSProcessJNA

public MacOSProcessJNA(int pid,
 int major,
 int minor,
 MacOperatingSystem os)

Method Details

queryArgsAndEnvironment

protected Pair<List<String>, Map<String,String>> queryArgsAndEnvironment()

Description copied from class: MacOSProcess

Queries this process's arguments and environment via the backend-specific KERN_PROCARGS2 sysctl.

Specified by:

queryArgsAndEnvironment in class MacOSProcess

Returns:

a pair of the argument list and the environment map

queryLogicalProcessorCount

protected int queryLogicalProcessorCount()

Description copied from class: MacOSProcess

Returns the number of logical processors via the backend-specific hw.logicalcpu sysctl.

Specified by:

queryLogicalProcessorCount in class MacOSProcess

Returns:

the logical processor count

getSoftOpenFileLimit

public long getSoftOpenFileLimit()

Description copied from interface: OSProcess

Gets the soft limit for open file handles (or network connections) of the given process.

Retrieving the soft limit for processes other than the calling process is only supported on Linux, FreeBsd and Solaris.

Returns:

the soft open file limit for the process if available. Returns -1 if the calling process is not the same as this OSProcess instance and the underlying operating system does not support retrieving the soft limit for other processes.

getHardOpenFileLimit

public long getHardOpenFileLimit()

Description copied from interface: OSProcess

Gets the hard limit for open file handles (or network connections) that belong to the given process.

Retrieving the hard limit for processes other than the calling process is only supported on Linux, FreeBsd and Solaris.

Returns:

the hard open file limit for the process if available. Returns -1 if the calling process is not the same as this OSProcess instance and the underlying operating system does not support retrieving the hard limit for other processes.

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.

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.